H5支付下单

更新时间:2025.03.21

通过本接口提交微信支付H5支付订单。


1. 接口说明

适用对象:直连模式机构模式

请求URL: https://apihk.mch.weixin.qq.com/v3/global/transactions/mweb

请求方式: POST

 

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

2. 请求参数

参数名

变量

类型[长度限制]

必填

描述

商户号

mchid

string[1, 32]

Body 微信支付分配的商户号
注意:仅适用于直连模式
示例值:1900000109

APPID

appid

string[1, 32]

Body 商户在微信公众平台或开放平台生成的应用的APPID。求统一下单接口时请注意APPID的应用属性,例如公众号场景下,需使用应用属性为公众号的APPID。
注意:仅适用于直连模式
示例值:wx8888888888888888

子商户号

sub_mchid

string[1, 32]

Body 微信支付分配的子商户号
注意:仅适用于机构模式
示例值:1900000109

机构商户号

sp_mchid

string[1, 32]

Body 微信支付分配的机构商户号
注意:仅适用于机构模式
示例值:1900000100

机构APPID

sp_appid

string[1, 32]

Body 机构在微信公众平台申请服务号对应的APPID
注意:仅适用于机构模式
示例值:wx8888888888888888

子商户APPID

sub_appid

string[1, 32]

Body 商户在微信开放平台申请移动应用对应的APPID
付款码支付/扫码支付/公众号支付使用商户公众号appid
小程序支付使用商户小程序appid
APP支付使用商户APP应用appid
注意:仅适用于机构模式
示例值:wx8888888888888888

商品描述

description

string[1, 127]

Body 商品或支付单简要描述,格式要求:门店品牌名-城市分店名-实际商品名称
示例值:image形象店-深圳腾大- QQ公仔

商户数据

attach

string[1, 127]

Body 附加数据,在查询API和支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
示例值:自定义数据

通知地址

notify_url

string[1,256]

Body 异步接收微信支付结果通知的回调地址,通知url必须为外网可访问的url,不能携带参数。请使用https协议链接
示例值:https://www.weixin.qq.com/wxpay/pay.php

商户订单号

out_trade_no

string[1, 32]

Body 商户系统内部的订单号,32个字符内、可包含字母;重新下单时请更换单号,其他说明见商户订单号
示例值:1217752501201407033233368018

商品标记

goods_tag

string[1, 32]

Body 商品标记
示例值:WXG

交易类型

trade_type

string[1, 16]

Body JSAPI:公众号支付
NATIVE:扫码支付
APP:App支付
MWEB:H5支付
MICROPAY:付款码支付
示例值:MWEB

指定支付方式

limit_pay

string[1, 32]

Body no_credit:指定不能使用信用卡支付
示例值:no_credit

交易起始时间

time_start

string[1,64]

Body 订单生成时间,格式为rfc3339格式,如2018-06-08T10:34:56+08:00 代表北京时间2018年06月08日10时34分56秒
示例值:2018-06-08T10:34:56+08:00

交易结束时间

time_expire

string[1,64]

Body 订单失效时间,格式为rfc3339格式,如2018-06-08T10:34:56+08:00 代表北京时间2018年06月08日10时34分56秒。
示例值:2018-06-08T10:34:56+08:00

MCC码

merchant_category_code

string[1, 16]

Body 商户行业编码,值列表详见商户行业编码
示例值:4111

支付者

payer

object

Body 支付者信息,详细说明见下文

支付者

订单金额

amount

object

Body 订单金额信息,详细说明见下文

订单金额

场景信息

scene_info

object

Body 场景信息对象,详细说明见下文

场景信息

优惠功能

detail

object

Body 优惠功能信息,详细说明见下文

优惠功能

请求示例

机构模式

1{
2    "sp_appid": "wx2421b1c4370ec43b",
3    "sp_mchid": "10000100",  
4    "sub_mchid": "20000100",
5    "out_trade_no": "20150806125346",
6    "merchant_category_code": "1011",
7    "notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
8    "trade_type": "MWEB",
9    "amount": {
10      "total": 10000,
11      "currency" : "HKD"
12    },
13    "attach": "Payment test",
14    "description": "H5 payment test",
15    "goods_tag": "",
16    "detail" : {
17        "cost_price": 10000,
18        "receipt_id" : "1234",
19        "goods_detail": [
20          {
21              "goods_id":"iphone6s_16G",
22              "wxpay_goods_id":"1001",
23              "goods_name":"iPhone6s 16G",
24              "quantity":1,
25              "price":528800
26          }
27        ]
28    },
29    "scene_info": {
30      "payer_client_ip" : "14.23.150.211",
31      "device_ip" : "59.37.125.32",
32      "device_id" : "013467007045764",
33      "operator_id": "P001",
34      "store_info" : {
35        "id": "SZTX001"
36      }
37    }
38}  

直连模式

1{
2    "appid": "wx2421b1c4370ec43b",
3    "mchid": "10000100",  
4    "out_trade_no": "20150806125346",
5      "merchant_category_code": "1011",
6    "payer" : {
7      "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
8      },
9    "notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
10    "trade_type": "MWEB",
11    "amount": {
12      "total": 10000,
13      "currency" : "HKD"
14    },
15    "attach": "Payment test",
16    "description": "H5 payment test",
17    "goods_tag": "",
18    "detail" : {
19        "cost_price": 10000,
20        "receipt_id" : "1234",
21        "goods_detail": [
22          {
23              "goods_id":"iphone6s_16G",
24              "wxpay_goods_id":"1001",
25              "goods_name":"iPhone6s 16G",
26              "quantity":1,
27              "price":528800
28          }
29        ]
30    },
31    "scene_info": {
32      "payer_client_ip" : "14.23.150.211",
33      "device_ip" : "59.37.125.32",
34      "device_id" : "013467007045764",
35      "operator_id": "P001",
36      "store_info" : {
37        "id": "SZTX001"
38      }
39    }
40}

 

3. 返回参数

正常返回

参数名

变量

类型[长度限制]

必填

描述

支付跳转链接

mweb_url

string[1,512]

mweb_url为拉起微信支付收银台的中间页面,可通过访问该url来拉起微信客户端,完成支付,mweb_url的有效期为5分钟。
示例值:https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458241

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

错误码,枚举值见错误码列表
示例值:INVALID_REQUEST

返回信息

message

string[1, 256]

返回信息,如非空,为错误原因
示例值:参数格式校验错误

详细的错误描述

detail

object

当code为PARAM_ERROR时返回,详细说明见下

详细的错误描述

返回示例

正常示例

1{
2	"mweb_url": " https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458241"
3}

4. 错误码

错误码

描述

解决方案

NO_AUTH

商户无此接口权限

请商户前往申请此接口权限

NOT_ENOUGH

余额不足

用户账号余额不足,请用户充值或更换支付卡后再支付

ORDER_PAID

商户订单已支付

商户订单已支付,无需更多操作

ORDER_CLOSED

订单已关闭

当前订单已关闭,请重新下单

SYSTEM_ERROR

系统错误

系统异常,请用相同参数重新调用

APPID_NOT_EXIST

APPID不存在

请检查APPID是否正确

MCHID_NOT_EXIST

MchID不存在

请检查MchID是否正确

APPID_MCHID_NOT_MATCH

appid和mchid不匹配

请确认appid和mchid是否匹配

LACK_PARAMS

缺少参数

请检查参数是否齐全

OUT_TRADE_NO_USED

商户订单号重复

请核实商户订单号是否重复提交

SIGN_ERROR

签名错误

请检查签名参数和方法是否都符合签名算法要求

REQUIRE_POST_METHOD

请使用post方法

请检查请求参数是否通过post方法提交

POST_DATA_EMPTY

post数据为空

请检查post数据是否为空

NOT_UTF8

编码格式错误

请使用UTF-8编码格式

 

 

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.