---
url: "https://pay.weixin.qq.com/doc/v2/merchant/4011937148.md"
title: "调起支付接口"
doc_id: 4011937148
---

>更新时间：2026.04.03

## 应用场景

APP端调起支付的参数列表

## 接口链接

无

## 是否需要证书

否

## 请求参数

| 字段名 | 变量名 | 类型 | 必填 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 应用ID | appid | String(32) | 是 | wx8888888888888888 | 微信开放平台审核通过的应用APPID（请登录open.weixin.qq.com查看，注意与公众号的APPID不同） |
| 商户号 | partnerid | String(32) | 是 | 1900000109 | 微信支付分配的商户号 |
| 预支付交易会话ID | prepayid | String(64) | 是 | wx1217752501201407033233368018 | 微信返回的支付交易会话ID |
| 扩展字段 | package | String(128) | 是 | Sign=WXPay | 暂填写固定值Sign=WXPay |
| 随机字符串 | noncestr | String(32) | 是 | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串，不长于32位。推荐[随机数生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md) |
| 时间戳 | timestamp | String(10) | 是 | 1412000000 | 时间戳，请见[接口规则-参数规定](https://pay.weixin.qq.com/doc/v2/merchant/4011941162.md) |
| 签名 | sign | String(64) | 是 | C380BEC2BFD727A4B6845133519F3AD6 | 签名，详见[签名生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md)注意：签名方式一定要与统一下单接口使用的一致 |

签名举例如下，详细参考[签名生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md)：

```
//key：商户平台设置的apiv2密钥，可参考该文档设置：https://kf.qq.com/faq/180830UVRZR7180830Ij6ZZz.html
stringSignTemp = "appid=wxd678efh567hg6787&noncestr=5K8264ILTKCH16CQ2502SI8ZNMTM67VS&package=Sign=WXPay&partnerid=1900000109&prepayid=wx1217752501201407033233368018&timestamp=1490840662&key=qazwsxedcrfvtgbyhnujmikolp111111"

//MD5签名方式
sign = MD5(stringSignTemp).toUpperCase() = "DE9B6A17F5B8391FFE5272E89F33BEE2"

//HMAC-SHA256签名方式，部分语言的hmac方法生成结果二进制结果，需要调对应函数转化为十六进制字符串
sign = hash_hmac("sha256",stringSignTemp,key).toUpperCase()="51B65BA79A8F528381EE66E21C67DA037F435AB7F032BC6EA9E06B3BC8D88DB3"
```

调起支付举例参考：[APP端开发说明](https://pay.weixin.qq.com/doc/v2/merchant/4011936836.md)

## 返回结果

| 名称 | 描述 | 解决方案 |
| --- | --- | --- |
| 0 | 成功 | 展示成功页面 |
| -1 | 错误 | 可能的原因：签名错误、未注册APPID、项目设置APPID不正确、注册的APPID与设置的不匹配、其他异常等。 |
| -2 | 用户取消 | 无需处理。发生场景：用户不支付了，点击取消，返回APP。 |