功能概述
本能力属于微信支付 付款码支付（顾客被扫，B 扫 C），不是小程序内「微信支付」按钮（JSAPI），也不是顾客扫商家收款二维码（Native）。
商家后台「门店收银」提供两种模式：商品收银（扫商品条码加购）与金额收银（直接输入金额，本文下方步骤）。
适用：门店收银台 + 扫码盒 / 扫码枪。
不适用：平台入驻且未配置独立小程序与自有商户号的商家；小程序内下单仍使用原有线上支付方式。
适用场景
| 场景 | 是否支持 |
|---|
| 门店收银台 + 扫码盒扫顾客付款码 | 支持 |
| 小程序内用户点击「微信支付」 | 不支持（走线上 JSAPI） |
| 仅平台多商户小程序、无独立资质 | 需先开通独立小程序与自有商户号 |
微信商户平台准备（商家自己的商户号）
在 微信支付商户平台 完成：
- 开通产品：付款码支付
- 绑定与小程序一致的 AppID
- 设置 APIv3 密钥（32 位，与旧版 API 密钥不是同一个）
- 上传 API 证书（apiclient_cert / apiclient_key）
- 配置 API 安全 IP 白名单（服务器公网出口 IP）
- 准备线下 门店编号（用于合规报送，可与店内编码一致）
官方接口说明：付款码支付 API v3
系统侧前置条件
- 商家已开通独立小程序，并完成小程序与支付参数配置（AppID、商户号、证书）。
- 实施人员已在服务器执行数据库补丁（付款码订单表），具体由技术支持提供。
商家后台配置步骤
- 登录商家后台 → 打开 付款码收银设置，填写 APIv3 密钥、门店编码、收银设备号。
- 打开 门店收银，选择模式：
- 商品收银：扫商品条码加购 → 确认订单 → 扫付款码（详见 商品扫码收银说明）
- 金额收银：输入本次收款金额（元）→ 扫付款码
- 使用扫码枪扫描顾客微信付款码（18 位数字，输入完成后自动发起扣款）。
- 页面提示「支付成功」后可打印小票；若显示「支付中」，请等待顾客输入密码，系统会自动查询结果。
异步通知地址需为公网 HTTPS，由系统在「付款码收银设置」页展示，请确保服务器可被微信访问。同步扣款成功时也可不依赖回调完成订单。
收款流程示意
顾客打开微信付款码
↓
扫码枪 / 收银盒（USB 键盘模式）→ 收银页获得付款码
↓
商家后台服务器 → 微信支付「付款码支付」接口
↓
同步返回：成功 / 支付中 / 失败
↓
支付中 → 自动轮询查单；微信异步通知作为兜底
支付结果说明
| 状态 | 含义 | 建议操作 |
|---|
| 支付成功 | 扣款完成 | 打小票、结束本笔收银 |
| 用户支付中 | 顾客正在输入密码等 | 等待页面自动查询，勿重复扫同一码 |
| 支付失败 | 余额不足、码过期等 | 请顾客刷新付款码后重试 |
与小程序线上支付的区别
| 能力 | 场景 | 说明 |
|---|
| 小程序微信支付 | 用户在小程序里下单支付 | 原有线上支付流程，互不影响 |
| 付款码收银 | 门店扫码盒扫顾客码 | 本文档说明的能力，需 APIv3 |
常见问题
提示未配置 APIv3 密钥？
请在「付款码收银设置」填写商户平台中的 32 位 APIv3 密钥，不是 V2 的 API 密钥。
付款码无效或扫了没反应？
确认扫码枪输入为完整 18 位数字；付款码有效期约 1 分钟，过期请顾客刷新后再扫。
签名错误或证书问题？
检查商户平台证书与后台上传的证书是否一对；证书序列号需与平台一致。
扣款成功但页面一直「支付中」？
检查服务器出口 IP 是否在白名单；回调地址是否 HTTPS 可访问。可在「收款记录」中核对订单状态。
相关入口
文档版本：2026-05 · 如有疑问请联系实施支持或平台运营。