拉卡拉支付设置

一、拉卡拉商户开通

拉卡拉聚合收单支持微信、支付宝等主流支付方式，可覆盖 PC、H5、公众号、小程序等场景。使用前需先完成拉卡拉商户入网与开放平台应用开通。

开通入口：

拉卡拉开放平台：https://o.lakala.com（或 open.lakala.com）
拉卡拉商户平台：由拉卡拉开通后提供登录入口

注意事项：

需联系拉卡拉商务/对接人员完成商户进件，并确认线上商城所需支付能力（微信、支付宝等）已开通。
商户号（merchantNo）、终端号（termNo）一般随进件结果一并下发。
商户证书与私钥需使用拉卡拉提供的密钥/证书工具自行生成，私钥仅本地保存，切勿外泄。
APP 内支付场景需与拉卡拉单独联调确认后再启用，本文覆盖的是 PC、H5、公众号、小程序场景。

二、申请与获取对接参数

1. 开放平台应用

登录拉卡拉开放平台 →【应用管理】，创建或查看应用。
获取开放平台 AppId。
在应用详情中下载平台公钥证书（.cer），用于验签。

2. 商户与终端信息

在拉卡拉商户平台获取：

商户号（merchantNo）：【商户信息】中查看
终端号（termNo）：【终端管理】中查看

3. 商户证书与私钥

使用拉卡拉密钥/证书生成工具生成商户证书与私钥。
记录证书序列号（serialNo）（也可用 OpenSSL 查看 .cer 的 serial）。
保存商户私钥（PKCS8 Base64），后续粘贴到商城后台。

4. 微信相关参数（按场景选填）

场景	需要配置的参数	说明
微信公众号内 H5 / JSAPI	微信子 AppId	公众号 AppID，且需在拉卡拉侧完成绑定
微信小程序	微信小程序 AppId	小程序 AppID，且需在拉卡拉侧完成绑定
PC / 普通 H5 微信	可不填上述 AppId	走拉卡拉聚合收银台跳转，非直连主扫二维码

5. 网关与环境

环境	网关示例	说明
生产	https://s2.lakala.com	真实收款，上线前务必使用
沙箱/测试	https://test.wsmsd.cn/sit	仅联调，勿与生产混用

具体地址以拉卡拉最新对接文档为准：https://o.lakala.com/#/home/document

注意：环境由网关地址唯一决定：后台的「环境（生产/沙箱）」选项目前仅作为后台标记，不参与请求路由；系统实际请求哪个环境，完全取决于「网关地址」填的是哪个。切换环境时必须修改网关地址，只切环境选项不会生效。

注意：网关地址不要留空：留空时系统会自动使用生产网关 https://s2.lakala.com。沙箱联调若忘填网关，会直接请求生产环境并产生真实交易。

SM4 密钥：若已开通报文对称加密，由拉卡拉提供；未开通可留空。

三、商城后台配置

1. 是否开启

选择「开启」后，收银台展示「拉卡拉微信」「拉卡拉支付宝」两个选项；关闭则不展示。

注意：请先把下方全部参数填写并提交，再打开「是否开启」。该开关仅控制收银台是否展示拉卡拉选项，不会校验参数是否填全；参数不完整时用户仍能看到拉卡拉微信 / 拉卡拉支付宝，但点击支付会直接失败。

2. 填写基础参数

依次填写：

开放平台 AppId
商户号
终端号
证书序列号
网关地址：决定实际请求环境，生产填 https://s2.lakala.com，联调填沙箱地址；不可留空
环境：生产 / 沙箱（仅后台标记，不影响请求走向；请与上方网关地址保持一致，避免误判）

3. 配置密钥与证书

商户私钥：点击「编辑」，粘贴 PKCS8 Base64 私钥全文。
平台证书：点击「编辑」，粘贴 .cer 文件全部内容（含 BEGIN/END 行）。
SM4 密钥：已开通则填写，未开通留空。

如无需更换密钥，保持页面掩码内容原样提交即可，系统不会覆盖已保存的真实值（私钥、平台证书、SM4 密钥三项均为掩码回显）。

4. 填写微信支付参数（按需）

需要公众号内支付：填写「微信子 AppId」
需要小程序支付：填写「微信小程序 AppId」
仅 PC/H5 聚合收银台：可不填

确认无误后点击「提交」。

回调说明：

支付与退款通知共用同一地址，一般为：https://您的PC域名/api/order/pay/notify/lakala
请确保该地址可被公网访问，并在服务器防火墙/安全组中放行
退款为同步受理：后台发起退款后，拉卡拉同步返回受理成功即回写为退款成功，无需额外配置退款回调地址

常见问题

问：开启后收银台没有拉卡拉选项？

答：1. 确认「是否开启」已开启并提交成功——收银台是否展示拉卡拉，只取决于这一个开关。
2. 「拉卡拉支付宝」在微信内置浏览器、小程序中不会展示，只剩「拉卡拉微信」，属正常现象。
3. 若开关确认已开启仍不显示，请清理前端缓存后重新进入收银台，并确认访问的是已保存配置的同一环境。

问：能看到拉卡拉选项，但点击支付提示「拉卡拉支付未配置或配置不完整」？

答：开关只控制展示、不校验参数，因此参数没填全时选项照样显示，点击支付才报错。
出现该提示说明开放平台 AppId、证书序列号、商户私钥、平台证书四项中至少一项为空，请补全后重新提交。
注意另外两类情况表现不同：商户号、终端号缺失不会触发这条提示，而会在下单时报「拉卡拉请求失败：xxx」；网关地址留空不会报错，会静默使用生产网关。

问：PC / H5 选择拉卡拉微信后跳转到第三方页面？

答：正常。拉卡拉微信在 PC/H5 没有直连主扫二维码，系统会返回聚合收银台 URL，由拉卡拉页面完成支付；小程序 / 公众号内仍按微信 JSAPI 拉起。
拉卡拉支付宝的行为与微信不同，走的是直连下单：PC 端直接展示支付宝二维码，H5 端跳转支付宝完成支付，不经过聚合收银台。因此同一台设备上「拉卡拉微信跳第三方页面、拉卡拉支付宝出二维码」属预期表现。

问：小程序或公众号内支付失败？

答：1. 确认已填写对应的「微信小程序 AppId」或「微信子 AppId」。
2. 确认该 AppId 已在拉卡拉侧完成绑定，且与当前商城使用的微信账号一致。
3. 确认用户已完成微信授权登录（公众号场景需要 openid）。

问：提示验签失败或证书错误？

答：1. 平台证书请粘贴完整 .cer 内容，不要只贴中间一段。
2. 证书序列号须与当前商户证书一致。
3. 沙箱与生产的证书、AppId 不可混用，且必须与「网关地址」指向的环境一致——环境不匹配是验签失败最常见的原因。

问：支付成功但订单未变成已支付？

答：1. 检查商城「PC 域名」是否正确（回调地址依赖该域名生成）。
2. 确认 /api/order/pay/notify/lakala 外网可访问。
3. 到拉卡拉商户/开放平台查看交易与通知日志，核对通知是否发送成功。