拉卡拉API支付接口测试环境和正式环境区别？沙箱到上线流程

一、两个环境核心区别一览

关键提醒：AppId、证书、密钥三者一一对应，测试环境的配置不能用到生产环境，反之亦然。混用会导致签名验证失败。拉卡拉开放平台

二、沙箱到上线完整流程（6 步）

第 1 步：申请开通测试环境

1. 商务签约通过后，联系你的对接客户经理
2. 拉卡拉提供测试环境参数包：
   • 测试 AppId（如 OP00000003）
   • 测试证书文件（api_cert.cer + 私钥 + 拉卡拉公钥 lkl-apigw-v2.cer）
   • 测试商户号
   • SM4 国密密钥（如需密文传输）
3. 下载对应语言 SDK（Java/PHP/.NET）和 Demo 项目

第 2 步：开发联调（测试环境）

在测试环境中完成全流程开发：

测试环境支持模拟支付成功 / 失败等各种场景，不需要真实付款。拉卡拉

第 3 步：提交联机测试报告

测试全部通过后，填写拉卡拉提供的《联机测试报告模板》，包含：

• 每个接口的调用截图 / 日志
• 测试场景覆盖清单
• 测试结论

提交给你的对接人，由拉卡拉内部审核。i.lakala.com

第 4 步：申请生产环境参数

审核通过后，拉卡拉提供生产环境参数：

• 正式 AppId
• 正式商户号
• 生产环境 API 域名
• 生产环境公钥证书（lkl-apigw-v1.cer）

注意：生产环境的应用证书需要你自己在合作伙伴工作台生成并上传，不是拉卡拉提供。拉卡拉开放平台

第 5 步：生产环境验证（关键，不能跳过）

1. 在你的系统配置中，把以下参数从测试环境替换为生产环境：
   • API 域名：test.wsmsd.cn/sit → s2.lakala.com
   • AppId：测试 AppId → 正式 AppId
   • 证书：测试证书对 → 生产证书对
   • 商户号：测试商户号 → 正式商户号
2. 先跑小额真实交易验证（建议 1 元以内）：
   • 确认支付能正常发起
   • 确认回调能正常接收
   • 确认资金到账正确
   • 确认分账金额准确（如有）
3. 验证退款流程（小额退款测试）

第 6 步：正式上线

1. 生产环境小额验证通过后，联系对接人确认上线
2. 切换系统状态为正式运行
3. 上线初期密切监控：分账成功率、回调延迟、交易异常率
4. 接入对账接口，实现每日自动对账

三、环境切换时必改的配置清单

┌─────────────────────────────────────────┐
│         从测试切生产，逐项核对            │
├─────────────────────────────────────────┤
│  1. API域名：test.wsmsd.cn → s2.lakala.com │
│  2. AppId：OP00000003 → 正式分配的AppId    │
│  3. 商户号：测试号 → 正式商户号            │
│  4. 应用证书：测试cer → 生产cer           │
│  5. 拉卡拉公钥：v2 → v1                  │
│  6. SM4密钥：测试密钥 → 生产密钥           │
│  7. 回调地址：mock地址 → 正式公网URL       │
│  8. 日志级别：DEBUG → INFO/WARN          │
└─────────────────────────────────────────┘ 

四、常见踩坑提醒

1. 证书混用：最常见的问题。测试证书上传到生产环境，或反过来，直接签名失败。
2. 回调地址没改：测试时用的 mock 地址，切生产忘了换成正式 URL，导致回调收不到。
3. 金额单位搞错：测试环境和生产环境的金额单位必须一致（一般是分还是元，确认文档）。
4. 忘了验签：生产环境回调必须严格验签，防止伪造请求。
5. 直接上大额：切生产后第一笔一定要小额验证，确认没问题再放大。

五、整体时间预估