PayPal沙箱交易未显示在交易列表问题求助

• 确认API端点与参数准确性

  • 必须调用沙箱环境的交易查询端点：https://api-m.sandbox.paypal.com/v1/reporting/transactions，切勿使用生产环境地址
  • 核对start_date和end_date的时间范围，必须覆盖交易发生的UTC时间，格式严格遵循YYYY-MM-DDTHH:MM:SSZ
  • 确保请求中指定的merchant_id是关联商家账户的ID，而非个人沙箱账户ID

• 验证API权限与认证信息

  • 检查调用API的客户端ID和秘钥属于沙箱环境，且已开通transaction_search或reporting_read权限
  • 若使用OAuth令牌，可调用https://api-m.sandbox.paypal.com/v1/oauth2/token/info验证令牌是否包含交易查询相关权限范围

• 考虑沙箱数据同步延迟

  • 沙箱环境的交易数据同步存在5-15分钟的延迟，新捕获的交易不会立即出现在API查询结果中，等待一段时间后重试即可
  • 登录沙箱商家后台手动确认交易是否存在，若后台可见但API查不到，基本可判定为同步延迟问题

• 检查订单捕获状态与类型

  • 确认订单捕获接口返回的状态为COMPLETED，若状态为PENDING（如需要人工审核的测试场景），交易不会被纳入查询列表
  • 排查捕获金额是否为0或特殊测试金额，部分极端测试交易可能不会被API返回

• 排查Postman请求配置

  • 确保请求头包含Content-Type: application/json，且Authorization头格式为Bearer <获取到的令牌>
  • 检查请求参数的拼写，PayPal API对参数大小写敏感，比如start_date不能写成startDate

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