CyberSource沙箱/pts/v2/payments API返回SYSTEM_ERROR技术问询

问题背景 #

我在沙箱环境测试CyberSource REST Payments API，请求详情：

• 请求方式及地址：POST https://apitest.cybersource.com/pts/v2/payments
• 认证方式：HTTP Signature，使用Merchant ID、Key ID、REST共享密钥

问题现象 #

API持续返回如下系统错误：

{
  "status": "SERVER_ERROR",
  "reason": "SYSTEM_ERROR",
  "message": "Error - General system failure."
}

已执行的排查操作 #

• 创建多个沙箱商户账户并生成REST共享密钥
• 验证Merchant ID、Key ID、Shared Secret的正确性
• 使用CyberSource官方Java示例项目测试
• 通过CyberSource API控制台直接测试

核心疑问 #

新创建的沙箱商户使用/pts/v2/payments API是否需要额外配置？

解决方案与说明 #

1. 检查沙箱账户服务启用状态
   新创建的CyberSource沙箱商户默认不会自动激活所有支付服务，需登录沙箱商户管理后台，确认Payment Services (PTS) 相关服务已启用：

   • 核实商户账户已开通信用卡支付、网关服务等基础支付能力
   • 确认/pts/v2/payments对应的支付产品（如授权、捕获等）已激活

2. 确认密钥权限范围
   即便密钥信息正确，也要检查生成的REST共享密钥是否拥有PTS Payments相关操作权限。部分沙箱密钥默认仅开放基础查询权限，需在密钥管理页面调整权限，确保包含支付发起类权限。

3. 等待沙箱账户初始化完成
   部分新创建的沙箱商户存在初始化延迟，建议等待15-30分钟后再重试测试，避免因账户未完全初始化引发系统错误。

4. 排查请求参数合规性
   系统错误有时源于请求参数不符合沙箱规则：

   • 确认使用的测试卡号在沙箱白名单内
   • 检查金额、货币代码格式是否符合要求（货币代码需为3位ISO标准）
   • 确保请求包含必填元数据字段（如clientReferenceInformation）

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