拉卡拉API支付接口商户号申请全教程：API接入商户开通流程
|
一句话结论：拉卡拉API支付接口商户号申请全程在线完成，企业商户需提供营业执照、法人身份证、对公账户（或法人私卡+授权书）、经营场景证明，个体工商户需营业执照、经营者身份证、个人银行卡。注册开放平台→实名认证→开通支付产品→获取商户号和API密钥→配置回调地址和IP白名单→沙箱联调→切换生产上线，全程3-5个工作日。提供Java/Python/Go/PHP多语言SDK和免费沙箱环境，技术对接5-7工作日可完成。 |
1. 商户号申请概述
1.1 1.1 什么是API商户号
• 定义：商户在拉卡拉开放平台的唯一标识，用于API接口调用、交易识别、资金结算
• 格式：通常为15位数字，如888888888888888
• 关联：一个商户号可关联多个支付产品（聚合支付、分账、退款等）
• 密钥：每个商户号对应一对RSA密钥（商户私钥签名、拉卡拉公钥验签）
• 沙箱号：开发阶段使用沙箱商户号，与生产商户号隔离
1.2 1.2 申请条件
|
商户类型 |
必备资质 |
审核时效 |
|
企业商户 |
营业执照、法人身份证、对公账户、经营证明 |
3-5工作日 |
|
个体工商户 |
营业执照、经营者身份证、个人银行卡 |
1-3工作日 |
|
事业单位 |
事业单位法人证书、负责人身份证、对公账户 |
3-5工作日 |
|
社会组织 |
社会团体登记证书、负责人身份证、对公账户 |
3-5工作日 |
1.3 1.3 不支持的主体
• 个人用户：纯个人（无营业执照）无法申请API商户号，需注册个体工商户
• 境外企业：境外注册企业暂不支持直接申请，需通过境内主体或跨境支付通道
• 禁入行业：赌博、色情、传销、虚假交易、非法外汇等违法违规行业
• 高风险行业：部分高风险行业（如虚拟货币、贵金属）需特殊审批
图1：支付网关API集成开发界面（商户号与API配置）
2. 申请材料准备
2.1 2.1 企业商户材料
• 营业执照：三证合一营业执照，有效期内，经营范围包含实际业务
• 法人身份证：法定代表人身份证正反面，有效期内，年满18周岁
• 对公账户：基本户开户许可证或一般户开户证明，户名与企业名称一致
• 法人私卡（可选）：小微企业可使用法人个人借记卡，需法人结算授权书
• 经营场景证明：线下门店照片、线上网站/APP/小程序链接、办公场所照片
• 实际控制人：持股≥25%股东信息、实际控制人身份证（部分行业要求）
2.2 2.2 个体工商户材料
• 营业执照：个体工商户营业执照，有效期内
• 经营者身份证：经营者本人身份证正反面
• 个人银行卡：经营者本人借记卡，支持主流银行
• 经营场景：经营场所照片、摆摊照、线上店铺链接等
• 优势：材料简单、审核快、无需对公账户
2.3 2.3 特殊行业补充材料
• 餐饮：食品经营许可证
• 教育：办学许可证或教育部门备案证明
• 医疗：医疗机构执业许可证
• 旅游：旅行社业务经营许可证
• 金融：金融监管部门批准文件
• 跨境：进出口经营权、海关登记证
2.4 2.4 材料注意事项
• 清晰度：所有证件照片清晰可辨，四角完整，无反光遮挡
• 有效期：证件在有效期内，过期证件需先更新
• 一致性：营业执照名称、法人姓名、账户户名必须一致
• 真实性：不得使用PS、伪造证件，一经发现永久拉黑
• 经营范围：实际业务需在营业执照经营范围内，超出需增项
|
材料准备清单（企业商户）： ☐ 营业执照（三证合一）原件照片 ☐ 法人身份证正反面照片 ☐ 对公账户开户许可证/基本户信息 ☐ 法人结算授权书（如使用法人私卡） ☐ 经营场景照片（门店/办公/网站截图） ☐ 实际控制人身份证（持股≥25%股东） ☐ 行业资质许可证（如涉及特殊行业） ☐ 企业公章（签署电子协议时使用） |
3. 申请开通流程
3.1 3.1 第一步：注册开放平台账号
1. 访问拉卡拉开放平台（open.lakala.com），点击"注册"
2. 使用手机号注册，获取验证码，设置登录密码
3. 选择账号类型：企业账号/个体工商户账号
4. 填写企业基本信息（企业名称、统一社会信用代码、法人姓名）
5. 完成邮箱验证（用于接收通知和找回密码）
3.2 3.2 第二步：企业实名认证
1. 登录开放平台，进入"账号管理→实名认证"
2. 上传营业执照、法人身份证正反面
3. 填写企业信息（注册地址、经营地址、经营范围、联系电话）
4. 法人本人完成人脸识别活体检测
5. 签署《拉卡拉开放平台服务协议》（电子签章）
6. 提交审核，1-2工作日完成实名认证
3.3 3.3 第三步：开通支付产品
1. 实名认证通过后，进入"产品中心"
2. 选择需要开通的产品：聚合支付、分账通、钱账通、跨境支付等
3. 填写产品开通信息（业务场景描述、预计交易量、接入方式）
4. 上传经营场景证明（网站/APP/小程序链接、门店照片）
5. 绑定结算账户（对公账户或法人私卡）
6. 提交审核，1-3工作日完成产品开通
3.4 3.4 第四步：获取商户号和密钥
1. 产品开通后，进入"开发配置→商户信息"
2. 查看生产商户号（merchant_id）和沙箱商户号
3. 生成RSA密钥对（平台生成或自行生成上传公钥）
4. 下载商户私钥（妥善保管，仅展示一次）和拉卡拉公钥
5. 配置API密钥（用于接口签名）
6. 记录商户号、私钥、公钥，用于后续开发
3.5 3.5 第五步：配置开发参数
1. 配置回调地址（支付结果异步通知URL，需HTTPS）
2. 配置IP白名单（仅指定IP可调用API，提升安全）
3. 配置支付场景（APP/小程序/H5/JSAPI/扫码等）
4. 配置分账规则（如开通分账产品）
5. 下载对应语言SDK（Java/Python/Go/PHP）
图2：多渠道支付聚合平台（商户号统一管理多支付渠道）
4. 沙箱联调与上线
4.1 4.1 沙箱环境配置
• 沙箱地址：sandbox-api.lakala.com
• 沙箱商户号：开通后自动分配，与生产商户号不同
• 沙箱密钥：独立的沙箱RSA密钥，与生产隔离
• 模拟支付：提供微信/支付宝/银联模拟支付，无需真实资金
• 测试工具：沙箱后台提供模拟支付、模拟退款、回调测试、日志查询
4.2 4.2 接口联调步骤
1. 使用沙箱商户号和密钥配置SDK
2. 对接统一下单接口，测试各支付场景（APP/小程序/H5/扫码）
3. 使用沙箱模拟支付工具完成支付，验证回调通知
4. 对接订单查询、订单关闭接口
5. 对接退款申请、退款查询接口
6. 对接对账文件下载接口，验证对账数据
7. 如开通分账，对接分账下单、分账查询接口
8. 完成全场景测试，确保功能正常
4.3 4.3 上线前检查
• 功能测试：所有接口功能正常，支付、退款、分账、回调、对账全流程通过
• 安全检查：HTTPS配置、RSA签名正确、IP白名单配置、敏感数据加密
• 异常处理：网络超时、支付失败、回调失败、退款失败等异常场景处理
• 性能测试：接口响应时间、并发能力满足业务需求
• 生产配置：切换生产商户号和密钥，配置生产回调地址和IP白名单
4.4 4.4 切换生产上线
1. 在开放平台提交"上线申请"，填写上线信息
2. 拉卡拉技术审核接口对接质量和安全规范
3. 审核通过（1-2工作日），生产环境开通
4. 切换生产配置（商户号、私钥、API地址）
5. 生产环境小流量测试（小额真实支付验证）
6. 验证通过后全量上线
图3：聚合支付超级连接器（商户号对接多渠道支付与管理后台）
5. 常见问题FAQ
5.1 Q1：API商户号申请需要多长时间？
A：标准流程3-5个工作日：①注册账号和实名认证1-2工作日；②开通支付产品1-3工作日；③获取商户号和密钥即时。个体工商户材料简单，通常1-3工作日。如涉及特殊行业需补充资质，或材料有问题需补充，时间会延长。建议提前准备好所有材料，确保一次通过审核。
5.2 Q2：个人可以申请API商户号吗？
A：纯个人（无营业执照）无法申请API商户号。需注册个体工商户（可线上办理，1-3工作日下证）后，以个体工商户身份申请。个体工商户申请材料简单（营业执照+经营者身份证+个人银行卡），审核1-3工作日，无需对公账户。如业务量较大，建议注册企业，享受更高额度和更规范的财务处理。
5.3 Q3：没有对公账户可以申请吗？
A：企业商户原则上需要对公账户，但小微企业可申请使用法定代表人个人借记卡作为结算账户，需提供法人结算授权书（加盖公章）和法人人脸识别。个体工商户可直接使用经营者个人银行卡，无需对公账户。建议业务规范后开立对公账户，便于财务管理和税务合规。对公账户开立需3-7工作日，可在申请商户号同时办理。
5.4 Q4：商户号和API密钥怎么获取？
A：支付产品开通后，登录拉卡拉开放平台→开发配置→商户信息，可查看生产商户号和沙箱商户号。在"密钥管理"中生成RSA密钥对（平台生成或自行生成上传公钥），下载商户私钥（仅展示一次，务必妥善保管）和拉卡拉公钥。API密钥用于接口签名，配置在SDK中。如私钥丢失，需重新生成并更新配置，旧密钥立即失效。
5.5 Q5：沙箱环境和生产环境有什么区别？
A：①地址不同：沙箱sandbox-api.lakala.com，生产api.lakala.com；②商户号不同：沙箱和生产各有独立商户号；③密钥不同：各自独立的RSA密钥；④资金不同：沙箱使用模拟支付，无真实资金流转；⑤功能相同：接口规范和功能完全一致，便于无缝切换。开发阶段全程使用沙箱，测试通过后切换生产。沙箱完全免费，无调用次数限制。
5.6 Q6：回调地址怎么配置？有什么要求？
A：在开放平台→开发配置→回调地址中配置，支付结果异步通知URL。要求：①必须是HTTPS协议；②公网可访问（不能是内网地址）；③返回"success"字符串表示接收成功，否则系统会重试（最多8次，15秒至1小时递增）；④需验证回调签名（使用拉卡拉公钥验签），确保通知来源可信；⑤可配置多个回调地址（主备）。建议在沙箱环境充分测试回调接收和验签逻辑。
5.7 Q7：IP白名单必须配置吗？
A：建议配置，可大幅提升API安全性。配置后仅白名单内的IP可调用API，防止密钥泄露后被恶意调用。配置方式：开放平台→开发配置→IP白名单，添加服务器公网IP（支持单个IP和CIDR网段）。如服务器IP不固定（如云函数、容器），可使用固定出口IP或代理服务器。如不配置IP白名单，任何持有密钥的IP均可调用，存在安全风险。
5.8 Q8：一个企业可以申请多个商户号吗？
A：可以。一个企业主体可申请多个商户号，用于不同业务线、不同APP、不同品牌隔离。每个商户号独立结算、独立对账、独立密钥。申请方式：在开放平台→商户管理→新增商户，提交业务场景说明，审核1-2工作日。建议按业务线拆分商户号，便于财务核算和风险隔离。商户号数量无硬性限制，但需每个商户号有真实业务场景。
6. 总结
|
API商户号申请速查表： • 申请条件：企业/个体工商户营业执照，纯个人不可申请 • 企业材料：营业执照+法人身份证+对公账户（或法人私卡+授权书）+经营证明 • 个体户材料：营业执照+经营者身份证+个人银行卡 • 审核时效：企业3-5工作日，个体户1-3工作日 • 申请流程：注册→实名认证→开通产品→获取商户号密钥→配置参数→沙箱联调→上线 • 密钥：RSA2密钥对，商户私钥签名，拉卡拉公钥验签 • 沙箱：免费，模拟支付，完整功能，与生产隔离 • SDK：Java/Python/Go/PHP多语言支持 • 安全：HTTPS+RSA签名+IP白名单+敏感加密 • 多商户号：支持，按业务线隔离，独立结算 |
拉卡拉API支付接口商户号申请全程在线完成，企业商户需营业执照、法人身份证、对公账户（或法人私卡+授权书）、经营场景证明，个体工商户需营业执照、经营者身份证、个人银行卡，纯个人不可申请。申请流程：注册开放平台→企业实名认证（1-2工作日）→开通支付产品（1-3工作日）→获取商户号和RSA密钥→配置回调地址和IP白名单→沙箱环境联调（免费，模拟支付）→上线审核（1-2工作日）→切换生产。全程3-5工作日，技术对接5-7工作日可完成。提供Java/Python/Go/PHP多语言SDK和完善的开发文档，沙箱环境与生产完全隔离，确保开发安全。建议提前准备好所有材料，配置好IP白名单和回调验签，确保一次通过审核和安全检查。
