微信支付 API V3 统一支付接口
微信支付 API V3 统一支付接口是一种新的支付接口，支持 H5、JSAPI、H5、App 和 小程序 等多种支付场景。该接口旨在统一不同支付方式的接口，方便开发者使用。
接口概览
微信支付 API V3 统一支付接口共有以下几个主要接口：
1. 统一下单接口（Unified Order）
2. 关闭订单接口（Close Order）
3. 查询订单接口（Query Order）
4. 退款接口（Refund）
统一下单接口（Unified Order）
统一下单接口用于生成一个支付订单，支持多种支付方式。该接口的请求参数如下：
| 参数名称 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| `appid` | String | 是 | 公众号或小程序的 AppID |
| `mch_id` | String | 是 | 商户 ID |
| `nonce_str` | String | 是 | 随机字符串，防止重复请求 |
| `body` | String | 是 | 商品描述 |
| `notify_url` | String | 否 | 回调 URL |
| `trade_type` | String | 是 | 支付类型（见下表） |
| `spbill_create_ip` | String | 是 | IP 地址 |
| `total_fee` | Int | 是 |金额 |
支付类型（trade_type）支持以下值：
* JSAPI：微信 JSAPI 支付* H5：微信 H5 支付* APP：微信 APP 支付* MWEB：微信 MWEB 支付统一下单接口的响应参数如下：
| 参数名称 | 类型 |说明 |
| --- | --- | --- |
| `appid` | String | 公众号或小程序的 AppID |
| `mch_id` | String | 商户 ID |
| `nonce_str` | String | 随机字符串，防止重复请求 |
| `prepay_id` | String | 预支付交易会话ID |
| `package` | String | 支付包信息 |
关闭订单接口（Close Order）
关闭订单接口用于关闭一个已经生成的支付订单。该接口的请求参数如下：
| 参数名称 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| `appid` | String | 是 | 公众号或小程序的 AppID |
| `mch_id` | String | 是 | 商户 ID |
| `nonce_str` | String | 是 | 随机字符串，防止重复请求 |
| `out_trade_no` | String | 是 |业务订单号 |
关闭订单接口的响应参数如下：
| 参数名称 | 类型 |说明 |
| --- | --- | --- |
| `appid` | String | 公众号或小程序的 AppID |
| `mch_id` | String | 商户 ID |
| `nonce_str` | String | 随机字符串，防止重复请求 |
查询订单接口（Query Order）
查询订单接口用于查询一个已经生成的支付订单的状态。该接口的请求参数如下：
| 参数名称 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| `appid` | String | 是 | 公众号或小程序的 AppID |
| `mch_id` | String | 是 | 商户 ID |
| `nonce_str` | String | 是 | 随机字符串，防止重复请求 |
| `out_trade_no` | String | 是 |业务订单号 |
查询订单接口的响应参数如下：
| 参数名称 | 类型 |说明 |
| --- | --- | --- |
| `appid` | String | 公众号或小程序的 AppID |
| `mch_id` | String | 商户 ID |
| `nonce_str` | String | 随机字符串，防止重复请求 |
| `trade_state` | String | 支付状态 |
退款接口（Refund）
退款接口用于退还一个已经支付的金额。该接口的请求参数如下：
| 参数名称 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| `appid` | String | 是 | 公众号或小程序的 AppID |
| `mch_id` | String | 是 | 商户 ID |
| `nonce_str` | String | 是 | 随机字符串，防止重复请求 |
| `out_trade_no` | String | 是 |业务订单号 |
| `refund_fee` | Int | 是 |退款金额 |
退款接口的响应参数如下：
| 参数名称 | 类型 |说明 |
| --- | --- | --- |
| `appid` | String | 公众号或小程序的 AppID |
| `mch_id` | String | 商户 ID |
| `nonce_str` | String | 随机字符串，防止重复请求 |
以上就是微信支付 API V3 统一支付接口的主要内容。该接口支持 H5、JSAPI、H5、APP 和 小程序 等多种支付场景，方便开发者使用。
