拉卡拉API支付接口的沙箱环境怎么用？完整测试流程怎么走？

拉卡拉API支付接口沙箱环境是官方提供的100%模拟生产逻辑的隔离测试空间‌，所有接口规则、签名方式、业务流程和生产环境完全对齐，仅资金为虚拟流转，不会产生真实扣款和交易成本，技术团队可以放心把全场景逻辑跑通后再上线生产环境。

第一步：开通沙箱并获取核心联调参数

1. 进入拉卡拉开放平台完成实名认证，企业/个体工商户资质可即时开通，个人开发者1个工作日内自动审核通过。
2. 控制台→应用管理→创建应用，按需选择对应产品：统一支付产品、钱账通分账产品、商户账户产品。
3. 进入「沙箱管理」页面提交开通申请，审核通过后获取全套沙箱专属参数，与生产环境完全隔离，避免参数混用。
4. 在沙箱后台在线生成RSA密钥对，获取沙箱网关地址、app_id、822开头15位测试商户号，用于后续接口调用。

第二步：通用配置与模拟测试参数

1. 所有接口统一使用RSA2(SHA256WithRSA)签名规则，沙箱后台自带在线签名工具，无需从零编写签名逻辑。
2. 内置虚拟测试银行卡：储蓄卡、信用卡，余额无限，任意密码即可模拟支付成功。
3. 扫码支付直接填模拟授权码test_auth_code_001，即可模拟微信、支付宝付款成功。
4. 按金额精准控制返回结果：≤10000元自动支付成功，10001元模拟支付失败，10002元模拟支付超时，覆盖所有异常分支场景。

第三步：核心场景全流程联调测试

1. ‌支付接口测试‌：调用沙箱网关统一收单接口/v1/trade/pay，验证返回trade_status=SUCCESS即为支付成功，沙箱自动生成交易流水号。
2. ‌回调逻辑验证‌：沙箱后台→回调管理，手动触发支付结果回调，无需等待系统自动推送，直接验证你的回调接收逻辑是否正常。
3. ‌分账接口测试‌：先在沙箱后台分账管理页面添加虚拟分账接收方，支付完成后调用/v1/account/separate接口发起分账，验证分账明细是否符合预设规则。
4. ‌退款接口测试‌：调用/v1/trade/refund接口，支持全额/部分退款，验证退款后订单剩余可退金额自动更新，同时测试退款回调逻辑。
5. ‌提现接口测试‌：沙箱后台账户管理页面手动充值虚拟余额，调用/v1/account/withdraw接口发起提现，1分钟内即可模拟银行处理流程返回结果。

第四步：沙箱调试完成后上线生产环境

1. 把支付、分账、退款、提现全流程所有分支场景在沙箱内全部跑通，确认接口调用、异常处理、对账逻辑零差错。
2. 提交上线申请，官方技术团队完成合规校验后当天即可开通生产环境权限。
3. 直接复用沙箱调试好的代码，仅替换网关地址、app_id、商户号和生产密钥，无需二次开发即可正式上线。