微信服务商模式(电商收付通)合单支付API V3完整Demo
适用平台: H5、JSAPI、H5、App、小程序注意: 本示例代码仅供参考，具体实现可能需要根据实际需求进行调整。
一、前言
微信服务商模式(电商收付通)合单支付API V3是微信提供的一种新的支付接口，支持多种支付方式和场景。该接口可以用于H5、JSAPI、H5、App、小程序等平台的支付需求。
二、接口概述
微信服务商模式(电商收付通)合单支付API V3主要包括以下几个接口：
1. 统一下单接口: ` 查询订单接口: ` 关闭订单接口: ` 接口描述统一下单接口用于生成一个支付订单，用户可以通过该订单进行支付。
3.2 请求参数| 参数名称 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `appid` | String | 是 | 公众号或小程序的APPID |
| `mch_id` | String | 是 | 商户ID |
| `nonce_str` | String | 是 | 随机字符串，防止重复请求 |
| `body` | String | 是 | 商品描述 |
| `out_trade_no` | String | 是 | 商户订单号 |
| `total_fee` | Int | 是 |付款金额（分） |
| `spbill_create_ip` | String | 否 | IP地址 |
3.3 请求示例```json{
"appid": "wx1234567890",
"mch_id": "1234567890",
"nonce_str": "abc123",
"body": "测试商品",
"out_trade_no": "2023022200001",
"total_fee":100,
"spbill_create_ip": "192.168.1.1"
}
```
3.4 响应参数| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| `return_code` | String | 返回状态码 |
| `return_msg` | String | 返回信息 |
| `appid` | String | 公众号或小程序的APPID |
| `mch_id` | String | 商户ID |
| `nonce_str` | String | 随机字符串，防止重复请求 |
| `sign` | String | 签名 |
| `result_code` | String |业务结果状态码 |
| `trade_type` | String | 支付类型 |
| `prepay_id` | String | 预支付交易会话ID |
3.5 响应示例```json{
"return_code": "SUCCESS",
"return_msg": "",
"appid": "wx1234567890",
"mch_id": "1234567890",
"nonce_str": "abc123",
"sign": "abc123",
"result_code": "SUCCESS",
"trade_type": "JSAPI",
"prepay_id": "wx202302220000100000001"
}
```
四、查询订单接口
4.1 接口描述查询订单接口用于获取一个支付订单的状态。
4.2 请求参数| 参数名称 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `appid` | String | 是 | 公众号或小程序的APPID |
| `mch_id` | String | 是 | 商户ID |
| `nonce_str` | String | 是 | 随机字符串，防止重复请求 |
| `transaction_id` | String | 是 |交易流水号 |
4.3 请求示例```json{
"appid": "wx1234567890",
"mch_id": "1234567890",
"nonce_str": "abc123",
"transaction_id": "202302220000100000001"
}
```
4.4 响应参数| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| `return_code` | String | 返回状态码 |
| `return_msg` | String | 返回信息 |
| `appid` | String | 公众号或小程序的APPID |
| `mch_id` | String | 商户ID |
| `nonce_str` | String | 随机字符串，防止重复请求 |
| `sign` | String | 签名 |
| `result_code` | String |业务结果状态码 |
| `trade_state` | String | 支付状态 |
4.5 响应示例```json{
"return_code": "SUCCESS",
"return_msg": "",
"appid": "wx1234567890",
"mch_id": "1234567890",
"nonce_str": "abc123",
"sign": "abc123",
"result_code": "SUCCESS",
"trade_state": "NOTPAY"
}
```
五、关闭订单接口
5.1 接口描述关闭订单接口用于关闭一个支付订单。
5.2 请求参数| 参数名称 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `appid` | String | 是 | 公众号或小程序的APPID |
| `mch_id` | String | 是 | 商户ID |
| `nonce_str` | String | 是 | 随机字符串，防止重复请求 |
| `out_trade_no` | String | 是 | 商户订单号 |
5.3 请求示例```json{
"appid": "wx1234567890",
"mch_id": "1234567890",
"nonce_str": "abc123",
"out_trade_no": "202302220000100000001"
}
```
5.4 响应参数| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| `return_code` | String | 返回状态码 |
| `return_msg` | String | 返回信息 |
5.5 响应示例```json{
"return_code": "SUCCESS",
"return_msg": ""
}
```
六、注意事项
1. 本示例代码仅供参考，具体实现可能需要根据实际需求进行调整。
2. 微信服务商模式(电商收付通)合单支付API V3接口的使用需要遵守微信相关规定和政策。
3.请确保您的公众号或小程序已在微信开放平台注册并获得相应权限。
以上是微信服务商模式(电商收付通)合单支付API V3完整Demo的描述。
