微信支付签约委托代扣文档 - 月付会员或者定期支付服务 - APP纯签约
1. APP纯签约-预签约接口
预签约接口用于生成签约页面的参数，帮助开发者快速实现签约流程。该接口返回一个 JSON 对象，包含了签约页面所需的所有参数。
请求方式: GET请求地址: ` 参数名称 | 必填 | 类型 |说明 |
| --- | --- | --- | --- |
| mch_billno | 是 | String(32) | 商户订单号 |
| bill_date | 是 | String(8) |交易时间 |
| notify_url | 否 | String(256) | 回调地址 |
| sign_type | 否 | String(16) | 签名类型 |
| partner_id | 否 | String(32) | 商户ID |
请求示例:
```bashGET /mmpaymktmktqrysign?mch_billno=123456789012345678&bill_date=20220101¬ify_url= HTTP/1.1```
返回参数:
| 参数名称 | 类型 |说明 |
| --- | --- | --- |
| mch_billno | String(32) | 商户订单号 |
| bill_date | String(8) |交易时间 |
| notify_url | String(256) | 回调地址 |
| sign_type | String(16) | 签名类型 |
| partner_id | String(32) | 商户ID |
| timestamp | Integer | 时间戳 |
| nonce_str | String(32) | 随机字符串 |
返回示例:
```json{
"mch_billno": "123456789012345678",
"bill_date": "20220101",
"notify_url": " "sign_type": "MD5",
"partner_id": "1234567890",
"timestamp":1643723400,
"nonce_str": "abc123"
}
```
2. 接口调用请求说明
在使用预签约接口后，开发者需要将返回的 JSON 对象中的参数传递给签约接口。签约接口用于生成签约页面，并且会向微信支付服务器发送签约请求。
请求方式: POST请求地址: ` 参数名称 | 必填 | 类型 |说明 |
| --- | --- | --- | --- |
| mch_billno | 是 | String(32) | 商户订单号 |
| bill_date | 是 | String(8) |交易时间 |
| notify_url | 否 | String(256) | 回调地址 |
| sign_type | 否 | String(16) | 签名类型 |
| partner_id | 否 | String(32) | 商户ID |
| timestamp | 是 | Integer | 时间戳 |
| nonce_str | 是 | String(32) | 随机字符串 |
请求示例:
```bashPOST /mmpaymktmktqrysign HTTP/1.1Content-Type: application/json{
"mch_billno": "123456789012345678",
"bill_date": "20220101",
"notify_url": " "sign_type": "MD5",
"partner_id": "1234567890",
"timestamp":1643723400,
"nonce_str": "abc123"
}
```
3. 请求参数
| 参数名称 | 必填 | 类型 |说明 |
| --- | --- | --- | --- |
| mch_billno | 是 | String(32) | 商户订单号 |
| bill_date | 是 | String(8) |交易时间 |
| notify_url | 否 | String(256) | 回调地址 |
| sign_type | 否 | String(16) | 签名类型 |
| partner_id | 否 | String(32) | 商户ID |
4. 请求示例
```bashPOST /mmpaymktmktqrysign HTTP/1.1Content-Type: application/json{
"mch_billno": "123456789012345678",
"bill_date": "20220101",
"notify_url": " "sign_type": "MD5",
"partner_id": "1234567890"
}
```
5. 返回参数
| 参数名称 | 类型 |说明 |
| --- | --- | --- |
| mch_billno | String(32) | 商户订单号 |
| bill_date | String(8) |交易时间 |
| notify_url | String(256) | 回调地址 |
| sign_type | String(16) | 签名类型 |
| partner_id | String(32) | 商户ID |
6. 返回示例
```json{
"mch_billno": "123456789012345678",
"bill_date": "20220101",
"notify_url": " "sign_type": "MD5",
"partner_id": "1234567890"
}
```
7. 错误码
| 错误码 |说明 |
| --- | --- |
|10000 | 系统繁忙 |
|10001 | 参数错误 |
|10002 | 商户订单号重复 |
8. APP纯签约-签约接口
签约接口用于生成签约页面，并且会向微信支付服务器发送签约请求。
请求方式: POST**请求地址:** ` 参数名称 | 必填 | 类型 |说明 |
| --- | --- | --- | --- |
| mch_billno | 是 | String(32) | 商户订单号 |
| bill_date | 是 | String(8) |交易时间 |
| notify_url | 否 | String(256) | 回调地址 |
| sign_type | 否 | String(16) | 签名类型 |
| partner_id | 否 | String(32) | 商户ID |
**请求示例:**
```bashPOST /mmpaymktmktqrysign HTTP/1.1Content-Type: application/json{
"mch_billno": "123456789012345678",
"bill_date": "20220101",
"notify_url": " "sign_type": "MD5",
"partner_id": "1234567890"
}
```
**9. 接入流程**
1. 商户在微信支付平台上创建签约页面。
2. 用户点击签约按钮，生成签约请求。
3. 微信支付服务器接收签约请求，并向商户发送回调地址。
4. 商户接收回调地址，并将其传递给签约接口。
5. 签约接口生成签约页面，并且会向微信支付服务器发送签约请求。
**10. 错误处理**
如果签约接口返回错误码，则需要根据错误码进行相应的错误处理。
