PayPal v2 REST API捕获支付失败：返回PAYER_ACTION_REQUIRED状态

核心问题出在支付流程的实现逻辑 #

你手动跳转payer-action链接的操作，违背了@paypal/react-paypal-js组件的设计初衷：

• 这个组件已经封装了PayPal支付的完整前端流程，包括拉起支付界面、处理用户授权、回调通知等。你自行跳转新标签页的操作，会导致PayPal前端会话与你的组件会话脱节——用户完成支付后，PayPal无法同步通知你的组件更新订单状态，等到你触发onApprove调用捕获接口时，订单实际仍处于需要用户操作的状态，因此返回PAYER_ACTION_REQUIRED。

正确的实现步骤 #

1. 修正createOrder回调逻辑
   这个回调只需要向后端请求创建订单，然后返回订单ID即可，无需处理payer-action链接。组件会自动拉起PayPal的支付界面（弹窗或内嵌），用户完成支付后会自动触发onApprove：

   const createOrder = async (data, actions) => {
     const response = await fetch('/api/order', { method: 'POST' });
     const order = await response.json();
     return order.id; // 仅返回订单ID，其余交给组件处理
   };
   

2. 修复后端/api/capture接口
   PayPal的/v2/checkout/orders/{id}/capture接口确实不需要请求体，你传入创建订单的请求体属于无效操作。如果后端请求时报“不传体就报错”，大概率是后端HTTP客户端的配置问题：

   • 确保请求方法为POST，且不设置请求体。如果框架强制要求传体，可以传空JSON对象{}，但绝对不能传创建订单的参数。
   • 检查请求头的Content-Type，传空对象时设为application/json；如果完全不传体，部分客户端可能需要设置Content-Length: 0。

3. 调试时先验证订单状态
   在调用capture前，先调用PayPal的/v2/checkout/orders/{id}接口查询订单状态，确认状态为APPROVED后再执行捕获。如果状态还是PAYER_ACTION_REQUIRED，说明支付流程确实未走完，回到第一步检查组件的使用是否符合规范。

为什么没得到预期的COMPLETED状态？ #

只有订单被成功捕获后，状态才会变为COMPLETED。你当前的流程中，用户虽完成支付，但会话脱节导致订单未被标记为APPROVED，此时调用capture自然会要求用户再次操作。按照组件的标准流程执行，用户完成支付后订单会自动变为APPROVED，捕获后就能得到COMPLETED状态。

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