小程序调起支付API
更新时间:2025.08.07小程序调起支付数据签名字段列表:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 | 
|---|---|---|---|---|---|
| 小程序ID | appId | 是 | String | wxd678efh567hg6787 | 微信分配的小程序ID | 
| 时间戳 | timeStamp | 是 | String | 1490840662 | 时间戳从1970年1月1日00:00:00至今的秒数,即当前的时间 | 
| 随机串 | nonceStr | 是 | String | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串,不长于32位。推荐随机数生成算法 | 
| 数据包 | package | 是 | String | prepay_id=wx2017033010242291fcfe0db70013231072 | 统一下单接口返回的 prepay_id 参数值,提交格式如:prepay_id=wx2017033010242291fcfe0db70013231072 | 
| 签名方式 | signType | 是 | String | MD5 | 签名类型,默认为MD5,支持HMAC-SHA256和MD5。注意此处需与统一下单的签名类型一致 | 
举例如下:
详细签名算法请参考“签名算法”说明
调用wx.requestPayment(OBJECT)发起微信支付
接口名称: wx.requestPayment,详见小程序API文档
Object参数说明:
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| timeStamp | String | 是 | 时间戳从1970年1月1日00:00:00至今的秒数,即当前的时间 | 
| nonceStr | String | 是 | 随机字符串,长度为32个字符以下。 | 
| package | String | 是 | 统一下单接口返回的 prepay_id 参数值,提交格式如:prepay_id=* | 
| signType | String | 是 | 签名类型,默认为MD5,支持HMAC-SHA256和MD5。注意此处需与统一下单的签名类型一致 | 
| paySign | String | 是 | 签名,具体签名方案参见微信公众号支付帮助文档; | 
| success | Function | 否 | 接口调用成功的回调函数 | 
| fail | Function | 否 | 接口调用失败的回调函数 | 
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 
回调结果:
| 回调类型 | errMsg | 说明 | 
|---|---|---|
| success | requestPayment:ok | 调用支付成功 | 
| fail | requestPayment:fail cancel | 用户取消支付 | 
| fail | requestPayment:fail (detail message) | 调用支付失败,其中 detail message 为后台返回的详细失败原因 | 
示例代码:

