一、前置准备：开通沙箱环境 & 获取核心参数

1. 沙箱开通完整步骤

1. 进入拉卡拉分账系统办理平台：http://www.lakala-vip.com
2. 注册并实名认证：用企业 / 个体工商户资质完成实名认证，个人开发者也可临时注册测试（正式上线需企业资质）
3. 创建应用并开通沙箱：
   • 控制台 → 应用管理 → 创建应用，按需选择产品：
     ✅ 对接支付 / 退款：选「统一支付产品」
     ✅ 对接分账：选「钱账通分账产品」
     ✅ 对接提现 / 账户：选「商户账户产品」
   • 应用创建完成后，点击「沙箱管理」→ 申请开通沙箱权限，1 个工作日内自动审核通过（企业资质可即时开通）

2. 获取沙箱核心联调参数（开发必用）

二、沙箱环境通用配置 & 测试模拟参数

1. 通用签名规则（所有接口通用）

1. 所有请求参数按 ASCII 码从小到大排序，拼接成key1=value1&key2=value2格式的字符串
2. 用商户 RSA 私钥对字符串做 SHA256WithRSA 签名，签名值放入sign参数
3. 拉卡拉返回结果用平台公钥验签，确保数据未篡改

沙箱后台提供「在线签名工具」，可直接生成签名、验证参数，不用自己写逻辑，适合快速联调。

2. 沙箱专属模拟测试参数（无需真实银行卡 / 付款码）

三、核心场景沙箱联调全流程

1. 支付接口联调（条码 / JSAPI / 小程序支付）

测试步骤：

1. 请求接口：调用沙箱网关的统一收单接口 /v1/trade/pay，核心参数：
2. 验证返回：接口返回trade_status=SUCCESS即为支付成功，沙箱会自动生成交易流水号
3. 回调测试：沙箱后台→回调管理，可手动触发支付结果回调，验证你的回调接收逻辑
4. 订单查询：调用 /v1/trade/query 接口，输入订单号查询交易状态

2. 分账接口联调（拉卡拉钱账通）

前置配置：

测试步骤：

1. 支付完成后发起分账：调用 /v1/account/separate 分账接口，核心参数：
2. 验证结果：接口返回status=SUCCESS即为分账成功，可调用 /v1/account/separate/query 查询分账明细
3. 分账退款测试：分账完成后发起退款，沙箱会自动按分账比例回退各方金额，逻辑和生产完全一致

3. 退款接口联调（全额 / 部分退款）

测试步骤：

1. 发起退款：调用 /v1/trade/refund 接口，支持全额 / 部分退款：
2. 验证结果：接口返回refund_status=SUCCESS即为退款成功，沙箱会自动更新订单剩余可退金额
3. 退款回调：同样可在沙箱后台手动触发退款结果回调，验证你的回调逻辑

4. 提现接口联调（商户账户提现）

测试步骤：

1. 模拟账户余额：沙箱后台→账户管理，可手动充值虚拟余额，用于测试提现
2. 发起提现：调用 /v1/account/withdraw 接口：
3. 验证状态：沙箱会模拟银行处理流程，1 分钟内返回提现成功 / 失败，可调用 /v1/account/withdraw/query 查询提现状态

四、沙箱调试 & 常见问题排查

1. 官方调试工具（大幅提升联调效率）

1. 在线接口调试工具：沙箱后台→接口调试，可直接填写参数发请求，自动生成签名，查看完整请求 / 返回日志，不用写代码就能测接口
2. 日志查询：沙箱后台→交易日志，可查看所有接口的请求参数、签名值、返回结果，快速定位参数错误、签名错误
3. 回调测试工具：支持手动触发任意交易的回调，不用真实等待交易完成

2. 常见问题排查

1. 签名错误：检查参数是否按 ASCII 排序、编码是否为 UTF-8、私钥是否匹配、是否遗漏参数
2. 回调收不到：检查回调地址是否为公网可访问、是否在沙箱后台配置了白名单、是否拦截了 POST 请求
3. 分账失败：检查分账接收方是否已在沙箱配置、分账总金额是否等于订单金额、分账比例是否超过限制
4. 接口返回权限不足：检查应用是否开通了对应产品的沙箱权限，比如分账接口需要单独开通钱账通沙箱

五、生产环境切换注意事项

1. 沙箱联调全部通过后，在开放平台申请生产环境权限，替换生产的 app_id、商户号、网关地址（生产网关：https://api.lakala.com/api）
2. 生产环境密钥必须重新生成，不可使用沙箱密钥
3. 生产环境的分账接收方需要重新在生产后台配置，沙箱配置不会同步到生产