WooCommerce集成PayPal快速结账时服务端获取EC Token问题

核心问题说明 #

你之前参考的新版标准结账集成文档对应的是当前主流的JS SDK集成流程，默认返回的是订单ID格式标识，不会直接返回EC-xxxx格式的Token。EC-xxxx是经典Express Checkout NVP/SOAP接口的标准返回格式，新版接口仅在兼容跳转模式下会返回该格式串，这是你之前拉取失败的核心原因。

标准集成步骤 #

• 安装官方最新版WooCommerce PayPal Payments插件，弃用老旧的legacy版PayPal Express Checkout插件，旧版插件对接的已下线类接口本身就无法稳定返回Token
• 在插件设置页完成API凭证配置：填入对应环境（沙箱/生产）的Client ID、Client Secret，确认插件后台显示PayPal连接状态为已授权，不要混用沙箱和生产环境的凭证
• 开启Express Checkout快捷结账按钮开关，选择你要展示按钮的位置（商品页、购物车页、结算页），保存设置后先在沙箱环境测试一笔正常支付，确认基础支付流程跑通

服务端获取EC-xxxx格式Token的实现逻辑 #

所有Token拉取请求必须在WooCommerce服务端发起，绝对不能在前端代码里暴露Client Secret等敏感凭证：

• 先通过PayPal OAuth2接口获取有效access_token，请求时在Header里添加Authorization: Basic {base64编码后的ClientID:ClientSecret}
• 拿到有效access_token后，向订单创建接口发起POST请求，Header携带Authorization: Bearer {access_token}、Content-Type: application/json
• 请求体传入必填参数：支付金额、收款币种、return_url（用户授权后回跳地址）、cancel_url（用户取消支付回跳地址）、支付方式固定指定为paypal
• 接口返回结果后，找到返回links节点中rel为approve的跳转链接，链接query参数里的token字段值就是你要的EC-xxxx格式串，直接提取即可，不需要额外调用经典接口

常见拉取失败排查 #

• 检查你账号的API权限是否开通Express Checkout相关能力，新注册的PayPal商户号默认可能没有开通经典接口兼容权限，需要在商户后台手动开启
• 临时关闭站点的WAF、缓存类插件，这类插件经常会拦截WooCommerce向PayPal发起的出站请求，导致请求超时或参数被篡改
• 确认请求传入的币种在你商户号的支持收款范围内，不支持的币种会直接触发接口报错
• 检查请求头是否携带了正确的格式标识，未携带WooCommerce合作标识的请求可能会被PayPal风控拦截

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