应用场景

在移动支付时代，扫码支付已成为商家收款的核心方式之一。拉卡拉作为国内领先的第三方支付机构，提供稳定、高效的聚合扫码支付解决方案，支持微信、支付宝、银联等多种支付方式。本文将详细介绍如何在小程序中接入拉卡拉扫码支付（主扫模式），并提供完整的API对接流程和代码示例，帮助开发者快速实现支付功能。

一、拉卡拉扫码支付（主扫）的优势

1. 什么是主扫支付？

主扫支付是指商户生成收款码，用户主动扫码完成支付，适用于线下门店、自助终端等场景。相比被扫支付（用户出示付款码），主扫支付更灵活，适用于固定收款场景。

2. 拉卡拉扫码支付的核心优势

✅ 多码合一：一个二维码支持微信、支付宝、银联等多种支付方式
✅ 高并发稳定：支持海量交易，支付成功率99.9%+
✅ 快速到账：支持T+0、T+1结算，资金秒到商户账户
✅ 风控保障：实时交易监控，防止欺诈交易
✅ 低费率：相比单独对接微信/支付宝，拉卡拉聚合支付费率更低

二、拉卡拉扫码支付接入前准备

在对接拉卡拉扫码支付前，需完成以下准备工作：

1. 注册拉卡拉商户账号

• 访问拉卡拉官网注册商户账号

• 提交企业资质（营业执照、法人身份证等）完成认证

• 申请开通扫码支付功能

2. 获取API密钥和商户号

• 登录拉卡拉商户后台，获取：

• 商户号（mch_id）

• API密钥（api_key）

• APPID（若对接小程序）

3. 配置支付回调地址

• 在商户后台设置支付结果通知URL（用于接收支付成功/失败回调）

三、小程序对接拉卡拉扫码支付（主扫）完整流程

1. 生成拉卡拉支付二维码

商户需调用拉卡拉API生成支付二维码，用户扫码后完成支付。

（1）请求参数示例（JSON）

（2）调用拉卡拉生成二维码API

（3）返回结果示例

2. 小程序端展示二维码并监听支付结果

在小程序端，需将拉卡拉返回的qr_code生成二维码供用户扫码支付。

（1）微信小程序生成二维码（WXML）

（2）JavaScript轮询支付状态

3. 处理拉卡拉支付回调（后端逻辑）

支付成功后，拉卡拉会向notify_url发送异步通知，需验证签名并更新订单状态。

四、拉卡拉扫码支付常见问题

Q1：拉卡拉扫码支付支持哪些支付方式？

A：支持微信、支付宝、银联二维码，可单独指定或由用户选择。

Q2：支付回调没有收到怎么办？

A：检查notify_url是否配置正确，并确保服务器能正常接收POST请求。

Q3：如何测试扫码支付？

A：拉卡拉提供沙箱环境，可使用测试商户号进行联调。

Q4：交易限额是多少？

A：微信/支付宝单笔限额5万元，具体以银行规定为准。

五、总结

通过拉卡拉扫码支付（主扫）接口，小程序可快速实现多码合一的聚合支付功能，提升用户体验和交易转化率。本文提供了完整的API对接流程、代码示例和常见问题解答，帮助开发者高效完成接入。