本文旨在为大家解答日常在接入拉卡拉聚合支付的问题各种问题记录分享,本文持续更新,若本文未提及的问题,可通过本文内置链接联系人工客服。
拉卡拉聚合支付api接口支持安卓端、苹果IOS端、微信小程序、鸿蒙系统的接入。对应的接口有不同的SDK提供
备注:此条回答只做流程介绍,涉及的具体的详情请点击咨询人工客服
开发接入流程步骤
1、自行申请证书
l 接入方需生成自己的密钥对(使用RSA算法,密钥长度2048位)。
l 生成证书文件:包括私钥( api_private_key.pem )和公钥证书( api_cert.cer )。
2、提交证书至拉卡拉
l 将生成的公钥证书( api_cert.cer )提供给拉卡拉对接人员(点击此处咨询人工)。
l 拉卡拉分配一个唯一的开放平台AppID。
3、配置权限组与导入证书
l 登录拉卡拉开放平台(如测试环境或生产环境)。
l 在【开发—应用管理】中配置权限组,并导入拉卡拉的公钥证书( lkl-apigw-v1.cer )。
l 上传接入方的公钥证书( api_cert.cer )完成绑定。
4、生成开放平台证书
l 使用拉卡拉提供的证书生成工具(下载地址:RSA密钥生成工具)。
l 工具会生成以下文件:
商户私钥( api_private_key.pem ):用于请求签名。
商户公钥( api_public_key.pem ):仅作保存。
商户证书( api_cert.cer ):提供给拉卡拉配置。
5、获取AppID并接入开发(获取AppID请咨询人工)
l 使用分配的AppID和证书,根据开发文档调用API接口。
l 示例接口调用需包含签名(使用SHA256withRSA算法)和公共参数(如 req_time 、 version 等)。
注意事项
l 请求签名:所有API请求需在Header中添加 Authorization 字段,格式为:
LKLAPI-SHA256withRSA appid="您的AppID",serial_no="证书序列号",timestamp="时间戳",nonce_str="随机字符串",signature="签名值" 。
l 响应验签:处理拉卡拉回调时,需验证响应签名(使用拉卡拉公钥证书)。
l 敏感信息加密:涉及敏感数据的接口需使用国密SM4算法加密(密钥通过邮箱申请)。
l 环境区分:测试环境与生产环境的证书、IP白名单不同(测试IP: 58.246.131.244 , 61.169.68.178 ;生产IP需参考文档配置)。
l 错误处理:常见错误码如 OP90001 (非法请求参数)需检查证书、权限或报文格式。
拉卡拉聚合支付微信小程序支持半屏唤起和全屏唤起。具体详情可点击文章《拉卡拉聚合支付半屏和全屏唤起解答》或可直接点击咨询人工客服
如有未提及的问题,小伙伴们可以咨询人工客服