PayPal集成提示merchant canceled transaction资金未到账问题

你踩了PayPal v2 Checkout集成最常见的新手坑：把用户跳转到success_url当成支付成功的判定标准，完全漏掉了支付后主动捕获资金的必选步骤。你看到的"merchant canceled transaction"自动退款、无实际扣款都是这个问题直接导致的。
PayPal的Checkout流程里，success_url只是用户走完PayPal页面操作后的前端跳转地址，完全不代表支付生效——用户点完支付按钮，PayPal只是临时冻结了对应卡的额度，只要你作为商户没有主动调用接口确认要这笔钱，PayPal超时后就会自动判定是商户取消交易，把冻结的钱原路退回，根本不会结算到商户账户。

你现有流程的缺失项 #

你目前只完成了一半流程：

• 已完成：获取token、创建订单、跳转用户到PayPal
• 缺失：用户跳转回站点后的订单状态校验、资金捕获操作、服务端可信的支付结果通知处理

具体排查修复步骤 #

• 先查你创建/v2/checkout/orders时传的intent参数
  • 如果传的是CAPTURE（即时到账场景用的最多的参数）：用户跳回success_url时，先从url的query参数里取token字段，这就是对应的订单ID。首先调用GET /v2/checkout/orders/{order_id}查订单状态，只有状态返回APPROVED时，立刻调用POST /v2/checkout/orders/{order_id}/capture接口发起资金捕获，接口返回成功、订单状态变为COMPLETED，才代表这笔钱真正扣划成功、会结算到商户账户。
  • 如果传的是AUTHORIZE（先授权后扣款场景）：同样在订单状态为APPROVED时先调用授权接口，后续在你需要结算的时间点再调用捕获接口，注意授权有有效期，超时未捕获会自动失效。
• 立刻废弃前端跳转作为支付成功依据，配置Webhook做服务端状态校验
  生产环境不要信任何前端触发的回调，必须在PayPal商户后台配置Webhook，监听PAYMENT.CAPTURE.COMPLETED事件，只有收到这个事件推送，才给用户发支付成功的权益、做订单状态更新。用户完全可能付完钱直接关页面不跳回success_url，也可能跳转时网络中断，仅靠前端跳转判定会漏单、错单。
  你现在可以直接登录PayPal商户后台查对应测试交易的状态，所有自动退款的订单肯定都停在APPROVED状态，从来没有收到过你发起的capture请求，所以才会标记为商户取消。
• 排查生产环境配置问题
  • 确认所有接口调用的都是生产环境域名，不要出现生产密钥调沙箱、沙箱密钥调生产的低级错误
  • 确认你用的live client_id对应的商户号已经完成了PayPal要求的商户资质审核、账户没有被限制收款，未完成验证的账户无法正常接收资金结算
• 修复后验证
  改完流程先做小金额真实支付测试，确认capture接口返回成功、Webhook能收到对应的完成事件、商户后台交易状态显示已完成，再核对资金到账情况，正常完成捕获的交易不会再出现自动退回的问题。

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