微信支付-融合錢包開發(fā)者文檔

返回上一層融合錢包 / H5支付 / H5支付下單API

H5支付下單

最新更新時間：2022.03.10 版本說明

通過本接口提交微信支付H5支付訂單

接口說明

適用對象:直連模式機構(gòu)模式

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

請求方式: POST

接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3/wei-xin-zhi-fu-api-v3-jie-kou-gui-fan

path 指該參數(shù)為路徑參數(shù)

query 指該參數(shù)為URL參數(shù)

body 指該參數(shù)需在請求JSON傳參

請求參數(shù)

參數(shù)名

變量

類型

必填

描述

商戶號

mchid

string(32)

是

body 微信支付分配的商戶號
注意：僅適用于直連模式
示例值：1900000109

APPID

appid

string(32)

是

body 商戶在微信公眾平臺申請服務號對應的APPID
注意：僅適用于直連模式
示例值：wx8888888888888888

子商戶號

sub_mchid

string(32)

是

body 微信支付分配的子商戶號
注意：僅適用于機構(gòu)模式
示例值：1900000109

機構(gòu)商戶號

sp_mchid

string(32)

是

body 微信支付分配的機構(gòu)商戶號
注意：僅適用于機構(gòu)模式
示例值：1900000100

機構(gòu)APPID

sp_appid

string(32)

是

body 機構(gòu)在微信公眾平臺申請服務號對應的APPID
注意：僅適用于機構(gòu)模式
示例值：wx8888888888888888

子商戶APPID

sub_appid

string(32)

否

body 子商戶在微信開放平臺申請移動應用對應的APPID
付款碼支付/掃碼支付/公眾號支付使用商戶公眾號appid
小程序支付使用商戶小程序appid
APP支付使用商戶APP應用appid
注意：僅適用于機構(gòu)模式
示例值：wx8888888888888888

商品描述

description

string(127)

是

body 商品或支付單簡要描述，格式要求：門店品牌名-城市分店名-實際商品名稱
示例值：image形象店-深圳騰大- QQ公仔

商戶數(shù)據(jù)

attach

string(127)

否

body 附加數(shù)據(jù)，在查詢API和支付通知中原樣返回，該字段主要用于商戶攜帶訂單的自定義數(shù)據(jù)
示例值：自定義數(shù)據(jù)

通知地址

notify_url

string(256)

是

body 異步接收微信支付結(jié)果通知的回調(diào)地址，通知url必須為外網(wǎng)可訪問的url，不能攜帶參數(shù)。請使用https協(xié)議鏈接
示例值：https://www.weixin.qq.com/wxpay/pay.php

商戶訂單號

out_trade_no

string(32)

是

body 商戶系統(tǒng)內(nèi)部的訂單號,32個字符內(nèi)、可包含字母；重新下單時請更換單號，其他說明見商戶訂單號
示例值：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

交易結(jié)束時間

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 商戶行業(yè)編碼，值列表詳見商戶行業(yè)編碼
示例值：1011

+ 支付者

payer

object

否

body 支付者信息，詳細說明見下文

參數(shù)名	變量	類型	必填	描述
用戶標識	openid	string(128)	否	用戶在商戶appid對應下的唯一標識，需要傳appid才有返回，openid如何獲取，可詳見獲取openid 注意：僅適用于直連模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶標識（機構(gòu)）	sp_openid	string(128)	否	用戶在機構(gòu)sp_appid對應下的唯一標識，openid和sub_openid可以選傳其中之一，如果選擇傳sub_openid,則必須傳sub_appid。下單前需要調(diào)用【網(wǎng)頁授權(quán)】接口獲取到用戶的openid。注意：僅適用于機構(gòu)模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶標識（特約商戶）	sub_openid	string(128)	否	用戶在子商戶sub_appid下用戶唯一標識，openid和sub_openid可以選傳其中之一，如果選擇傳sub_openid,則必須傳sub_appid。下單前需要調(diào)用【網(wǎng)頁授權(quán)】接口獲取到用戶的openid，注意：僅適用于機構(gòu)模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

+訂單金額

amount

object

是

body 訂單金額信息，詳細說明見下文

參數(shù)名	變量	類型	必填	描述
總金額	total	int	是	訂單總金額，幣種的最小單位，只能為整數(shù)，詳見交易金額示例值：888
貨幣類型	currency	string(16)	是	符合ISO 4217標準的三位字母代碼注意：當前僅支持使用HKD標價示例值：HKD

+ 場景信息

scene_info

object

是

body 場景信息對象，詳細說明見下文

參數(shù)名

變量

類型

必填

描述

商戶端設(shè)備號

device_id

string(32)

否

終端設(shè)備號(商戶自定義，如門店編號)
示例值：013467007045764

商戶端設(shè)備IP

device_ip

string(40)

否

商戶側(cè)設(shè)備IP，取公網(wǎng)出口IP，支持IPV6
示例值：128.0.0.1

用戶終端IP

payer_client_ip

string(40)

是

用戶側(cè)設(shè)備IP，取公網(wǎng)出口IP，支持IPV6。獲取用戶端IP請參考 H5支付獲取用戶IP指引
示例值：128.0.0.1

操作員ID

operator_id

string(32)

否

收銀員ID，由商戶自定義
示例值：123145

+ 商戶門店信息

store_info

object

否

門店信息對象，詳細說明見下文

參數(shù)名	變量	類型	必填	描述
編號	id	string(32)	否	商戶側(cè)門店ID 示例值：0001
名稱	name	string(32)	是	商戶側(cè)門店名稱示例值：騰訊大廈分店
詳細地址	address	string(64)	是	詳細的商戶門店地址示例值：廣東省深圳市南山區(qū)科技中一道10000號

+ 優(yōu)惠功能

detail

object

否

body 優(yōu)惠功能信息，詳細說明見下文

參數(shù)名

變量

類型

必填

描述

訂單原價

cost_price

int

否

1.商戶側(cè)一張小票訂單可能被分多次支付，訂單原價用于記錄整張小票的交易金額。
2.當訂單原價與支付金額不相等，則不享受優(yōu)惠。
3.該字段主要用于防止同一張小票分多次支付，以享受多次優(yōu)惠的情況，正常支付訂單不必上傳此參數(shù)。
示例值：608800

商品小票ID

receipt_id

string(32)

否

商家小票ID
示例值：wx123

+ 單品列表

goods_detail

Array

否

單品信息，使用Json格式

參數(shù)名	變量	類型	必填	描述
商品編碼	goods_id	string(32)	是	由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成示例值：12345
微信支付商品編碼	wxpay_goods_id	string(32)	否	微信支付定義的統(tǒng)一商品編號（沒有可不傳）示例值：1001
商品名稱	goods_name	string(256)	否	商品的實際名稱示例值：iPhone6s 16G
商品數(shù)量	quantity	int	是	用戶購買的數(shù)量示例值：1
商品單價	price	int	是	如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(例如：用戶對一筆100元的訂單使用了商場發(fā)的優(yōu)惠券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"
      }
    }
}

返回參數(shù)

正常返回

參數(shù)名	變量	類型	必填	描述
支付跳轉(zhuǎn)鏈接	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

異常返回

參數(shù)名

變量

類型

必填

描述

返回狀態(tài)碼

code

string(32)

是

錯誤碼，枚舉值見錯誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string(256)

是

返回信息，如非空，為錯誤原因
示例值：參數(shù)格式校驗錯誤

+ 詳細的錯誤描述

detail

object

否

當code為PARAM_ERROR時返回，詳細說明見下

參數(shù)名	變量	類型	必填	描述
指示錯誤參數(shù)的位置	field	string(256)	是	當錯誤參數(shù)位于請求body的JSON時，填寫指向參數(shù)的JSON Pointer；當錯誤參數(shù)位于請求的url或者querystring時，填寫參數(shù)的變量名示例值：#/properties/payer
錯誤參數(shù)的值	value	string(256)	是	錯誤參數(shù)的值示例值：1346177081915535577
具體錯誤原因	issue	string(256)	是	具體錯誤原因示例值：與ALLOF schema不符
錯誤參數(shù)的位置	location	string(256)	否	body：錯誤參數(shù)位于請求body的JSON中 url：錯誤參數(shù)位于請求url中 query：錯誤參數(shù)位于請求的querystring中示例值：body

返回示例：

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

{
"code":"INVALID_REQUEST",
"message":"參數(shù)格式校驗錯誤",
"detail":{
    "field":"#/properties/payer",
    "value":"1346177081915535577",
    "issue":"與ALLOF schema不符",
    "location":"body"
   }
}

錯誤碼

錯誤碼	描述	解決方案
NOAUTH	商戶無此接口權(quán)限	請商戶前往申請此接口權(quán)限
NOTENOUGH	余額不足	用戶賬號余額不足，請用戶充值或更換支付卡后再支付
ORDERPAID	商戶訂單已支付	商戶訂單已支付，無需更多操作
ORDERCLOSED	訂單已關(guān)閉	當前訂單已關(guān)閉，請重新下單
SYSTEMERROR	系統(tǒng)錯誤	系統(tǒng)異常，請用相同參數(shù)重新調(diào)用
APPID_NOT_EXIST	APPID不存在	請檢查APPID是否正確
MCHID_NOT_EXIST	MCHID不存在	請檢查MCHID是否正確
APPID_MCHID_NOT_MATCH	appid和mchid不匹配	請確認appid和mchid是否匹配
LACK_PARAMS	缺少參數(shù)	請檢查參數(shù)是否齊全
OUT_TRADE_NO_USED	商戶訂單號重復	請核實商戶訂單號是否重復提交
SIGNERROR	簽名錯誤	請檢查簽名參數(shù)和方法是否都符合簽名算法要求
REQUIRE_POST_METHOD	請使用post方法	請檢查請求參數(shù)是否通過post方法提交
POST_DATA_EMPTY	post數(shù)據(jù)為空	請檢查post數(shù)據(jù)是否為空
NOT_UTF8	編碼格式錯誤	請使用UTF-8編碼格式

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

H5支付

H5支付下單

接口說明

請求參數(shù)

請求示例：

返回參數(shù)

正常返回

異常返回

返回示例：

錯誤碼

版本說明