拉卡拉分账通有没有API接口？系统对接自动分账方法

平台业务量上来后，手动在后台分账效率太低，能不能通过API接口实现自动分账？拉卡拉分账通有没有开放API？怎么对接？本文详细解析拉卡拉分账通的API接口能力、核心接口清单、参数说明、签名机制、接入七步流程、自动分账实现方案和回调处理。

 

商户业务系统与拉卡拉开放平台API对接示意

1. 拉卡拉分账通有API接口吗

明确回答：有。拉卡拉分账通提供完整的开放API接口，通过拉卡拉开放平台（o.lakala.com）对外提供，支持商户业务系统与分账系统深度对接，实现交易自动分账、分账查询、撤销回退、接收方管理等全流程自动化。

API能力概览：

• 开放平台地址：o.lakala.com（新版文档中心）

• 核心接口：统一下单（带分账参数）、订单分账、分账查询、分账撤销、分账回退、接收方创建、分账关系绑定、退款分账

• 签名机制：双密钥体系（AppKey + API Secret），支持HMAC-SHA256和SHA256withRSA

• SDK支持：Java、Python、Go等多语言SDK，GitHub有开源封装

• 环境支持：测试环境（沙箱）+ 生产环境，支持模拟联调

• 数据格式：JSON请求/响应，异步回调通知

2. API对接 vs 后台配置：两种方式对比

对比项	API对接	商户后台配置
适用对象	有技术团队的平台型企业	无开发能力或业务简单的企业
分账触发	交易完成后系统自动发起分账	人工在后台手动发起或预设规则自动
灵活性	高，可按业务逻辑动态计算分账金额/比例	中，需提前配置固定规则
对接成本	需开发投入，对接周期3-10个工作日	零开发，后台配置即可使用
接口费用	分账版接口一次性5000元（标准场景）	无接口费，仅分账手续费
数据同步	实时回调，业务系统自动更新	需人工登录后台查看或导出
推荐场景	电商平台、SaaS系统、连锁ERP对接	小型平台、固定分成模式、初期验证

3. 核心API接口清单

接口名称	接口标识	功能说明
统一下单	/api/v3/pay/unifiedorder	发起支付交易时可同时传入分账参数，交易成功后自动触发分账
订单分账	OrderSplitLedger	对已完成的交易主动发起分账，支持按金额或按比例，最多50个接收方
分账查询	SplitLedgerQuery	根据分账指令流水号或交易订单号查询分账结果和明细
分账撤销	SplitLedgerCancel	当日分账交易全额撤销，资金回到分账账户，可重新发起分账
分账回退	SplitLedgerReturn	隔日分账交易部分回退，资金从接收方返回商户收款账户
接收方创建	ReceiverCreate	创建分账接收方，提交身份证/营业执照/银行账户，通过四要素验证
分账关系绑定	ApplyBind	建立商户与接收方的分账关系，需上传合作协议，人工审核后生效
退款分账	RefundSplit	交易退款时自动逆向分账，从各接收方扣回对应金额
账户流水查询	AccountQuery	查询分账商户账户和接收方账户的余额及动账明细
对账单下载	BillDownload	下载交易对账单和分账对账单，支持按日/按月

4. 分账接口核心参数详解

4.1 订单分账请求参数

参数名	类型	必填	说明
MerchantNo	String	是	拉卡拉商户号
OutSeparateNo	String	是	商户分账指令流水号，每次请求唯一，不可重复
TotalAmt	String	是	分账总金额，单位为分（如100元传10000）
CalType	Int	是	分账计算类型：0-按金额，1-按比例
LklOrgNo	String	否	拉卡拉机构编号
NotifyUrl	String	否	分账结果异步回调地址，处理中状态时会推送
RecvDatas	Array	是	分账接收方数据数组，每个元素包含接收方编号、分账金额/比例、备注

4.2 接收方数据（RecvDatas）参数

• ReceiverId：分账接收方编号（在拉卡拉系统中的唯一标识）

• Amount：分账金额（CalType=0时必填，单位分）

• Ratio：分账比例（CalType=1时必填，如70表示70%）

• Remark：分账备注（如"商品货款""达人佣金"等，便于对账）

4.3 响应参数

• code：响应码，0000表示成功

• msg：响应描述

• separate_no：拉卡拉分账流水号

• trade_status：分账状态（1-成功，2-失败，3-处理中）

• recv_results：各接收方分账结果数组

5. 签名机制与安全规范

5.1 双密钥体系

• AppKey：公钥，用于标识商户身份，格式如 lk20230915001

• API Secret：私钥，用于签名计算，长度32位随机字符串，需妥善保管

5.2 签名算法

• HMAC-SHA256：适用于大部分接口，使用API Secret对请求参数进行签名

• SHA256withRSA：适用于高安全要求接口，使用商户私钥证书签名，拉卡拉公钥验签

5.3 签名注意事项

90%的签名错误源于以下问题： 1. 报文末尾换行符丢失——拼接验签报文时，最后一行报文末尾必须保留换行符（\n），否则验签失败 2. 参数顺序错误——必须按接口文档规定的参数顺序拼接，不能乱序 3. 编码不一致——请求和签名必须使用UTF-8编码 4. 密钥环境混用——测试环境密钥和生产环境密钥不能交叉使用

5.4 安全规范

• API Secret严禁硬编码在前端代码中，必须放在服务端

• 回调通知必须验证签名，防止伪造回调

• 生产环境建议使用HTTPS传输，敏感信息加密

• 密钥定期轮换，泄露后立即在开放平台重置

• 接口调用需做频率控制和异常重试机制

6. API接入七步流程

 

拉卡拉分账API接入七步流程示意

6.1 第一步：商务对接与签约

• 联系拉卡拉商务团队或95016，说明分账业务场景

• 提交企业资质（营业执照、法人身份证、银行开户许可证）

• 签订《分账服务协议》和《结算授权委托书》

• 支付接口对接费（分账版标准5000元一次性，特殊场景1万元起）

6.2 第二步：开通分账功能

• 拉卡拉后台为商户开通分账权限

• 需上传《结算授权委托书》电子版或电子签约合同编号

• 开通需经人工审核，审核结果通过回调通知

• 配置最低分账比例（商户自身可分得的最低比例，低于则交易失败）

6.3 第三步：创建分账接收方

• 通过API或后台创建分账接收方

• 提交接收方资料：个人提供身份证+银行卡，企业提供营业执照+对公账户

• 系统进行四要素验证（姓名/身份证号/银行卡号/手机号）和黑名单校验

• 审核通过后生成ReceiverId，用于后续分账

6.4 第四步：绑定分账关系

• 通过ApplyBind接口申请建立商户与接收方的分账关系

• 需上传商户与接收方的合作协议电子版

• 绑定关系需经人工审核，审核结果回调通知

• 解绑需先解除分账关系，再删除接收方

6.5 第五步：密钥配置与环境准备

• 登录拉卡拉开放平台（o.lakala.com），进入应用管理

• 生成RSA密钥对，将公钥证书上传给拉卡拉，获取拉卡拉公钥

• 配置AppKey和API Secret

• 下载对应语言的SDK（Java/Python/Go等）

• 获取测试环境地址和测试商户号

6.6 第六步：沙箱测试与联调

• 在测试环境进行分账模拟验证

• 建议至少执行3-5笔模拟订单，覆盖：比例分账、金额分账、混合分账、分账查询、撤销回退

• 逐笔核对分账金额、到账账户、结算状态

• 验证回调通知的接收、验签、重试机制

• 联调通过后提交上线申请

6.7 第七步：切换生产环境上线

• 将测试环境配置替换为生产环境地址和密钥

• 使用真实商户号和接收方进行小批量验证

• 监控分账成功率、回调到达率、异常告警

• 正式上线运营，持续关注系统稳定性

7. 自动分账实现方案

7.1 方案一：下单时传入分账参数（推荐）

实现逻辑：在调用统一下单接口（/api/v3/pay/unifiedorder）时，同时传入分账参数（接收方列表、金额/比例），用户支付成功后，拉卡拉系统自动触发分账，无需额外调用分账接口。

• 优点：一步完成支付+分账，流程最简，实时性最高

• 缺点：分账规则需在下单时确定，不支持支付后修改

• 适用：分账规则固定、支付即分账的场景（如电商平台下单时已知分成比例）

7.2 方案二：支付成功后主动调用分账接口

实现逻辑：先调用统一下单完成支付，收到支付成功回调后，业务系统根据订单信息计算分账金额/比例，再调用OrderSplitLedger接口发起分账。

• 优点：分账逻辑完全由业务系统控制，支持复杂规则、延迟分账、条件分账

• 缺点：需多一次接口调用，需处理分账失败重试

• 适用：分账规则复杂、需履约后分账、动态计算分成的场景（如外卖确认收货后分账、服务完成后分账）

7.3 方案三：预设规则自动分账

实现逻辑：在拉卡拉后台预设分账规则（指定规则分账），交易时打上规则标识，系统自动匹配规则执行分账，业务系统无需调用分账接口。

• 优点：零开发，规则配置后自动运行

• 缺点：规则固定，灵活性差

• 适用：分成比例固定、接收方固定的标准化场景

8. 回调通知处理

8.1 回调触发条件

• 分账接口返回trade_status=3（处理中）时，且请求中传了NotifyUrl

• 分账最终状态确定后（成功/失败），拉卡拉主动推送回调

• 开通分账、绑定关系等审核结果也会通过回调通知

8.2 回调处理规范

1. 验证签名：收到回调后，首先使用拉卡拉公钥验证签名，确保回调来源可信

2. 幂等处理：同一笔分账可能收到多次回调，需根据OutSeparateNo做幂等，避免重复处理

3. 数据库事务：分账金额更新、订单状态变更等操作放在数据库事务中，确保数据一致性

4. 返回成功响应：处理完成后返回 {"return_code": "01","return_msg": "success"}，否则拉卡拉会重试推送

5. 异常告警：回调处理失败时记录日志并触发告警，人工介入处理

8.3 回调重试机制

• 拉卡拉收到非成功响应或超时未响应时，会按间隔重试推送

• 重试间隔通常为：1分钟、5分钟、30分钟、1小时、6小时、24小时

• 超过最大重试次数后停止推送，需商户主动调用分账查询接口补单

• 建议业务系统同时有定时任务主动查询"处理中"的分账单，防止回调丢失

9. 沙箱测试与联调要点

9.1 环境地址

• 测试环境：https://test.wsmsd.cn/sit/labs/txn/

• 生产环境：https://s2.lakala.com/labs/txn/

• 开放平台文档：o.lakala.com（新版文档中心）

9.2 联调必测场景

测试场景	验证要点
比例分账	多接收方按比例分配，金额精确到分，总和等于分账总额
金额分账	各接收方固定金额，总和等于分账总额
混合分账	先扣固定金额，剩余按比例分配，计算正确
分账查询	按分账流水号和订单号查询，返回状态和明细正确
分账撤销	当日分账全额撤销，资金回分账账户，可重新分账
分账回退	隔日部分回退，资金回商户账户，回退后不可重新分账
回调通知	处理中分账完成后推送回调，验签通过，幂等处理正常
异常场景	分账金额超限、接收方未绑定、签名错误等异常返回正确错误码

10. 常见问题解答

10.1 拉卡拉分账通API对接需要多少钱？

分账版接口对接费一次性5000元，覆盖基础分账功能（单级分账、订单状态同步）、系统对接、技术支持及初期培训，适用于业务模式简单的场景。特殊行业或复杂场景（多级分账、跨境分账、定制化需求）对接费1万元起，具体根据系统复杂度浮动。此外按分账金额收取分账手续费，无年费、无维护费。建议联系95016或客户经理获取具体报价。

10.2 没有技术团队能用API吗？

如果没有技术团队，建议使用商户后台配置模式（指定规则分账），无需开发即可实现自动分账。如果必须用API对接，可以找拉卡拉推荐的技术服务商，或使用GitHub上的开源SDK（如lkl_sdk）降低开发难度。拉卡拉也提供技术支持和联调指导，对接周期通常3-10个工作日。

10.3 分账接口调用失败怎么办？

首先查看接口返回的code和msg，定位错误原因。常见错误：签名错误（检查参数顺序和换行符）、接收方未绑定（先完成绑定审核）、分账金额超限（不超过交易可分金额）、商户号无分账权限（确认已开通）。如果是网络超时或系统异常，使用相同OutSeparateNo重试（幂等）。持续失败联系技术支持或95016。

10.4 分账状态一直是"处理中"怎么办？

分账处理中通常是因为接收方账户结算需要时间，或系统批量处理延迟。建议：①等待回调通知，分账完成后会主动推送；②5分钟后调用分账查询接口确认最新状态；③如果超过30分钟仍处理中，联系技术支持排查。注意不要用新的OutSeparateNo重复发起分账，否则可能导致重复分账。

10.5 支持哪些编程语言的SDK？

拉卡拉开放平台官方提供Java SDK，社区有Python、Go、PHP等语言的开源封装（如GitHub上的lkl_sdk Go语言SDK、ddl-lakala-pay等）。SDK封装了签名、请求、响应解析等基础逻辑，开发者只需关注业务参数。建议优先使用官方SDK，社区SDK需自行评估安全性和维护状态。

10.6 分账接口有调用频率限制吗？

拉卡拉开放平台有接口频率限制（QPS限制），具体阈值根据商户等级和接口类型不同，通常在每秒几十到上百次。大促期间可提前联系客户经理申请临时提额。业务系统应做好限流和队列缓冲，避免突发流量导致接口拒绝。超时请求需做幂等重试，不要无限重试。

10.7 回调地址必须是公网可访问的吗？

是的，回调地址必须是公网可访问的HTTPS地址，拉卡拉服务器才能推送回调。本地开发时可使用内网穿透工具（如ngrok）临时映射，或使用测试环境的回调代理。生产环境建议使用独立的回调接收服务，做好高可用和容灾，确保回调不丢失。

总结：拉卡拉分账通提供完整的开放API接口，通过拉卡拉开放平台（o.lakala.com）对外提供，支持统一下单带分账、订单分账、分账查询、撤销、回退、接收方管理、关系绑定、退款分账、账户查询、对账单下载等十大核心接口。核心参数包括MerchantNo、OutSeparateNo（唯一流水号）、TotalAmt（单位分）、CalType（0按金额/1按比例）、RecvDatas（接收方数组）。签名采用双密钥体系（AppKey+API Secret），支持HMAC-SHA256和SHA256withRSA，90%签名错误源于报文末尾换行符丢失。接入七步流程：商务签约→开通分账→创建接收方→绑定关系→密钥配置→沙箱测试→上线运营。自动分账三种方案：下单时传分账参数（推荐）、支付后主动调分账接口（灵活）、预设规则自动分账（零开发）。回调需验签+幂等+事务+返回成功响应，配合定时查询防丢失。接口对接费分账版5000元一次性，支持Java/Python/Go等SDK，对接周期3-10个工作日。