Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

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编码格式


版本说明

关闭
V1.1
2022年3月10日
1. 请求参数promotion_detail调整为detail
V1.0
2020年1月08日
1. 下单接口上线

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global