H5请求下单
H5支付是指商户在微信客户端外的移动端网页展示商品或服务,用户在前述页面确认使用微信支付时,商户发起本服务呼起微信客户端进行支付。
主要用于触屏版的手机浏览器请求微信支付的场景。可以方便的从外部浏览器唤起微信支付。
H5请求下单
POST /mch-api/v1/acq/wechat/create_payment
接口认证请参考 认证说明
- 请求示例
{
"payment_method": "MWEB",
"merchant_order_id": "P147258",
"order_amount": "1.00",
"order_currency": "HKD",
"order_description": "ticket payment",
"notify_url": "https://www.baidu.com",
"expired_time": 300
}
- Request
| 参数 | 说明 | 类型 | 必填 | 示例 |
|---|---|---|---|---|
| payment_method | 支付方式 | string | Y | 枚举值 可填入 MWEB |
| merchant_order_id | 商户订单号 | string(32) | Y | 用于唯一确定商户下单ID |
| order_amount | 订单金额 | string | Y | 传入金额 例如 "1.25" |
| order_currency | 订单币种 | string | Y | 订单标价币种 |
| settle_currency | 结算币种 | string | Y | |
| order_description | 订单描述 | string | Y | 订单的描述信息 |
| client_ip | 客户端IP | string | Y | 请上传发起请求客户端IP |
| notify_url | 支付结果回调通知 | string | N | |
| expired_time | 订单过期时间 | int | N | 单位为秒,默认为300 |
- 返回示例
{
"code": 0,
"data": {
"pay_url": "https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx28184505456404a4e4c6d19ea&package=3818273312",
"create_time": "2023-08-31T04:44:05.928696203+08:00",
"merchant_order_id": "C34428245018020000",
"order_amount": "1.00",
"order_currency": "HKD",
"order_id": "C34428245018020000",
"uid": 19291111
},
"message": "ok",
"rid": "d2b810e57d4e4f6aac8387742a6e6582"
}
- Response.Data
| 参数 | 说明 | 示例 |
|---|---|---|
| uid | 平台商户号 | 由平台统一生成分配 |
| order_id | 平台订单号 | |
| merchant_order_id | 商户订单ID | |
| pay_url | 返回的pay_url | 请直接用在平台上备案的域名跳转至此链接,微信会判断请求来源refer_url |
| order_amount | 订单金额 | |
| order_currency | 订单币种 | |
| create_time | 订单创建时间 |