拉卡拉分账系统API接口对接详细流程：前期准备→规则配置→支付集成→测试上线四步

---

一、前期准备（商务签约 + 资质开户 + 技术环境 + 密钥申请）

1.1 商务签约与资质材料（合规前提，避免二清）

• 必备资质：营业执照、法人身份证正反面、对公账户开户证明、ICP 备案（电商 / 小程序）、行业资质（医美 / 教育 / 跨境等）
• 签约：联系拉卡拉商务 / 官方服务商，签署《商户合作协议》+《分账服务补充协议》，明确分账权限、结算周期、费率、资金合规边界
• 提交审核：商户后台上传资质，完成企业实名；审核通过后开通主商户号（mch_id），并开通多级分账权限

1.2 开放平台账号与密钥申请（技术核心凭证）

1. 登录拉卡拉开放平台：完成开发者认证
2. 创建应用、获取核心参数：
   • 主商户号：mch_id
   • API 密钥：api_key（签名用）
   • RSA 公私钥：用于请求 / 响应验签、敏感数据加密
3. 申请沙箱测试账号 / 密钥（独立环境，不产生真实资金）

1.3 技术 & 服务器环境准备（你之前问过的要求）

• 服务器：公网固定 IP、开放 443/80 端口、支持 HTTPS（TLS1.2+）、可接收外网回调；Linux（CentOS/Ubuntu）优先
• 开发环境：Java (JDK1.8+)、PHP7.0+、Python3.6+，下载官方 SDK / 接口文档
• 回调地址准备：公网可访问的 HTTPS 接口地址（notify_url），用于接收支付 / 分账 / 退款异步结果；必须 5 秒内返回success，否则会重试

1.4 业务方案确认

---

二、规则配置（分账方白名单→规则创建→结算 / 回调配置）

2.1 分账接收方（子商户）入驻 & 白名单添加（必做）

• 方式一：商户后台→分账管理→添加分账接收方，提交个人 / 企业银行卡信息、实名材料
• 方式二：调用 API：子商户创建接口，提交接收方身份、银行卡、结算信息；返回唯一sub_merchant_id（分账方 ID），后续下单 / 分账都用这个 ID

2.2 创建分账规则（核心）

• 规则编号、规则名称、适用场景
• 分账明细列表：sub_merchant_id、分账金额 / 比例、分账描述、是否冻结
• 模式选择：
  • 实时分账：支付成功后立即分账
  • 延迟分账：支付成功后先冻结，满足条件（确认收货 / 到期）后解冻分账（常用电商 / 医美）
• 结算周期：D0/T+1/T+N

2.3 全局关键配置

1. 分账回调地址：配置到商户后台 / 应用参数，接收分账成功 / 失败 / 回退异步通知
2. 对账地址 / 周期：配置对账文件获取地址，用于每日对账
3. 风控阈值：单笔 / 单日分账限额、异常重试次数

---

三、支付集成（下单带分账参数→支付→分账触发→回调处理→退款回滚）

3.1 核心接口清单（必接）

1. 统一下单接口：/api/v3/pay/unifiedorder（关键：下单时携带分账参数，开启分账能力）
   • 必传分账字段：
     • is_divide=1（开启分账）
     • divide_rule_id（绑定已创建的分账规则 ID）
     • divide_detail（也可下单时直接传分账明细，不依赖预设规则）
2. 分账查询接口：查询某笔订单分账状态、明细
3. 分账回退接口：退款时按原路径逆向回滚资金（全额 / 部分），避免资金纠纷
4. 异步回调接收接口：支付结果、分账结果、退款结果通知

3.2 签名与安全机制（防篡改、防重放）

1. 按文档规范拼接参数字符串，用API 密钥做 MD5 签名、RSA 做加解密 / 验签
2. 回调处理：拉卡拉推送结果→你的服务验签→校验参数→业务处理→返回 HTTP 200+success；5 秒内未返回会重试（指数退避，最多 10 次）

3.3 完整调用流程（时序）

1. 商户系统生成唯一订单号，调用统一下单接口（带分账参数） →拉卡拉返回支付链接 / 二维码 / 支付参数
2. 用户完成支付（微信 / 支付宝 / 银联）→拉卡拉异步推送支付成功回调
3. 若is_divide=1：
   • 实时分账：支付成功后自动执行分账，资金拆分到各子商户账户
   • 延迟分账：资金先冻结，触发解冻条件后执行分账
4. 分账完成后，拉卡拉推送分账结果回调→你验签、更新订单 / 分账状态、落库
5. 退款场景：调用退款接口→先做分账回退（从各分账方收回对应金额）→再原路退款给用户

---

四、测试上线（沙箱全链路测试→问题修复→灰度发布→正式上线 & 运维）

4.1 沙箱环境完整测试（必须，不做不能上生产）

1. 切换到沙箱密钥 / 沙箱环境，不涉及真实资金
2. 测试用例覆盖：
   • ✅ 正常支付→成功分账→回调接收、验签、状态同步
   • ✅ 延迟分账：冻结→解冻→分账
   • ✅ 全额 / 部分退款→分账回退→资金原路返还
   • ✅ 异常场景：签名错误、回调超时重试、重复通知、分账失败重试、金额边界值
3. 验证：对账文件与本地订单一致、分账金额准确、无单边账

4.2 生产环境准备 & 切换

1. 把沙箱密钥替换为正式 mch_id、api_key、RSA 密钥
2. 服务器白名单：拉卡拉官方 IP 段加入防火墙白名单，放行回调请求
3. 本地环境检查：HTTPS 正常、回调地址可公网访问、数据库事务 / 幂等设计（防重复分账）

4.3 灰度上线（小流量→全量）

1. 先放少量真实订单（如 10-100 笔），监控：支付成功率、分账成功率、回调成功率、对账一致性、异常报错
2. 连续稳定运行 1-2 天无异常，再全量放量

4.4 上线后运维 & 对账

1. 每日拉取官方对账文件，和本地订单、分账明细核对，处理差异 / 差错订单
2. 监控告警：接口响应、成功率、异常、超时；配置告警机制
3. 权限 / 规则维护：子商户新增、规则变更、结算周期调整；留存日志≥5 年，满足合规

---

核心总结 & 避坑要点

1. 合规底线：平台不能碰资金、必须走持牌分账、先白名单再分账，规避二清风险
2. 技术关键：下单必带 is_divide、规则 ID / 明细、回调必须 HTTPS + 验签 + 5 秒内 success、幂等防重
3. 上线顺序：资质→白名单→规则→沙箱全链路→灰度→全量，不要跳步