微信公众平台开发(103) JS API支付

时间：2022-04-06 11:01

本文介绍如何使用JS API支付接口完成微信支付。

一、JS API支付接口（getBrandWCPayRequest）

微信JS API只能在微信内置浏览器中使用，其他浏览器调用无效。微信提供getBrandWCPayRequest接口供商户前端网页调用，调用之前微信会鉴定商户支付权限，若商户具有调起支付的权限，则将开始支付流程。这里主要介绍支付前的接口调用规则，支付状态消息通知机制请参加下文。接口需要注意：所有传入参数都是字符串类型！

getBrandWCPayRequest参数如表6-5所示。

参数	名称	必填	格式	说明
appId	公众号id	是	字符串类型	商户注册具有支付权限的公众号成功后即可获得；
timeStamp	时间戳	是	字符串类型，32个字节以下	商户生成，从1970年1月1日00:00:00至今的秒数，即当前的时间，且最终需要转换为字符串形式；
nonceStr	随机字符串	是	字符串类型，32个字节以下	商户生成的随机字符串；
package	订单详情扩展字符串	是	字符串类型，4096个字节以下	商户将订单信息组成该字符串，具体组成方案参见接口使用说明中package组包帮劣；由商户按照规范拼接后传入；
signType	签名方式	是	字符串类型，参数取值"SHA1"	按照文档中所示填入，目前仅支持SHA1；
paySign	签名	是	字符串类型	商户将接口列表中的参数按照指定方式迚行签名，签名方式使用signType中标示的签名方式，具体签名方案参见接口使用说明中签名帮劣；由商户按照规范签名后传入；

表6-5 getBrandWCPayRequest参数

getBrandWCPayRequest返回值如表6-6所示。

返回值	说明
err_msg	get_brand_wcpay_request:ok 支付成功 get_brand_wcpay_request:cancel 支付过程中用户取消 get_brand_wcpay_request:fail 支付失败

表6-6 getBrandWCPayRequest返回值

JS API的返回结果 get_brand_wcpay_request:ok 仅在用户成功完成支付时返回。由于前端交互复杂，get_brand_wcpay_request:cancel或者 get_brand_wcpay_request:fail 可以统一处理为用户遇到错误或者主动放弃，不必细化区分。