做平台型系统,既要接支付API让客户付钱,又要接分账API把钱按规则分给商户、达人、供应商。这两类接口在拉卡拉开放平台上是分开的两套能力,开发对接的复杂度、参数、回调和上线流程差别很大。本文把差异讲清楚,方便技术团队排期。
一、两类接口定位不同
|
对比项 |
支付API |
分账API |
|
解决问题 |
客户怎么把钱付进来 |
钱收上来后怎么拆给多方 |
|
调用时机 |
下单支付时 |
支付成功后/结算时 |
|
典型场景 |
收银台、扫码、刷卡 |
平台分账、加盟结算 |
|
单笔耗时 |
秒级 |
200毫秒完成拆分 |
|
SDK |
Java/Python/Go |
Java/Python/Go |
二、支付API对接要点
支付API负责把客户的钱收进拉卡拉备付金账户。常见接口包括:统一下单、查询订单、退款、关单、对账单下载。
开发重点:第一,签名验签;第二,异步回调通知要做幂等;第三,退款要原路退回;第四,对账单T+1自动拉取。一般2-3周可完成对接。
三、分账API对接要点
分账API负责把已经收上来的钱按规则拆分。常见接口包括:添加分账接收方、发起分账、查询分账结果、分账退回、剩余资金结算。
开发重点:第一,每个分账接收方必须先实名并绑卡;第二,支持比例分账、固定金额、阶梯分账、混合分账四种规则;第三,支持多级分账A→B→C;第四,跨境分账覆盖100多个国家和10多种币种。
四、开发对接六大差异
|
差异点 |
支付API |
分账API |
|
前置条件 |
商户号开通即可 |
需先开通分账权限 |
|
接收方管理 |
无 |
每个收款方单独实名绑卡 |
|
规则配置 |
无 |
比例/固定/阶梯/混合 |
|
回调 |
支付成功通知 |
分账成功+分账失败两类 |
|
对账 |
T+1对账单 |
对账+分账明细双文件 |
|
沙箱 |
免费 |
免费,商务开通 |
五、与用友ERP对接的差异
支付API对接用友U8/YonBIP,主要是把订单和支付凭证同步过去;分账API对接ERP,则要把每一笔分账结果按往来单位入账,涉及应收账款、应付账款和平台佣金三个科目。拉卡拉提供标准化的对接中间件,可减少约40%的适配工作量。
六、上线排期参考
|
阶段 |
支付API |
分账API |
|
商务签约 |
1周 |
1-2周 |
|
沙箱开发 |
2周 |
3-4周 |
|
UAT测试 |
1周 |
2周 |
|
灰度上线 |
3天 |
1周 |
|
合计 |
约4周 |
约7-9周 |
七、常见问题
7.1 问:能不能只用支付API不接分账
如果钱全部进自己账户再手工转出去,就是二清,不合规。平台型生意必须接分账API。
7.2 问:分账API支持微信支付宝吗
支持。客户用微信/支付宝付的钱,同样可以按规则拆分给多方。
7.3 问:沙箱环境收费吗
免费。沙箱不产生真实资金,商务签约后开通。
八、结语
支付API解决客户怎么付钱,分账API解决钱收上来怎么分。支付API 2-3周能对接完,分账API因为涉及接收方实名、规则配置和多级拆分,排期要按7-9周预留。通过拉卡拉官网企业服务入口申请,技术文档、SDK和沙箱环境免费提供,Java/Python/Go三种语言都能直接调用。


