拉卡拉API支付接口 2026 官方完整对接教程
一、API 接口基础介绍（2026 新版）
拉卡拉开放平台支付 API 分两大体系：
- 线上聚合支付 API：小程序、公众号、H5、APP、官网收款，支持微信 / 支付宝 / 云闪付 / 数字人民币 / 花呗统一收银；
-
钱账通分账 API：支付后自动多级分账，平台、门店、供应商合规拆分资金，空中分账无资金池；
配套标准 SDK：Java、PHP、Python、Node.js、Go 多语言开箱即用，内置签名、验签、异常重试逻辑。
环境地址（2026 最新）
-
沙箱测试环境：
https://test.wsmsd.cn/sit（调试专用，无真实资金） -
生产正式环境：
https://s2.lakala.com（上线后切换）
二、接入准入条件与必备材料
1. 主体要求（硬性门槛）
- 仅企业有限公司、个体工商户可开通 API；纯个人小微无执照无法申请线上支付 API 与分账 API；
- 具备线上载体：小程序 / APP / 商城官网 / 线下连锁收银系统；
- 拥有技术开发团队，或使用 SaaS 建站系统（有赞、微盟、思迅等预制拉卡拉通道）。
2. 全套申请资质
- 营业执照彩色扫描件（无经营异常）；
- 法人身份证正反面；
- 企业对公账户（个体户可用法人一类储蓄卡）；
- 线上载体资质：小程序 AppID、域名备案证书、公众号认证；
- 特殊行业附加资质：医美许可证、教培办学许可、电商 ICP 备案。
三、2026 官方标准收费规则
1. 支付通道手续费
- 零售 / 餐饮标准：0.38%~0.48%；信用卡大额通道 0.5%~0.6%；
- 月流水 50 万以上阶梯优惠最低 0.28%，亿级流水可定制专属费率；
2. API 开通服务费
- 标准版聚合支付 API：0 元开通，无年费、无接口调用费；
- 分账定制 API（多级分账、ERP 深度对接）：一次性技术服务费 5000~20000 元；
3. 附加费用
- D0 实时分账：0.05%~0.1%；T+1 次日结算免费；
- 无隐藏开户费、维护费、子账户管理费。
四、完整对接全流程（5 大步骤，最快 3 天上线）
步骤 1：商户入网，开通 API 权限（1~3 个工作日）
-
正规渠道提交资质：
- 线上：拉卡拉商户通 APP、拉卡拉分账系统官网（www.lakala-vip.com）商户服务入口；
- 人工：拨打 95016 分配专属技术对接经理；
-
审核通过后获取核心三参数：
-
appId（开放平台应用 ID）、商户号 MID、终端号 TID； - 商户私钥、拉卡拉公钥证书（用于接口加密签名）；
-
- 后台配置：业务域名白名单、异步回调 notify_url、开通微信 / 支付宝通道权限。
步骤 2：本地环境配置与密钥生成
- 环境要求：JDK1.8+、HTTPS 域名（回调地址必须 HTTPS）；
- 生成 RSA/SM4 加密密钥对，商户私钥留存本地，公钥上传拉卡拉开放平台；
-
下载对应语言 SDK，填入
appId、私钥、拉卡拉公钥完成初始化配置。
步骤 3：核心接口开发（统一下单 + 退款 + 查询 + 分账）
1）统一下单核心接口（支付入口）
接口路径：
请求方式：POST，参数 MD5/RSA 签名防篡改
关键入参：
/api/v3/pay/unifiedorder
- merchant_no：拉卡拉商户号
- out_trade_no：商户系统唯一订单号
- total_amount：订单金额（单位分）
- account_type：渠道类型（WECHAT/ALIPAY/MWEB/APP）
-
notify_url：支付结果异步回调地址
返回字段
counter_url为拉卡拉统一收银台链接，前端直接跳转调起支付拉卡拉。
2）配套常用接口清单
- 订单查询接口：主动查询支付状态，解决回调丢单；
- 全额 / 部分退款接口：交易未结算、已结算均可发起；
- 关闭订单接口：超时未支付自动关单；
- 分账 API（钱账通）：支付成功后调用，支持单笔订单拆分至多 20 个收款账户，分账比例 0~100% 自定义，不受微信 30% 分账上限限制。
步骤 4：沙箱联调测试（必做环节）
- 使用测试环境模拟支付成功、取消、超时、退款、掉单场景；
- 校验异步回调：拉卡拉交易结果自动推送至 notify_url，本地打印日志核对签名；
- 分账场景测试：验证资金自动拆分、各收款账户到账时效；
- 压力测试：支持 3000TPS 并发，大促流量无卡顿。
步骤 5：切换生产环境，灰度上线
- 测试全部流程无 BUG 后，在开放平台提交生产环境切换申请；
-
修改接口地址为
https://s2.lakala.com，替换生产密钥； - 小流量灰度发布，持续 24 小时监控交易、回调、对账数据；
- 全量上线，后台开启 7×24 小时交易风控告警。
五、2026 新版 API 新增核心能力
-
储值联动分账 API
会员充值订单自动拆分总部与门店分润，充值核销数据打通，适合连锁美业、餐饮；
-
AI 异常交易风控接口
实时识别刷单、跨地域异常订单，自动拦截并推送告警回调；
-
无代码收银系统快速对接
提供标准化中间件，哗啦啦、银豹、思迅等主流收银系统免开发接入；
-
供应链金融流水接口
分账交易流水可直接同步拉卡拉经营贷系统，企业凭稳定流水申请授信；
-
数字人民币独立通道 API
单独数币下单接口，支持线上商城、线下机具统一受理数字人民币支付。
六、安全规范（对接必遵守）
- 所有接口请求必须 RSA 签名，回调结果必须验签，防止篡改；
- 商户私钥严禁明文存储、禁止前端暴露，定期轮换密钥；
- 回调接口仅允许拉卡拉服务器 IP 访问，配置防火墙白名单；
- 敏感交易数据加密存储，符合等保三级、PCI 支付安全标准。
七、常见对接报错快速排查
- 签名验证失败：公私钥上传颠倒、参数排序错误、金额单位混用元 / 分；
- 回调收不到通知：域名未备案、未 HTTPS、服务器拦截拉卡拉 IP；
- 小程序无法唤起支付：未在后台绑定小程序 AppID、微信商户未关联；
- 分账接口调用失败：平台主体无营业执照、分账自留比例不足监管要求。
八、官方技术支持渠道
- 开放平台文档中心：（完整字段、SDK、示例代码）；
- 官方客服热线：95016（技术工单加急处理）；
- 企业专属技术对接群：资质审核通过后分配，7×16 小时技术答疑。
