拉卡拉API支付接口沙箱环境免费吗？测试阶段要不要收费？

企业在接入拉卡拉API支付接口和分账系统前，通常需要在沙箱环境进行开发测试。沙箱环境是否免费？测试阶段会不会产生费用？沙箱和生产环境有什么区别？本文详细解答拉卡拉API沙箱环境的费用政策和使用规则。

 

拉卡拉API沙箱测试环境免费政策与使用指南

1. 一、沙箱环境是否免费

1.1 1.1 核心结论

拉卡拉API支付接口沙箱环境完全免费。企业在沙箱环境进行开发、联调、测试期间，不收取任何接口调用费、分账服务费、支付通道费或其他费用。

1.2 1.2 免费范围

项目	是否收费	说明
沙箱环境开通	免费	签约后自动分配沙箱账号
API接口调用	免费	不限调用次数（有频率限制）
模拟支付交易	免费	虚拟资金，不产生真实扣款
模拟分账	免费	测试分账规则和资金流向
回调通知测试	免费	测试异步通知接收
技术文档和SDK	免费	开放下载，Java/Python/Go
技术支持	免费	对接期间提供技术答疑

 

沙箱环境的所有交易均为模拟交易，使用虚拟资金，不会产生真实的资金流动和费用。企业可以放心进行充分测试，无需担心测试成本。

2. 二、沙箱环境开通方式

2.1 2.1 开通条件

• 已完成企业资质审核并签署服务协议

• 已获取商户号（merchant_id）

• 已分配API密钥（app_id和app_secret）

2.2 2.2 开通流程

1. 签署分账/支付服务协议后，拉卡拉开通商户号

2. 系统自动分配沙箱环境账号和密钥

3. 技术对接人登录商户管理后台，在"开发者中心"获取沙箱配置

4. 下载API文档和对应语言的SDK

5. 配置沙箱回调地址，开始联调测试

2.3 2.3 沙箱配置信息

配置项	说明
沙箱网关地址	测试环境专用API入口，与生产环境隔离
沙箱商户号	测试专用商户号，与生产商户号不同
沙箱API密钥	测试专用密钥，不可用于生产环境
测试支付账号	提供模拟微信/支付宝/银联测试账号
测试银行卡	提供模拟银行卡号用于测试

3. 三、沙箱环境功能范围

3.1 3.1 支持的接口

沙箱环境支持绝大部分生产环境的API接口，包括：

• 支付类接口：扫码支付、JSAPI支付、APP支付、H5支付、小程序支付、退款

• 分账类接口：分账接收方添加、分账请求、分账查询、分账回退

• 多级分账接口：一级分账、二级分账、三级分账

• 跨境分账接口：跨境分账请求、汇率查询、到账查询

• 账户类接口：账户余额查询、交易流水查询、对账单下载

• 回调通知：支付结果通知、分账结果通知、退款通知

3.2 3.2 沙箱限制

限制项	沙箱限制	生产环境
单笔交易金额	最高5万元	按商户额度
接口调用频率	60次/分钟	300次/分钟起
并发连接数	10个	100个起
分账接收方数量	最多10个/笔	最多20个/笔
真实资金流动	无（虚拟资金）	有
真实回调通知	模拟通知	真实通知

3.3 3.3 沙箱不支持的功能

• 真实的资金结算和提现

• 真实的银行卡扣款和入账

• 生产环境的风控规则（沙箱风控较宽松）

• 部分定制化接口（需单独开通测试）

• 高并发压力测试（建议用生产环境灰度）

4. 四、测试阶段费用说明

4.1 4.1 测试阶段完全免费

从沙箱环境开通到联调测试完成、上线前的整个测试阶段，拉卡拉不收取任何费用。包括：

• 开发阶段的接口调用

• 联调阶段的模拟交易

• 验收阶段的全流程测试

• 测试期间的技术支持

4.2 4.2 什么时候开始收费

只有切换到生产环境并产生真实交易后，才开始按约定费率收取费用：

阶段	环境	是否收费
开发测试	沙箱环境	免费
灰度上线	生产环境（小流量）	按真实交易量收费
正式运营	生产环境	按约定费率收费

 

灰度上线阶段即使交易量很小，也已在生产环境运行，会按真实交易产生费用。建议灰度前确保核心功能测试通过，控制灰度流量比例。

4.3 4.3 有没有接入费或年费

拉卡拉分账通和API支付接口标准产品不收取接入费、年费、系统维护费。仅按实际交易产生的支付通道费和分账服务费计费。部分深度定制化开发可能涉及项目费用，需单独评估。

5. 五、沙箱测试建议

5.1 5.1 测试用例覆盖

建议在沙箱环境覆盖以下测试场景：

• 正常流程：支付成功→分账成功→各接收方到账→提现成功

• 异常流程：支付失败、分账失败、部分分账、分账回退

• 退款流程：全额退款、部分退款、退款后分账回退

• 回调测试：回调成功、回调失败重试、回调超时

• 并发测试：多笔交易同时分账（在沙箱频率限制内）

• 边界测试：最小金额、最大金额、零金额、超长备注

• 多级分账：A→B→C三级分账全流程

• 跨境分账：不同币种、不同国家的分账测试

5.2 5.2 测试数据准备

• 准备多个测试分账接收方（企业、个体、个人各类型）

• 准备不同金额的测试订单（小额、中额、大额）

• 配置测试回调地址，确保能接收异步通知

• 准备测试用的模拟支付账号和银行卡

5.3 5.3 测试周期建议

阶段	建议时长	主要工作
接口开发	3-5天	基于SDK开发核心接口
联调测试	3-7天	全流程联调，覆盖正常和异常场景
验收测试	2-3天	业务方验收，确认功能和数据正确
灰度上线	3-7天	小流量生产验证，监控稳定性

6. 六、沙箱切换生产环境

6.1 6.1 切换条件

• 沙箱环境所有核心功能测试通过

• 回调通知接收稳定，无丢失或异常

• 业务方完成验收确认

• 生产环境商户号和密钥已分配

• 生产回调地址已配置并验证

6.2 6.2 切换步骤

1. 在管理后台申请生产环境开通

2. 获取生产环境的网关地址、商户号、API密钥

3. 将系统配置从沙箱切换到生产环境

4. 配置生产环境回调地址并验证

5. 进行生产环境小额真实交易验证

6. 验证通过后逐步放量上线

6.3 6.3 切换注意事项

• 沙箱和生产环境的商户号、密钥完全不同，不可混用

• 切换后沙箱环境的测试数据不会同步到生产环境

• 生产环境的风控规则更严格，需确保交易真实合规

• 建议先灰度小流量，观察1-3天后再全量上线

• 上线后保留沙箱环境，便于后续功能迭代测试

7. 七、常见问题

7.1 Q1：沙箱环境可以用多久？有时间限制吗？

沙箱环境没有时间限制，只要商户号有效，沙箱环境一直可用。建议长期保留沙箱环境，用于后续功能迭代和新版本测试。

7.2 Q2：沙箱环境的测试交易会出现在对账单里吗？

不会。沙箱环境的交易数据与生产环境完全隔离，不会出现在生产对账单中，也不影响财务核算。沙箱环境可单独下载测试对账单。

7.3 Q3：测试期间可以申请提高沙箱频率限制吗？

可以。如有较高的并发测试需求，可联系技术支持申请临时提高沙箱频率限制。但高并发压测建议在生产环境灰度阶段进行。

7.4 Q4：沙箱环境支持跨境分账测试吗？

支持。沙箱环境提供跨境分账的模拟测试，包括多币种汇率查询、跨境分账请求、到账状态模拟等。但不会产生真实的外汇兑换和国际汇款。

7.5 Q5：如果测试不通过，可以延长测试期吗？

可以。沙箱环境不设截止时间，企业可根据开发进度自由安排测试周期。技术支持团队会持续协助解决对接问题，直到测试通过上线。

8. 八、总结

拉卡拉API支付接口和分账通的沙箱环境完全免费，测试阶段不收取任何费用。沙箱环境支持支付、分账、多级分账、跨境分账等绝大部分接口，提供模拟资金和测试账号，企业可放心进行充分的开发和联调测试。只有切换到生产环境产生真实交易后，才按约定费率收费。标准产品不收取接入费和年费。建议在沙箱环境覆盖正常、异常、退款、回调、多级分账、跨境分账等全场景测试，验证通过后再灰度上线。沙箱环境长期有效，可保留用于后续迭代测试。