注意: 支付密钥 Key 是验证商户唯一性的安全标识,请妥善保管,仅保留在第三方后 台和微信后台,不会在网络中传播。
1.3.支付方式
JS API(网页内)支付:是指用户打开图文消息或者扫描二维码,在微信内置浏览器
打开网页进行的支付。商户网页前端通过使用微信提供的 JS API,调用微信支付模块。这种方 式,适合需要在商户网页进行选购下单的购买流程。
Native(原生)支付:是指商户组成符合 Native(原生)支付规则的 URL 链接,
用户 可通过在会话中点击链接或者扫描对应的二维码直接进入微信支付模块(客户端界面),即可进行支付。这种方式,适合无需选购直接支付的购买流程。跟 JSAPI 最大的区别是不经过网页调起支付。
2.支付场景介绍
2.1.网页内支付场景---JS API(网页内)支付接口
商户已有 H5 商城网站,在微信内打开网页时,可以调用微信支付完成下单购买的流程。
步骤(1):左图,商户下发图文消息或者通过自定义菜单吸引用户点击进入商户网页。
步骤(2):右图,进入商家网页,用户选择购买,完成选购流程。
微信被扫支付接口文档(结算中心-受理机构)V0.0
6
步骤(3):左图,调起微信支付控件,用户开始输入支付密码。
步骤(4):右图,密码验证通过,支付成功。商户后台得到支付成功的通知。
步骤(5):左图,返回商户页面,显示购买成功。该页面由商户自定义。 步骤(6):右图,公众号下发消息,提示发货成功。该步骤可选。
微信被扫支付接口文档(结算中心-受理机构)V0.0
7
微信公众号支付接口文档 V3.3
注意:商户也可以把商品网页的链接生成二维码,用户扫一扫打开后即可完成购买支付。
2.1.1.交互细节
以下是支付场景的交互细节,请认真阅读,并设计商户页面的逻辑: ( 1 ) 用 户 打 开 商 户 网 页 选 购 商 品 , 发 起 支 付 , 在 网 页 通 过 JavaScript 调用getBrandWCPayRequest 接口,发起微信支付请求,用户进入支付流程。
(2)用户成功支付点击完成按钮后,商户的前端会收到JavaScript 的返回值。商户可直接跳转到支付成功的静态页面进行展示。
(3)商户后台收到来自微信开放平台的支付成功回调通知,标志该笔订单支付成功。
注:
(2)和(3)的触发不保证遵循严格的时序。JS API 返回值作为触发商户网页跳转的标 志,但商户后台应该只在收到微信后台的支付成功回调通知后,才做真正的支付成功的处理。
JS API 返回值目前只在支付成功时返回,后续版本将扩展返回值,以便商户做更多
个性化的展示。
微信被扫支付接口文档(结算中心-受理机构)V0.0
8
微信公众号支付接口文档 V3.3
2.1.2.JSAPI 支付时序图
2.1.3.获取当前微信版本号
由于微信 5.0 版本后才加入微信支付模块,低版本用户调用微信支付功能将无效。因此, 建议商户通过 user agent 来确定用户当前的版本号后再调用支付接口。以 iPhone 版本为例, 可以通过 user agent 可获取如下微信版本示例信息:
\ Geocko) Mobile/9B206 MicroMessenger/5.0\
其中 5.0 为用户安装的微信版本号,商户可以判定版本号是否高于或者等于 5.0。
2.1.4.显示微信安全支付标题
对于商户具有支付权限且需要调用微信支付的页面,为了让用户增加购买信心,确认交易环境安全,微信强烈建议商户使用“微信安全支付”标题。安全支付标题的如下图。
微信被扫支付接口文档(结算中心-受理机构)V0.0
9
微信公众号支付接口文档 V3.3
显示支付安全标题,需将原始链接添加上\的尾串。通过这种方式, 商户的页面将出现微信安全支付的标识。例如,原始 URL 为:htp://weixin.qq.com,显示安全 支付标题的 URL 为:htp://weixin.qq.com?showwxpaytitle=1。
当用户在微信里打开 http://weixin.qq.com不会直接出现微信安全支付的标题,而打开 htp://weixin.qq.com?showwxpaytitle=1后将出现微信安全支付标题。
2.2.线下扫码购买场景---Native(原生)支付接口
2.2.1 使用场景
与网页内支付场景不同,部分商户不需要经过网页选购,可以直接下单购买。 步骤(1):左图,商户根据微信支付的规则,为不同商品生成不同的二维码,张贴在各种场景,便于用户扫描购买。
步骤(2):右图,用户使用微信扫描二维码后,获取商品信息,同时到商户后台下单。
步骤(3):左图,用户开始支付,输入支付密码。
微信被扫支付接口文档(结算中心-受理机构)V0.0
10