拉卡拉分账系统对接电商平台技术教程：资质准备→分账配置→接口调用→沙箱测试全流程
下面给你一套电商平台专用、可直接落地的拉卡拉分账系统对接技术教程，严格按 资质准备 → 分账配置 → 接口调用 → 沙箱测试 四步走，覆盖合规边界、后台配置、核心 API、签名 / 回调、异常与退款、测试用例全流程。
一、资质准备（合规先行，杜绝二清）
电商平台做分账，核心底线：平台不碰资金、资金由拉卡拉持牌清分、所有分账方先实名白名单。
1.1 必备资质清单（平台主商户）
- 营业执照（有效期内）、法人身份证正反面、对公账户开户证明 / 开户许可证
- ICP 备案证明（电商 / 小程序 / 网站必须）、域名证书、平台合作协议（与入驻商户）
- 特殊行业：如医美、教育、跨境，额外提供行业资质许可
1.2 商务签约与权限开通
- 联系拉卡拉官方 / 服务商，签署《商户合作协议》+《分账服务补充协议》
- 商户后台上传资质→审核（1-2 工作日）→开通主商户号 mch_id、多级分账权限
-
登录拉卡拉开放平台，完成企业开发者认证，创建应用，获取：
- 正式 / 沙箱商户号 (mch_id)、API 密钥 (api_key)、RSA 公钥 / 私钥（签名、验签、加密用）
1.3 技术服务器环境准备
- 公网固定 IP、HTTPS（TLS1.2+）、443/80 端口开放、可接收外网回调
- 服务器：Linux（CentOS/Ubuntu）优先；Java/JDK1.8+、PHP7.0+、Python3.6 + 均可
-
准备公网可访问的回调地址（notify_url），用于接收支付 / 分账 / 退款异步结果；必须 5 秒内返回
success，否则会重试
1.4 核心合规要点
- 资金路径：用户→拉卡拉备付金 / 监管户→按分账规则直拆到子商户账户，平台全程不触资金，不设资金池，规避二清
- 所有分账接收方（入驻商户 / 分销商）必须实名、四要素验证、加入白名单，才能分账
二、分账配置（白名单→规则→回调，电商核心）
2.1 分账接收方（子商户）入驻 & 白名单添加（必做）
电商每个入驻商户 / 分销商都要先成为子商户、进白名单，两种方式：
- 后台可视化：商户后台→分账管理→分账接收方管理→新增，提交企业 / 个人证件、银行卡，审核通过后获得唯一sub_merchant_id（子商户 ID）
- API 方式：调用子商户创建接口，批量 / 单个上送实名信息、结算账户，审核后返回 sub_merchant_id
- 支持：对公账户、个人银行卡；需签署结算授权书、合作协议
2.2 创建分账规则（电商常用：实时 / 延迟冻结）
电商主流两种模式：
- ✅ 实时分账：支付成功立即拆分（适合虚拟商品、即时履约）
- ✅ 延迟分账（冻结 + 解冻）：支付后先冻结资金，用户确认收货 / 到期后解冻分账（电商实物交易最常用，防退款纠纷）
规则配置方式（二选一）：
-
后台配置：分账管理→分账规则→新建，填写：
- 规则 ID、名称、适用场景
- 分账明细：sub_merchant_id、分账金额 / 比例、描述、是否冻结
- 结算周期：D0/T+1/T+N
- API 创建：调用分账规则创建接口，生成 rule_id，下单时绑定此 ID
示例（电商 100 元订单：平台 10%、商户 90%、冻结至确认收货）：
- 规则明细 1：sub_merchant_id=A，amount=10（10%）
- 规则明细 2：sub_merchant_id=B，amount=90（90%）
- 模式：延迟冻结分账
2.3 回调与对账配置
- 配置支付结果回调 notify_url、分账结果回调 divide_notify_url（均 HTTPS、公网可访问）
- 配置对账地址、对账周期（每日自动获取对账文件）
三、接口调用（电商核心链路：下单→支付→分账→回调→退款回退）
3.1 核心接口清单（电商必接）
基础地址：正式 / 沙箱地址以开放平台文档为准；核心接口：
-
统一下单：
/api/v3/pay/unifiedorder（关键：下单带分账参数，开启分账） - 分账查询：查询订单分账状态、明细
- 分账回退：退款时逆向回滚资金（电商退货必用）
- 子商户管理：新增 / 查询 / 修改子商户
- 异步回调接收：支付、分账、退款结果通知
3.2 统一下单（带分账参数，电商核心）
必传分账字段（is_divide=1 开启）
- 签名：按文档拼接参数，用 api_key 做 MD5 签名、RSA 验签；所有请求必须 HTTPS、防重放、防篡改
3.3 完整时序（电商下单→支付→分账）
- 电商系统生成唯一订单号，调用统一下单（带分账参数）→拉卡拉返回支付二维码 / 链接 / 参数
- 用户支付成功→拉卡拉推送支付成功回调→验签、更新订单状态
- 实时分账：支付成功→自动执行分账→资金拆分到各子商户账户→推送分账结果回调
- 延迟分账：支付成功→资金冻结→用户确认收货→调用解冻 / 自动到期→执行分账→回调通知
- 退款 / 退货：调用退款接口→先分账回退（从各子商户收回对应金额）→原路退款给用户
3.4 回调处理规范（最容易踩坑）
- 收到回调→先验签、校验参数、防重放（用 out_trade_no 做幂等）
- 业务处理→5 秒内返回 HTTP 200 + 字符串 success；超时会指数重试（最多 10 次）
- 重复通知：用订单号幂等，避免重复分账 / 重复更新状态
四、沙箱测试（全链路验证，不做不能上生产）
4.1 切换沙箱环境
- 开放平台获取沙箱 mch_id、沙箱 api_key、沙箱 RSA 密钥、沙箱接口地址（无真实资金）
- 服务器放行拉卡拉沙箱 IP 白名单
4.2 电商必测用例（全覆盖）
- ✅ 正常支付→实时分账→回调接收、验签、状态落库、金额正确
- ✅ 延迟冻结分账：支付冻结→模拟确认收货→解冻分账→核对资金
- ✅ 全额退款→分账全额回退→原路退款、资金归零
- ✅ 部分退款→部分回退→剩余资金正确
- ✅ 异常场景：签名错误、回调超时重试、重复通知、金额边界、子商户无效、分账失败重试
4.3 对账验证
拉取沙箱对账文件，与本地订单、分账明细比对，确保无单边账、金额一致、状态同步
4.4 生产上线切换
- 沙箱测试全部通过→替换为正式 mch_id、api_key、RSA 密钥、正式接口地址
- 生产服务器白名单放行拉卡拉正式 IP 段、HTTPS 可用、回调地址公网可达
- 灰度上线：先放小流量（几十笔）→监控成功率、回调、对账→稳定后全量
电商对接避坑清单（必看）
- 合规红线：平台绝对不能碰资金、不能私设资金池、子商户必须实名白名单，否则认定二清
- 幂等设计：所有接口、回调、退款，必须用订单号做幂等，防止重复分账 / 重复退款
- 延迟分账优先：电商实物交易用冻结 + 确认收货解冻，规避退款纠纷
- 回调必须 5 秒内返回 success，否则反复重试、导致异常
