拉卡拉API支付接口接入指南：分账接口开发流程与联调注意事项
拉卡拉分账API接入全流程标准周期1-2周，核心分为资质入网、开发、沙箱联调、灰度上线4个阶段，所有接口遵循HTTPS+RSA-SHA256签名规范，联调避坑核心是严格区分测试/生产两套密钥、做好回调幂等处理。
接入前资质与环境准备
-
提交营业执照、法人身份证、对公账户、分账业务场景说明书，完成企业商户入网审核，签署分账服务协议。
-
准备支持HTTPS公网访问的服务器，用于接收异步回调notify_url，避免回调地址内网无法访问导致丢单。
-
确认开发语言匹配官方提供的Java、PHP、Python、Go、.NET多语言SDK，直接复用封装好的签名、验签逻辑，减少从零开发工作量。
-
入网审核通过后，在拉卡拉开放平台创建应用，系统下发商户号MCH ID、AppID、API私钥与平台公钥证书，这些是所有接口调用的核心身份凭证。
分账接口核心开发流程
-
签名逻辑开发：所有请求参数按ASCII码排序拼接，用商户私钥做SHA256withRSA签名，签名值放入sign字段，公共参数merchant_id、app_id、version、timestamp、req_data、sign缺一不可。
-
分账下单接口开发：支付下单时将settle_type字段传"1"，夹带split_flag、split_type、split_list分账参数，支持按比例或固定金额预置分账规则，支付成功后自动触发拆分。
-
回调与幂等处理开发：支付结果、分账结果均通过异步回调推送，回调处理必须先验签，再实现幂等去重逻辑，避免重复回调导致重复分账。
-
兜底逻辑开发：主动查询接口作为最终状态确认依据，不能完全依赖异步回调，回调地址不可达时系统会自动重试，但业务侧必须以主动查单结果为准，防止状态不一致。
沙箱联调全场景验证
-
沙箱环境与生产环境接口规则、签名方式完全一致，仅资金为虚拟流转，提供虚拟测试卡号与模拟授权码，无需真实资金即可完成全流程测试。
-
必测核心场景：正常支付与分账、3方以上多方分账、固定金额与比例混合分账、分账后退款逆向扣回、重复回调幂等处理、主动查询兜底、对账文件下载核对。
-
利用沙箱后台手动触发回调功能、在线签名工具，快速定位签名错误、回调逻辑异常等高频问题，大幅缩短联调周期。
-
注意测试环境微信钱包下单会提示"sub mch id与sub appid不匹配"，属于官方已知正常现象，无需额外排查。
生产上线与灰度验证
-
将沙箱配置切换为生产环境域名与生产密钥，先发起一笔1分钱真实小额交易，验证资金到账、回调、分账全链路正常。
-
不建议一次性全量切换，先选择1-2个分账方或5%-10%的订单灰度运行1-2天，确认资金准确、回调稳定、对账无误后再全量上线。
-
完成生产环境回调白名单配置，确认所有支付渠道分账权限已全部开通，避免上线后部分渠道分账链路失效。
高频联调避坑注意事项
-
测试密钥和生产密钥是完全独立的两套体系，绝对不能混用，很多开发者上线前夜才发现支付失败，就是误把测试密钥配置到了生产环境。
-
不要使用来源不明的第三方接口Demo包，这类包大多硬编码过期测试密钥，甚至捆绑恶意程序，极易导致上线后触发银行风控拦截。
-
分账后发起退款必须上送refund_amt_sts字段为"01"，告知系统当前订单已完成分账，否则会出现退款资金无法从各分账方账户逆向扣回的异常。
-
签名校验时注意服务器时间差不能超过5分钟，否则会直接触发SIGN_TIMEOUT签名超时错误，提前同步服务器时间即可规避。
-
单笔订单分账接收方最多支持20个，拆单信息域中所有子单金额之和必须等于主订单总金额，任意一个分账方权限校验失败，整笔交易直接中止。
