PayPal V2更新订单时能否修改purchase unit下的订单商品条目？

核心结论 #

PayPal v2 订单接口支持修改purchase unit下的订单商品列表，仅需满足订单处于CREATED状态（买家尚未完成支付授权/批准操作）的前提。

正确PATCH路径 #

修改商品列表的路径为：
/purchase_units/@reference_id=='default'/items

注：如果你的订单purchase_unit设置了非default的自定义reference_id，需将路径中的default替换为实际使用的reference_id值。

完整操作规范 #

为避免金额不匹配报错，需同时提交商品列表和订单金额的修改请求，单个PATCH请求可包含两个修改操作：

• 操作1：替换商品列表
  • op参数值：replace
  • path参数值：/purchase_units/@reference_id=='default'/items
  • value参数值：更新后的完整商品数组，需包含每个商品的名称、单价、数量等必填字段
• 操作2：替换订单金额
  • op参数值：replace
  • path参数值：/purchase_units/@reference_id=='default'/amount
  • value参数值：更新后的金额对象，需确保value字段值等于所有商品unit_amount × quantity的总和，同时breakdown.item_total的取值和商品总金额完全一致

不支持修改的场景 #

若订单状态已变更为APPROVED（买家已完成支付授权）、COMPLETED（已完成支付捕获），则无法执行PATCH修改操作，此时需先作废原有订单，再根据最新的购物车信息创建新的PayPal订单。

内容的提问来源于stack exchange，提问作者Borgy Manotoy