如何通过PayPal /v2/checkout/orders PATCH接口更新custom_id或invoice_id？

当需要更新PayPal订单的custom_id或invoice_id这类字符串类型字段时，不需要将value包裹为对象，直接传入目标字符串即可。之前的错误在于误用了integration_artifact嵌套格式，这不符合该字段的API定义，导致验证失败。

正确的PATCH请求示例 #

更新custom_id #

curl -v -X PATCH https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer access_token' \
-d '[
  {
    "op": "replace",
    "path": "/purchase_units/@reference_id==\'PUHF\'/custom_id",
    "value": "YOUR_CUSTOM_ID"
  }
]'

更新invoice_id #

只需将path中的custom_id替换为invoice_id，并传入对应字符串值：

curl -v -X PATCH https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer access_token' \
-d '[
  {
    "op": "replace",
    "path": "/purchase_units/@reference_id==\'PUHF\'/invoice_id",
    "value": "YOUR_INVOICE_ID"
  }
]'

关键注意事项 #

• 使用replace操作：适用于更新已存在的字段；若字段原本不存在，也可使用add操作
• 替换占位符：将示例中的access_token、订单ID、reference_id以及目标字符串值替换为实际业务数据
• 字段格式合规：确保传入的字符串符合PayPal对custom_id和invoice_id的格式限制（如长度、允许字符等）

内容的提问来源于stack exchange，提问作者Timothy Radier