JSAPI调起支付
更新时间:2025.02.26商户通过JSAPI/小程序下单接口获取到发起支付的必要参数prepay_id后,再通过微信浏览器内置对象方法(WeixinJSBridge)调起微信支付收银台。
接口说明
支持商户:【普通商户】
字段说明
请求参数
此API签名无后台接口交互,需要将列表中的数据签名
appId
必填 string(32)
填写下单时传入的appid,且必需与当前实际调起支付的公众号appid一致,否则无法调起支付。
timeStamp
必填 string(32)
Unix 时间戳,是从1970年1月1日(UTC/GMT的午夜)开始所经过的秒数。
注意:常见时间戳为秒级或毫秒级,该处必需传秒级时间戳。
nonceStr
必填 string(32)
随机字符串,不长于32位。该值建议使用随机数算法生成。
package
必填 string(128)
订单详情扩展字符串,JSAPI下单接口返回的prepay_id参数值,提交格式如:prepay_id=***。
signType
必填 string(32)
签名类型,固定填RSA。
paySign
必填 string(256)
签名,使用字段appId、timeStamp、nonceStr、package计算得出的签名值 注意:取值RSA格式。详细参考JSAPI调起支付签名
请求示例
示例代码:
返回结果值说明
用户从微信收银台返回商户页面时会触发商户调用onBridgeReady拉起支付时传入的function回调方法,商户可通过回调err_msg参数展示相应支付结果。
注:前端回调并不保证它绝对可靠,不可只依赖前端回调判断订单支付状态,订单状态需以后端查询订单和支付成功回调通知为准。
err_msg返回值 | 返回值说明 |
---|---|
get_brand_wcpay_request:ok | 调用后端接口查单,如果订单已支付则展示支付成功页面。 |
get_brand_wcpay_request:cancel | 用户取消支付,商户可自行处理展示。 |
get_brand_wcpay_request:fail | 支付失败,展示订单支付失败结果。 |