PayPal REST API：付款捕获响应缺失汇率及转换金额

问题背景 #

我们拥有一个使用欧元（EUR）的PayPal沙箱店铺账户，已配置为按店铺货币转换付款。当使用美元（USD）完成购买后，调用v2/payments/captures/接口获取付款捕获详情时，预期返回的汇率及转换后金额相关字段缺失。

实际API响应（核心片段） #

{
  "id":"63F99991HX835842N",
  "amount":{"currency_code":"USD","value":"600.00"},
  "seller_receivable_breakdown":{
    "gross_amount":{"currency_code":"USD","value":"600.00"},
    "paypal_fee":{"currency_code":"USD","value":"23.70"},
    "net_amount":{"currency_code":"USD","value":"576.30"}
  }
}

预期应包含的缺失字段 #

"seller_receivable_breakdown": {
  // 已有字段省略
  "receivable_amount": {
    "currency_code": "EUR",
    "value": "XXX.XX"
  },
  "paypal_fee_in_receivable_currency": {
    "currency_code": "EUR",
    "value": "XXX.XX"
  },
  "exchange_rate": {
    "source_currency": "USD",
    "target_currency": "EUR",
    "value": "XXX.XXXXXX"
  }
}

可能的原因及解决方案 #

1. API请求未指定完整字段参数 #

PayPal v2 API默认返回精简响应，需在请求URL中添加?fields=*参数以获取所有扩展字段，包括汇率和转换金额信息。

修正后的请求URL示例：

https://api-m.sandbox.paypal.com/v2/payments/captures/63F99991HX835842N?fields=*

2. 店铺货币转换配置未正确生效 #

登录PayPal沙箱卖家账户，检查以下配置：

• 进入「设置」>「付款」>「付款接收」>「币种接受选项」
• 确认选择的是**「将收到的款项转换为我的店铺币种（EUR）」**，而非「保留原币种」。若设置为保留原币种，PayPal不会执行货币转换，因此不会返回相关字段。

3. 沙箱测试场景未触发转换逻辑 #

部分沙箱测试交易可能因测试账户配置问题未触发货币转换，可尝试：

• 使用不同地区、不同币种的测试买家账户发起付款
• 调整测试交易金额至非极小值（避免测试流程跳过转换步骤）

4. API版本或端点错误 #

• 确认使用的是PayPal v2 API的最新稳定版本，旧版本可能不支持返回这些扩展字段
• 验证调用的端点是否正确：v2/payments/captures/{capture_id}是获取捕获详情的正确端点，避免调用错误接口

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