拉卡拉API支付接口完整对接流程（注册→企业认证→下载文档→沙箱测试→生产上线）
包含通用聚合支付 API + 钱账通分账 API两套标准流程，官方开放平台 open.lakala.com 统一管理，持央行牌照 Z2002511000017，资金央行备付金托管，合规空中分账。
一、前期资质准备（企业主体必备，个人小微无法开通 API）
1. 基础材料
- 营业执照（经营范围含电商 / 零售 / 互联网销售，加盖公章）
- 法人二代身份证正反面
- 对公基本存款账户信息（基本存款账户回执 / 开户许可证）
- 法人实名手机号
- 门店 / 线上经营场景截图
2. 平台型企业额外补充（商城 / 团购 / MCN / 连锁）
- 网站 / 小程序 ICP 备案证明（备案主体与执照一致）
- 入驻商户合作协议模板
- 特殊行业：食品经营许可证、办学许可证、医美资质等
3. 分账 API 专属材料（钱账通）
加盖公章《分账结算授权书》、分账合作方清单、多级分润规则说明文件。
二、第一步：开放平台注册与企业实名认证（1–3 个工作日）
-
访问拉卡拉开放平台官网：
open.lakala.com，点击开发者注册 - 填写企业名称、法人信息、对公账户、联系电话，上传全套资质材料
- 签署《支付服务协议》《API 接口服务协议》，分账业务额外签署《钱账通分账补充协议》
-
风控人工审核：
- 普通聚合支付：1 个工作日
- 钱账通多级分账 API：1–3 个工作日
-
审核通过后获取核心凭证：
-
商户号
mercId(MCHID)、终端号termNo(TID) -
API 签名密钥
AppSecret（生产 / 沙箱两套独立密钥，严禁泄露） - 登录开发者后台权限，开通支付、退款、订单查询、分账接口权限
-
商户号
三、第二步：下载官方开发文档、SDK 与沙箱测试账号
1. 文档入口
开发者后台 → 开发中心 → API 文档中心，两套文档分开：
- 聚合支付 API（线上 H5 / 小程序 / APP / 公众号收款）
- 钱账通分账 API（空中自动拆分、多级分润）
2. 标准核心接口清单
聚合支付基础接口
-
统一下单：
/api/v3/pay/unifiedorder（核心，生成预支付订单） -
订单查询：
/api/v3/trade/query -
退款接口：
/api/v3/refund/create - 异步回调通知：支付结果、退款结果推送地址配置
钱账通分账扩展接口
- 订单分账（下单携带分账参数，支付即自动拆分）
- 分账结果查询
- 子商户 / 分账接收方管理
- 逆向退款分账冲正接口拉卡拉
3. 多语言官方 SDK（开箱即用，减少开发量）
Java / PHP / Python / Go / PHP7+，附带签名加密工具、示例 Demo、错误码大全； 文档包含字段说明、签名算法、时间戳规则、加解密规范。
4. 沙箱测试环境资源
后台领取专属沙箱商户号、测试密钥、测试银行卡，两套环境域名完全隔离：
-
沙箱测试域名：
https://test.wsmsd.cn -
生产正式域名：
https://s2.lakala.com
四、第三步：后台核心配置（开发前必做）
- 配置异步回调通知地址 notify_url 要求公网 HTTPS 域名，支付成功、分账完成、退款会主动推送 JSON 结果至该地址，用于同步更新商城订单状态；
- 服务器 IP 白名单 将拉卡拉官方出口 IP 加入业务服务器白名单，防止接口调用被防火墙拦截；
- 小程序 / 公众号额外配置支付目录、业务域名校验；
- 分账系统配置：新增分账接收方（供应商 / 门店 / 达人）、预设分账比例模板（比例 / 固定金额 / 阶梯 / 多级混合）。
五、第四步：本地开发与沙箱联调测试（3–7 天）
1. 开发流程标准步骤
- 封装签名工具：所有请求必须使用 AppSecret 生成 MD5/SHA256 签名，防止参数篡改；
- 统一下单接口对接：传入订单金额、商户订单号、渠道类型（JSAPI/APP/MWEB）、回调地址；如需自动分账，追加分账方 ID、分账比例参数；
- 前端拉起支付：小程序、APP、H5 分别处理 prepay_id 唤起收银；
- 实现订单查询、全额 / 部分退款接口；
- 开发回调接收逻辑：校验签名、解析支付 / 分账状态，本地数据库更新订单；
- 异常处理：超时、支付失败、退款驳回、分账失败重试机制。
2. 沙箱全场景测试清单（必须全部通过才可上线）
- 正常支付成功、用户中途取消支付；
- 全额退款、部分退款、重复退款拦截；
- 单笔订单自动分账、多级链式分账金额校验；
- 异步回调超时、重复推送幂等处理；
- 大额、小额、分账比例边界场景验证；
- 核对手续费、分账金额计算逻辑与文档一致；
- 模拟网络中断、服务器超时等异常场景。
3. 测试验收标准
- 所有接口调用无报错、返回码 00 代表成功；
- 回调地址稳定接收通知，无丢单；
- 分账资金拆分与预设规则完全匹配；
- 退款逆向分账可正常冲正资金。
六、第五步：提交上线申请，切换生产环境
- 测试全部通过后，在开发者后台提交上线验收申请，技术客服 1 个工作日复核测试记录；
- 审核通过，拿到生产环境商户号、生产密钥、生产接口域名；
-
代码替换配置：
- 沙箱域名 → 生产域名
- 沙箱商户号 / 密钥 → 生产商户号 / 密钥
- 服务器重新发布上线，建议先灰度小流量试运行 1–2 天，监控订单、分账、回调稳定性；
- 正式全量开放线上收款、自动分账能力。
七、上线后运维与对账配套能力
- API 对账文件自动推送：每日凌晨生成 T+1 交易、分账明细 Excel/PDF，SFTP 自动推送至企业服务器；
- 后台可视化数据看板：线上线下 POS 统一归集流水、分账汇总报表；
- 7×24 技术支持：开发对接专线、95016 客服、专属技术对接人；
- 区块链存证：所有支付、分账记录不可篡改，电子清算回单可直接用于审计报税。
八、两种对接模式对比（按需选择）
- API 直连模式（本文流程，适合自有技术团队） 深度定制，支持自动分账、多级分润、ERP / 商城打通，无代码限制，适配电商、连锁平台；
- SaaS 标准化收银台（零代码） 无需开发，后台配置参数生成支付页面，适合小型商家，无自定义分账能力。
九、全流程周期汇总
- 资质认证：1–3 工作日
- 文档研读 + 开发：3–7 工作日
- 沙箱联调测试：1–3 工作日
- 上线审核 + 灰度试运行：1–2 工作日 常规完整周期：5–12 天，有成熟商城系统可缩短至 3 天
十、核心合规优势（API 分账独有）
- 央行持牌一清通道，资金全程在央行备付金账户空中拆分，不落地企业对公账户，无资金池、无二清风险；
- 分账比例无微信 / 支付宝 30% 上限，一笔订单最多拆分 50 个收款账户；
- 线上小程序 / H5 + 线下拉卡拉 POS 机资金统一归集，一套 API 管理全渠道收款与分润。
