H5支付(MWEB) API
特别说明:本API以申请形式开放,需要的同学请发工单附带业务场景描述单独申请开通
H5 支付是指手机自带浏览器跳转至微信客户端支付的方式
H5 支付请求步骤:
- 构建请求参数
- POST 参数到请求地址
- 根据返回的参数
h5_url
在前端跳转 - 用户支付成功后接收异步通知
请求地址:/api/mweb
请求参数(必选参数):
字段名称 | 字段类型 | 必填参数 | 说明 |
---|---|---|---|
mchid | string(16) | Y | 商户号 |
total_fee | int(16) | Y | 金额。单位:分 |
out_trade_no | string(32) | Y | 用户端自主生成的订单号 |
sign | string(32) | Y | 数据签名 详见签名算法 |
body | string(64) | N | 订单标题 |
attach | string(127) | N | 用户自定义数据,在notify的时候会原样返回 |
callback_url | string(255) | N | 支付成功后,从微信客户端跳转回浏览器的URL。留空跳回原地址 |
notify_url | string(255) | N | 接收微信支付异步通知的回调地址。必须为可直接访问的URL,不能带参数、session验证、csrf验证。留空则不通知 |
请求返回:
字段名称 | 字段类型 | 必填参数 | 说明 |
---|---|---|---|
return_code | int | Y | 1:请求成功,0:请求失败 |
return_msg | string(16) | Y | 返回消息 |
payjs_order_id | string(16) | Y | 平台订单号 |
out_trade_no | string(16) | Y | 用户生成的订单号原样返回 |
total_fee | int(16) | Y | 金额。单位:分 |
h5_url | string(64) | Y | 浏览器跳转到微信支付的地址(有效期5分钟) |
sign | string(64) | Y | 数据签名 详见签名算法 |
常见问题:
h5_url
须以链接形式点击跳转(微信客户端须获取到浏览器referer)