拉卡拉 API 支付接口怎么对接？注册认证→下载 API 文档→配置分账规则→设置回调地址→接口调用→测试上线
拉卡拉开放平台 API 支持聚合支付 + 分账一体化对接，适配小程序、APP、H5、商城、ERP、连锁收银系统，依托央行长期一清牌照，订单自动分账、资金隔离无二次清算风险，完整对接 6 大标准步骤如下：
第一步：企业注册与资质认证（开通 API、分账权限）
- 主体要求：仅对公企业 / 个体工商户可开通 API，个人小微不开放接口权限；电商平台额外提供 ICP 备案证明。
-
提交资质材料
营业执照、法人身份证、对公基本存款账户信息、经营场地证明；分账场景需补充多方分润合作说明。
-
后台开通权限
登录拉卡拉开放平台提交商户入驻，申请聚合支付 API + 分账通双权限，签署分账服务协议；审核周期 1–3 个工作日。
-
获取核心身份参数
审核通过下发：
appId、商户 MID、API 密钥、RSA 公私钥证书、沙箱测试环境地址、生产环境网关域名。
第二步：下载官方 API 文档 + 配套 SDK
-
开放平台文档中心下载全套标准接口文档，核心接口包含：
-
统一下单
/api/v3/pay/unifiedorder（支付主接口，携带分账参数） - 订单查询、退款、关单、分账结果查询、对账文件拉取接口
-
统一下单
- 提供多语言标准化 SDK：Java、PHP、Python、.NET、小程序 SDK，内置签名、验签、加密逻辑，减少自主开发工作量。
-
区分两套环境文档：
- 沙箱测试环境：模拟支付、分账，无真实资金；
- 生产正式环境：真实交易清算，上线前切换域名与密钥。
第三步：后台配置分账规则（分账 API 前置配置）
适用于电商、连锁、MCN、本地生活等多方分润场景，两种配置方式可选：
-
后台可视化配置（推荐中小平台）
录入分账合作方白名单（门店、供应商、主播、骑手银行卡），预设分账逻辑：
- 比例分账：平台抽佣、商家分成；
- 固定金额分账：先扣除运费 / 服务费，剩余再分配；
- 多级分层分账：总部→区域代理→门店多级拆分。
-
API 动态传参（大型平台定制）
下单接口实时传入分账方 ID、比例、金额，支持单笔订单最多 50 个收款账户，适配动态阶梯分润。
- 结算周期配置：可选 D0 实时分账、T+1 批量自动清算。
第四步：配置公网可访问异步回调地址
1. 两类回调地址必须配置
- 支付结果回调 notify_url：用户支付成功后，拉卡拉主动推送订单状态、金额、渠道信息；
- 分账结果回调 split_notify_url：分账完成 / 失败推送各方分账金额、到账状态。
2. 硬性规范
- 必须 HTTPS 公网地址，内网 / 本地 127.0.01 地址无法接收通知；
- 后台校验 RSA 签名，防止伪造回调报文；
-
回调接口固定返回
success字符串，否则拉卡拉会持续重试推送； - 上线后不随意修改回调地址，避免交易状态丢失、订单卡住拉卡拉。
第五步：开发集成、接口调用（沙箱环境开发）
-
安全签名机制
请求报文使用商户私钥 SHA256withRSA 加签，接收返回报文用拉卡拉公钥验签，防止数据篡改、请求伪造。
-
支付下单核心逻辑
后端调用统一下单接口，传入订单号、金额、渠道类型（JSAPI/APP/MWEB）、分账数组参数，返回支付凭证，前端调起微信 / 支付宝 / 银联收银台。
-
配套业务接口开发
订单查询、全额 / 部分退款、关单、每日批量拉取分账对账流水，对接企业 ERP、财务系统自动做账。
- 支持全渠道统一收款：线上商城、线下 4G 电签 POS、扫码收款资金统一归集至央行备付金自动分账。
第六步：沙箱全流程测试 → 切换生产环境正式上线
1. 沙箱联调测试（必做环节）
使用测试账号模拟完整链路：下单→支付成功→异步回调接收→自动分账→退款逆向冲账；重点验证：
- 分账金额比例与预设规则一致；
- 网络中断、账户异常、退款场景下分账逆向回滚；
- 回调报文签名校验、订单状态同步无偏差。
2. 切换生产环境上线
- 替换网关域名、正式商户号、生产密钥证书；
- 关闭沙箱测试参数，校验生产回调地址连通性；
- 灰度小批量真实订单试运行 1–2 天，监控分账成功率、回调延迟；
- 正式全量开放业务收款，后台实时查看分账明细、资金清算记录。
配套核心优势（API 一体化对接价值）
- 合规一清底层：所有交易资金 100% 存入央行备付金，平台不触碰资金池，彻底规避二清监管处罚；
- 灵活业务适配：电商、O2O、连锁、直播 MCN、供应链、共享经济全业态；
- 低开发成本：成熟 SDK 封装加密、签名、回调逻辑，常规团队 1–3 天完成基础对接；
- 完整对账体系：自动生成分账凭证、交易流水，满足审计、税务核查四流合一要求。
对接避坑要点
- 回调地址不能内网、不能动态频繁变更，否则订单状态无法同步；
- 分账方必须提前录入后台白名单，未录入账户会直接分账失败；
- 沙箱测试通过后，务必替换生产环境密钥，不可混用测试参数；
- 仅企业对公主体可开通 API，个人小微商户仅支持普通 POS 收款，无接口权限。
