无卡绑卡API(支持扫码模式)

更新时间:2024.12.25

# 一、接入方案

  1. 银行系统根据微信支付规定格式生成二维码(如下文),展示给用户扫码。
  2. 用户打开微信“扫一扫”扫描二维码,微信客户端将扫码内容发送到微信支付系统。
  3. 微信支付系统收到客户端请求,发起鉴权。
  4. 鉴权成功返回银行页面信息
  5. 用户点击下一步复用无卡绑卡剩余流程,可兼容

# 二、二维码生成

二维码中的内容为链接,形式为:"weixin://wxpay/bindurl?bank_type=XXXXX&scene=x"

# param部分的信息如下

  • bank_type 必填 string(32)
    银行信息。参照银行字符信息
  • scene 必填 int
    银行场景值(银行侧传入,用于区分绑卡来源),为整型,支持最长18位的整型数 ,0为缺省值
    注:900000000000000000(即9+17个0)~999999999999999999 (即18个9)这个范围内的值不可作为场景值

# 三、常见问题

# Q:是不是所有银行都可以扫码绑卡?

A:目前只支持已上线免输卡号能力的银行做扫码绑卡能力

# Q:二维码如何生成?

A:按文档规则生成链接后,银行可自行在第三方平台生成二维码

# Q:二维码是否有有效期?

A:链接无有效期,永久有效。二维码是否有有效期以第三方平台为准

# Q:如何区分场景值?

A:见"scene"字段,银行可自定义场景值传入,用于区分绑卡来源

# Q:对应场景值的绑卡成功量级去哪里查?

A:银行无法查询,目前只能通过微信侧做异步查询。可与对应的运营同学先做沟通。

# Q:是否有绑卡成功事件回调?

A:暂无,银行可内部自行查询用户是否已绑定银行卡

微信支付文档中心已升级,你当前所查看的是旧文档中心的内容,旧文档中心将于 2025年 3 月 31日 下线,请移步 [新文档中心] 查看相应的内容