YouCanPay Tokenize API集成异常：沙箱密钥误用生产环境报错

问题场景 #

我在测试YouCanPay Tokenize API时，已完成以下操作：

• 使用沙箱私钥发起请求
• 传入文档要求的所有参数
• 在YouCanPay账户中开启了沙箱模式

但调用API后收到错误响应：

{
    "success": false,
    "message": "Sandbox key used on live mode"
}

预期的成功响应应为：

{
    "transaction_id": "840f1c8a-6554-45d5-a1ad-f8a48f928dcf",
    "token": "cp500014337"
}

排查与解决方法 #

• 确认API请求地址：检查请求的URL是否为沙箱环境专属地址，避免误调用生产环境API（部分平台沙箱地址会包含sandbox前缀）。
• 核对沙箱私钥：登录沙箱管理后台，确认使用的私钥是沙箱环境生成的，而非生产密钥，复制时注意不要混淆两类密钥。
• 检查环境标识参数/请求头：有些API需要在请求中明确指定环境（如添加mode=sandbox参数或对应请求头），确保请求携带了沙箱模式的标识。
• 重置沙箱密钥：若以上都没问题，尝试在后台重新生成沙箱私钥，替换原有密钥后重新测试，排除密钥关联错误的可能。

内容的提问来源于stack exchange，提问作者Syed Zohaib Haider