---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012166847.md"
title: "小程序调起支付"
doc_id: 4012166847
---

>更新时间：2025.01.16

服务商通过[小程序合单下单](https://pay.weixin.qq.com/doc/v3/partner/4012758246.md)接口获取到发起支付的必要参数 `prepay_id`，然后使用小程序提供的[requestPayment](https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html)方法调起微信支付收银台。

注意

若为交易类小程序，需要满足公众平台的《[交易类小程序运营规范](https://developers.weixin.qq.com/miniprogram/product/jiaoyilei/yunyingguifan.html)》，按照规范接入[订单发货管理功能](https://developers.weixin.qq.com/miniprogram/product/jiaoyilei/fahuoguanligongneng.html)，若不满足，可能被公众平台限制使用小程序进行支付的权限，无法在正式环境下调起小程序合单支付。



## 接口说明

支持商户：【普通服务商】

## 字段说明

### 调用wx.requestPayment(OBJECT)发起微信支付

接口名称： wx.requestPayment，详见[小程序API文档](https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html)

Object请求参数说明

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| timeStamp | string(32) | true | 【时间戳】标准北京时间，时区为东八区，自1970年1月1日 0点0分0秒以来的秒数。注意：部分系统取到的值为毫秒级，商户需要转换成秒(10位数字)。 |
| nonceStr | string(32) | true | 【随机字符串】不长于32位。该值建议使用随机数算法生成。 |
| package | string(128) | true | 【预支付交易会话标识】[小程序合单下单](https://pay.weixin.qq.com/doc/v3/partner/4012758246.md)接口返回的 `prepay_id` 参数值，提交格式如： `prepay_id=***` |
| signType | string(32) | true | 【签名类型】默认为RSA，仅支持RSA。 |
| paySign | string(256) | true | 【签名值】使用字段 `appid`、 `timeStamp`、 `nonceStr`、 `package` 计算得出的签名值，详细参考：[小程序调起支付签名](https://pay.weixin.qq.com/doc/v3/partner/4012365869.md)<br>注意：签名所使用的 `appid`，为【[小程序合单下单](https://pay.weixin.qq.com/doc/v3/partner/4012758246.md)】时传入的combine\_appid或 `sub_appid`，微信支付会校验下单与调起支付所使用的 `appid` 的一致性。 |

请求示例

```
wx.requestPayment
(
  {
    "timeStamp": "1414561699",
    "nonceStr": "5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
    "package": "prepay_id=wx201410272009395522657a690389285100",
    "signType": "RSA",
    "paySign": "oR9d8PuhnIc+YZ8cBHFCwfgpaK9gd7vaRvkYD7rthRAZ\/X+QBhcCYL21N7cHCTUxbQ+EAt6Uy+lwSN22f5YZvI45MLko8Pfso0jm46v5hqcVwrk6uddkGuT+Cdvu4WBqDzaDjnNa5UK3GfE1Wfl2gHxIIY5lLdUgWFts17D4WuolLLkiFZV+JSHMvH7eaLdT9N5GBovBwu5yYKUR7skR8Fu+LozcSqQixnlEZUfyE55feLOQTUYzLmR9pNtPbPsu6WVhbNHMS3Ss2+AehHvz+n64GDmXxbX++IOBvm2olHu3PsOUGRwhudhVf7UcGcunXt8cqNjKNqZLhLw4jq\/xDg==",
    "success":function(res){},
    "fail":function(res){},
    "complete":function(res){}
  }
)
```

### 回调结果

| 回调类型 | errMsg | 说明 |
| --- | --- | --- |
| success | requestPayment:ok | 调用支付成功 |
| fail | requestPayment:fail cancel | 用户取消支付 |
| fail | requestPayment:fail (detail message) | 调用支付失败，其中 `detail message` 为后台返回的详细失败原因 |