开发指引

更新时间:2024.12.27

# 1. 接口规则

为了在保证支付安全的前提下,带给商户简单、一致且易用的开发体验,我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考APIv3接口规则

# 2. 开发准备

# 2.1. 搭建和配置开发环境

开发者应当依据自身的编程语言来构建并配置相应的开发环境。

# 3. 快速接入

# 业务流程图

示例图

重点步骤说明:

步骤2: 用户发起免输卡号绑卡后,微信携带身份信息、已绑定卡尾号、sessionid参数跳转银行小程序/H5,银行小程序展示可绑定卡供用户选择;

步骤5: 用户选择卡绑定后,需通过网联发起一键绑卡,详细介绍如下:

特别说明:

  1. 免输卡号绑卡,在网联一键绑卡基础上实现,银行需先对接网联一键绑卡,并在此基础上进行开发,接入免输卡号绑卡。一键绑卡接入文档地址为:《财付通一键绑卡接入流程与FAQ》 (opens new window)
  2. 在一键绑卡基础上,免输卡号绑卡特殊实现点

注意

传输的整体字段需要做URLEncode

  • 财付通-微信跳转银行选卡页(小程序/H5)地址,需要在接入时给出,财付通-微信会按照给到的固定地址转跳

    从微信页面跳转到银行小程序/H5页面时,微信会将用户【证件号+姓名+已绑定银行卡的卡尾号+sessionid】传给银行。
    
  • 发起一键绑卡时,在网联“回跳地址”字段,需要传特定的值以及微信支付的sessionid,使微信可识别为免输卡号绑卡场景,并标识特定用户。格式如:【bind_scene=NO_CARD_BIND&sessionid=1279e90sdfahjkfdgfsd89】。

  • 一键绑卡财付通-后台回执报文, 不会返回回跳地址,回跳地址字段传【NO_CARD_BIND】,银行需要按照《跳转微信验短页面API》 (opens new window),跳回微信支付

  • 从银行小程序/H5跳回微信验短页面时,需要将sessionid传给财付通-微信。

反馈
咨询
目录

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