微信支付-融合钱包开发者文档

返回上一层融合钱包 / H5支付 / H5支付下单API

H5支付下单

最新更新时间：2022.03.10 版本说明

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

接口说明

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

请求URL: https://api.mch.weixin.qq.com/hk/v3/transactions/mweb

请求方式: POST

接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3/wei-xin-zhi-fu-api-v3-jie-kou-gui-fan

path 指该参数为路径参数

query 指该参数为URL参数

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

请求参数

参数名

变量

类型

必填

描述

商户号

mchid

string(32)

是

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

APPID

appid

string(32)

是

body 商户在微信公众平台申请服务号对应的APPID
注意：仅适用于直连模式
示例值：wx8888888888888888

子商户号

sub_mchid

string(32)

是

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

机构商户号

sp_mchid

string(32)

是

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

机构APPID

sp_appid

string(32)

是

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

子商户APPID

sub_appid

string(32)

否

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

商品描述

description

string(127)

是

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

商户数据

attach

string(127)

否

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

通知地址

notify_url

string(256)

是

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

商户订单号

out_trade_no

string(32)

是

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

商品标记

goods_tag

string(32)

否

body 商品标记
示例值：WXG

交易类型

trade_type

string(16)

是

body枚举值：
JSAPI：公众号支付
NATIVE：扫码支付
APP：App支付
MWEB：H5支付
MICROPAY：付款码支付
示例值：APP

指定支付方式

limit_pay

string(32)

否

body no_credit：指定不能使用信用卡支付
示例值：no_credit

交易起始时间

time_start

string(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(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(16)

是

body 商户行业编码，值列表详见商户行业编码
示例值：1011

+ 支付者

payer

object

否

body 支付者信息，详细说明见下文

参数名	变量	类型	必填	描述
用户标识	openid	string(128)	否	用户在商户appid对应下的唯一标识，需要传appid才有返回，openid如何获取，可详见获取openid 注意：仅适用于直连模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用户标识（机构）	sp_openid	string(128)	否	用户在机构sp_appid对应下的唯一标识，openid和sub_openid可以选传其中之一，如果选择传sub_openid,则必须传sub_appid。下单前需要调用【网页授权】接口获取到用户的openid。注意：仅适用于机构模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用户标识（特约商户）	sub_openid	string(128)	否	用户在子商户sub_appid下用户唯一标识，openid和sub_openid可以选传其中之一，如果选择传sub_openid,则必须传sub_appid。下单前需要调用【网页授权】接口获取到用户的openid，注意：仅适用于机构模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

+订单金额

amount

object

是

body 订单金额信息，详细说明见下文

参数名	变量	类型	必填	描述
总金额	total	int	是	订单总金额，币种的最小单位，只能为整数，详见交易金额示例值：888
货币类型	currency	string(16)	是	符合ISO 4217标准的三位字母代码注意：当前仅支持使用HKD标价示例值：HKD

+ 场景信息

scene_info

object

是

body 场景信息对象，详细说明见下文

参数名

变量

类型

必填

描述

商户端设备号

device_id

string(32)

否

终端设备号(商户自定义，如门店编号)
示例值：013467007045764

商户端设备IP

device_ip

string(40)

否

商户侧设备IP，取公网出口IP，支持IPV6
示例值：128.0.0.1

用户终端IP

payer_client_ip

string(40)

是

用户侧设备IP，取公网出口IP，支持IPV6。获取用户端IP请参考 H5支付获取用户IP指引
示例值：128.0.0.1

操作员ID

operator_id

string(32)

否

收银员ID，由商户自定义
示例值：123145

+ 商户门店信息

store_info

object

否

门店信息对象，详细说明见下文

参数名	变量	类型	必填	描述
编号	id	string(32)	否	商户侧门店ID 示例值：0001
名称	name	string(32)	是	商户侧门店名称示例值：腾讯大厦分店
详细地址	address	string(64)	是	详细的商户门店地址示例值：广东省深圳市南山区科技中一道10000号

+ 优惠功能

detail

object

否

body 优惠功能信息，详细说明见下文

参数名

变量

类型

必填

描述

订单原价

cost_price

int

否

1.商户侧一张小票订单可能被分多次支付，订单原价用于记录整张小票的交易金额。
2.当订单原价与支付金额不相等，则不享受优惠。
3.该字段主要用于防止同一张小票分多次支付，以享受多次优惠的情况，正常支付订单不必上传此参数。
示例值：608800

商品小票ID

receipt_id

string(32)

否

商家小票ID
示例值：wx123

+ 单品列表

goods_detail

Array

否

单品信息，使用Json格式

参数名	变量	类型	必填	描述
商品编码	goods_id	string(32)	是	由半角的大小写字母、数字、中划线、下划线中的一种或几种组成示例值：12345
微信支付商品编码	wxpay_goods_id	string(32)	否	微信支付定义的统一商品编号（没有可不传）示例值：1001
商品名称	goods_name	string(256)	否	商品的实际名称示例值：iPhone6s 16G
商品数量	quantity	int	是	用户购买的数量示例值：1
商品单价	price	int	是	如果商户有优惠，需传输商户优惠后的单价(例如：用户对一笔100元的订单使用了商场发的优惠券100-50，则活动商品的单价应为原单价-50) 示例值：528800

请求示例：

{
    "sp_appid": "wx2421b1c4370ec43b",
    "sp_mchid": "10000100",
    "sub_mchid": "20000100",
    "out_trade_no": "20150806125346",
      "merchant_category_code": "1011",
    "payer" : {
      "sp_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
      },
    "notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
    "trade_type": "APP",
    "amount": {
      "total": 10000,
      "currency" : "HKD"
    },
    "attach": "支付测试",
    "description": "APP支付测试",
    "goods_tag": "",
    "detail" : {
        "cost_price": 10000,
        "receipt_id" : "1234",
        "goods_detail": [
          {
              "goods_id":"iphone6s_16G",
              "wxpay_goods_id":"1001",
              "goods_name":"iPhone6s 16G",
              "quantity":1,
              "price":528800
          }
        ]
    },
    "scene_info": {
      "payer_client_ip" : "14.23.150.211",
      "device_ip" : "59.37.125.32",
      "device_id" : "013467007045764",
      "operator_id": "P001",
      "store_info" : {
        "id": "SZTX001"
      }
    }
}

{
    "appid": "wx2421b1c4370ec43b",
    "mchid": "10000100",
    "out_trade_no": "20150806125346",
      "merchant_category_code": "1011",
    "payer" : {
      "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
      },
    "notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
    "trade_type": "APP",
    "amount": {
      "total": 10000,
      "currency" : "HKD"
    },
    "attach": "支付测试",
    "description": "APP支付测试",
    "goods_tag": "",
    "detail" : {
        "cost_price": 10000,
        "receipt_id" : "1234",
        "goods_detail": [
          {
              "goods_id":"iphone6s_16G",
              "wxpay_goods_id":"1001",
              "goods_name":"iPhone6s 16G",
              "quantity":1,
              "price":528800
          }
        ]
    },
    "scene_info": {
      "payer_client_ip" : "14.23.150.211",
      "device_ip" : "59.37.125.32",
      "device_id" : "013467007045764",
      "operator_id": "P001",
      "store_info" : {
        "id": "SZTX001"
      }
    }
}

返回参数

正常返回

参数名	变量	类型	必填	描述
支付跳转链接	mweb_url	string(512)	是	mweb_url为拉起微信支付收银台的中间页面，可通过访问该url来拉起微信客户端，完成支付,mweb_url的有效期为5分钟。示例值：https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb? prepay_id=wx2016121516420242444321 ca0631331346&package=1405458241

异常返回

参数名

变量

类型

必填

描述

返回状态码

code

string(32)

是

错误码，枚举值见错误码列表
示例值：INVALID_REQUEST

返回信息

message

string(256)

是

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

+ 详细的错误描述

detail

object

否

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

参数名	变量	类型	必填	描述
指示错误参数的位置	field	string(256)	是	当错误参数位于请求body的JSON时，填写指向参数的JSON Pointer；当错误参数位于请求的url或者querystring时，填写参数的变量名示例值：#/properties/payer
错误参数的值	value	string(256)	是	错误参数的值示例值：1346177081915535577
具体错误原因	issue	string(256)	是	具体错误原因示例值：与ALLOF schema不符
错误参数的位置	location	string(256)	否	body：错误参数位于请求body的JSON中 url：错误参数位于请求url中 query：错误参数位于请求的querystring中示例值：body

返回示例：

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

{
"code":"INVALID_REQUEST",
"message":"参数格式校验错误",
"detail":{
    "field":"#/properties/payer",
    "value":"1346177081915535577",
    "issue":"与ALLOF schema不符",
    "location":"body"
   }
}

错误码

错误码	描述	解决方案
NOAUTH	商户无此接口权限	请商户前往申请此接口权限
NOTENOUGH	余额不足	用户账号余额不足，请用户充值或更换支付卡后再支付
ORDERPAID	商户订单已支付	商户订单已支付，无需更多操作
ORDERCLOSED	订单已关闭	当前订单已关闭，请重新下单
SYSTEMERROR	系统错误	系统异常，请用相同参数重新调用
APPID_NOT_EXIST	APPID不存在	请检查APPID是否正确
MCHID_NOT_EXIST	MCHID不存在	请检查MCHID是否正确
APPID_MCHID_NOT_MATCH	appid和mchid不匹配	请确认appid和mchid是否匹配
LACK_PARAMS	缺少参数	请检查参数是否齐全
OUT_TRADE_NO_USED	商户订单号重复	请核实商户订单号是否重复提交
SIGNERROR	签名错误	请检查签名参数和方法是否都符合签名算法要求
REQUIRE_POST_METHOD	请使用post方法	请检查请求参数是否通过post方法提交
POST_DATA_EMPTY	post数据为空	请检查post数据是否为空
NOT_UTF8	编码格式错误	请使用UTF-8编码格式

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

H5支付

H5支付下单

接口说明

请求参数

请求示例：

返回参数

正常返回

异常返回

返回示例：

错误码

版本说明