react-paypal-button-v2返回错误订单ID导致PayPal退款报错咨询

问题根源 #

你当前存储的data.orderID是PayPal结账流程的订单资源ID，而退款接口要求传入的是资金捕获ID（也就是你在响应报文中看到的captures数组下的ID），二者属于完全不同的资源类型，所以调用退款接口时会返回INVALID_RESOURCE_ID错误。

解决方案 #

有两种常用的方式可以获取到退款需要的捕获ID：

• 方案1：前端捕获完成后直接提取（开发成本最低）
  actions.order.capture()本身是返回Promise的异步方法，执行后会返回完整的订单捕获结果，你可以直接从返回结果中提取捕获ID，修改后的代码示例如下：

const onApprove = async (data, actions) => {
    // 执行订单捕获，获取捕获完成的全量响应
    const capturedOrder = await actions.order.capture();
    // 提取捕获ID，单个购买单元的场景直接取第一个元素即可
    const captureId = capturedOrder.purchase_units[0].payments.captures[0].id;
    // 建议同时存储订单ID和捕获ID，方便后续对账和查单
    dispatch(saveCheckout({
        orderId: data.orderID,
        captureId: captureId
    }));
}

<PayPalButton
   amount={totalPrice}
   currency="AUD"
   createOrder={(data, actions) => createOrder(data, actions)}
   onApprove={(data, actions) => onApprove(data, actions)}
   options={{ 
      clientId: "<placeholder>",
      currency: "AUD"
   }}
/>

• 方案2：后端调用接口查询（安全性更高）
  如果你担心前端数据被篡改，可以用已经存储的订单ID，在后端调用PayPal订单查询接口获取完整的订单信息，从返回结果中提取捕获ID存储即可，这种方式更适合交易安全要求较高的业务场景。

注意事项 #

• 如果你的业务支持拆分捕获，captures数组可能存在多个捕获记录，建议存储所有捕获ID，退款时对应相应的捕获记录发起请求即可。
• 建议同时存储订单ID和捕获ID，后续的订单查询、对账校验等操作都可以通过订单ID快速关联。

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