跳到主要内容

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支付方式stringY枚举值 可填入 MWEB
merchant_order_id商户订单号string(32)Y用于唯一确定商户下单ID
order_amount订单金额stringY传入金额 例如 "1.25"
order_currency订单币种stringY订单标价币种
settle_currency结算币种stringY
order_description订单描述stringY订单的描述信息
client_ip客户端IPstringY请上传发起请求客户端IP
notify_url支付结果回调通知stringN
expired_time订单过期时间intN单位为秒,默认为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订单创建时间