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

返回上一層融合錢包 / 付款碼支付 / 提交付款碼支付API

提交付款碼支付

最新更新時(shí)間：2020.1.08 版本說明

通過本接口提交微信支付付款碼支付訂單。

接口說明

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

請(qǐng)求URL: https://api.mch.weixin.qq.com/hk/v3/transactions/micropay

請(qǐng)求方式: POST

接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3

頻率限制:150qps

path 指該參數(shù)需在請(qǐng)求URL傳參

query 指該參數(shù)需在請(qǐng)求JSON傳參

請(qǐng)求參數(shù)

參數(shù)名

變量

類型

必填

描述

商戶號(hào)

mchid

string(32)

是

query 微信支付分配的商戶號(hào)
注意：僅適用于直連模式
示例值：1900000109

APPID

appid

string(32)

是

query 商戶在微信公眾平臺(tái)申請(qǐng)服務(wù)號(hào)對(duì)應(yīng)的APPID
注意：僅適用于直連模式
示例值：wx8888888888888888

子商戶號(hào)

sub_mchid

string(32)

是

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

機(jī)構(gòu)商戶號(hào)

sp_mchid

string(32)

是

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

機(jī)構(gòu)APPID

sp_appid

string(32)

是

query 機(jī)構(gòu)在微信公眾平臺(tái)申請(qǐng)服務(wù)號(hào)對(duì)應(yīng)的APPID
示例值：wx8888888888888888

子商戶APPID

sub_appid

string(32)

否

query 子商戶在微信開放平臺(tái)申請(qǐng)移動(dòng)應(yīng)用對(duì)應(yīng)的APPID
示例值：wx8888888888888888

商品描述

description

string(128)

是

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

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

attach

string(127)

否

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

商戶訂單號(hào)

out_trade_no

string(32)

是

query 商戶系統(tǒng)內(nèi)部的訂單號(hào),32個(gè)字符內(nèi)、可包含字母；更換授權(quán)碼必須要換新的商戶訂單號(hào)?其他說明見商戶訂單號(hào)
示例值：1217752501201407033233368018

商品標(biāo)記

goods_tag

string(32)

否

query 商品標(biāo)記，代金券或立減優(yōu)惠功能的參數(shù)，說明詳見代金券或立減優(yōu)惠
示例值：WXG

交易類型

trade_type

string(16)

是

query MICROPAY：刷卡支付
示例值：MICROPAY

指定支付方式

limit_pay

string(32)

否

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

MCC碼

merchant_category_code

string(16)

是

query 商戶行業(yè)編碼，值列表詳見商戶行業(yè)編碼
示例值：1011

+ 支付者

payer

object

否

query 支付者信息，詳細(xì)說明見下文

參數(shù)名	變量	類型	必填	描述
授權(quán)碼	auth_code	string(128)	是	掃碼支付授權(quán)碼，即用戶打開微信錢包顯示的碼? 示例值：120061098828009406

+訂單金額

amount

object

是

query 訂單金額信息，詳細(xì)說明見下文

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

+ 場景信息

scene_info

object

否

query 場景信息對(duì)象，詳細(xì)說明見下文

參數(shù)名

變量

類型

必填

描述

商戶端設(shè)備號(hào)

device_id

string(32)

否

終端設(shè)備號(hào)(商戶自定義，如門店編號(hào))
示例值：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
示例值：128.0.0.1

操作員ID

operator_id

string(32)

否

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

+ 商戶門店信息

store_info

object

否

門店信息對(duì)象，詳細(xì)說明見下文

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

+ 優(yōu)惠功能

promotion_detail

array

否

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

參數(shù)名

變量

類型

必填

描述

訂單原價(jià)

cost_price

int

否

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

商品小票ID

receipt_id

string(32)

否

商家小票ID
示例值：wx123

+ 單品列表

goods_detail

Array

否

單品信息，使用Json格式

參數(shù)名	變量	類型	必填	描述
商品編碼	goods_id	string(32)	是	由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成示例值：商品編碼
微信側(cè)商品編碼	wxpay_goods_id	string(32)	否	微信支付定義的統(tǒng)一商品編號(hào)（沒有可不傳）示例值：1001
商品名稱	goods_name	string(256)	否	商品的實(shí)際名稱示例值：iPhone6s 16G
商品數(shù)量	quantity	int	是	用戶購買的數(shù)量示例值：1
商品單價(jià)	price	int	是	如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(jià)(例如：用戶對(duì)一筆100元的訂單使用了商場發(fā)的優(yōu)惠券100-50，則活動(dòng)商品的單價(jià)應(yīng)為原單價(jià)-50) 示例值：528800

請(qǐng)求示例：

JSON

{
    "sp_appid": "wx2421b1c4370ec43b",
    "sp_mchid": "10000100",
    "sub_mchid": "20000100",
    "out_trade_no": "20150806125346",
    "merchant_category_code": "1011",
    "payer" : {
      "auth_code": "120061098828009406"
    },
    "trade_type": "MICROPAY",
    "amount": {
        "total": 528800,
        "currency" : "HKD"
    },
    "attach": "支付測試",
    "description": "image形象店-深圳騰大- QQ公仔",
    "goods_tag": "1234",
    "limit_pay": "no_credit",
    "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",
          "name": "騰訊大廈分店",
          "address": "廣東省深圳市南山區(qū)科技中一道10000號(hào)"
        }
    }
}

    
｛
JAVA示例代碼
｝

返回參數(shù)

正常返回

參數(shù)名

變量

類型

必填

描述

微信支付訂單號(hào)

transaction_id

string(32)

是

微信支付訂單號(hào)
示例值：1217752501201407033233368018

商戶號(hào)

mchid

string(32)

是

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

APPID

appid

string(32)

是

商戶在微信公眾平臺(tái)申請(qǐng)服務(wù)號(hào)對(duì)應(yīng)的APPID
注意：僅適用于直連模式
示例值：wx8888888888888888

子商戶號(hào)

sub_mchid

string(32)

是

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

機(jī)構(gòu)商戶號(hào)

sp_mchid

string(32)

是

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

機(jī)構(gòu)APPID

sp_appid

string(32)

是

機(jī)構(gòu)在微信公眾平臺(tái)申請(qǐng)服務(wù)號(hào)對(duì)應(yīng)的APPID
示例值：wx8888888888888888

子商戶APPID

sub_appid

string(32)

否

子商戶在微信開放平臺(tái)申請(qǐng)移動(dòng)應(yīng)用對(duì)應(yīng)的APPID
示例值：wx8888888888888888

商戶訂單號(hào)

out_trade_no

string(32)

是

返回的商戶訂單號(hào)
示例值：1217752501201407033233368018

交易類型

trade_type

string(16)

是

刷卡支付
示例值：MICROPAY

交易狀態(tài)

trade_state

string(32)

是

SUCCESS—支付成功
REFUND—轉(zhuǎn)入退款
NOTPAY—未支付
CLOSED—已關(guān)閉
REVOKED—已撤銷（刷卡支付）
USERPAYING--用戶支付中
PAYERROR--支付失敗(其他原因，如銀行返回失敗)
示例值：SUCCESS

交易狀態(tài)描述

trade_state_desc

string(256)

是

對(duì)當(dāng)前訂單狀態(tài)的描述和下一步操作的指引
示例值：支付失敗，請(qǐng)重新下單支付

付款銀行

bank_type

string(16)

是

銀行類型，采用字符串類型的銀行標(biāo)識(shí)，值列表詳見銀行類型
示例值：CMC

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

attach

string(127)

否

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

支付完成時(shí)間

success_time

string(64)

是

訂單支付成功時(shí)間，格式為rfc3339格式，如2018-06-08T10:34:56+08:00?代表北京時(shí)間2018年06月08日10時(shí)34分56秒
示例值：2018-06-08T10:34:56+08:00

+ 支付者

payer

object

否

query 支付者信息，詳細(xì)說明見下文

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

+訂單金額

amount

object

是

query 訂單金額信息，詳細(xì)說明見下文

參數(shù)名

變量

類型

必填

描述

訂單金額

total

int

是

訂單總金額，幣種的最小單位，只能為整數(shù)，詳見交易金額
示例值：888

貨幣類型

currency

string(16)

否

符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，
示例值：CNY

用戶支付金額

payer_total

int

是

用戶實(shí)際支付金額，幣種的最小單位，只能為整數(shù)，詳見交易金額
示例值：888

支付貨幣類型

payer _currency

string(16)

否

符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼
示例值：CNY

+ 匯率

exchange_rate

object

否

匯率信息

參數(shù)名	變量	類型	必填	描述
匯率類型	type	string(32)	否	SETTLEMENT_RATE,即標(biāo)價(jià)幣種和結(jié)算幣種的匯率示例值：SETTLEMENT_RATE
匯率值	rate	int	否	rate值是兌換比例乘以10的8次方。如果標(biāo)價(jià)幣種和結(jié)算幣種一致，兌換比例是1，則rate=100000000；如果標(biāo)價(jià)幣種和結(jié)算幣種不一致，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：80000000

+ 優(yōu)惠功能

promotion_detail

array

否

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

參數(shù)名

變量

類型

必填

描述

券ID

promotion_id

string(32)

是

券或者立減優(yōu)惠id
示例值：109519

優(yōu)惠名稱

name

string(64)

否

優(yōu)惠名稱
示例值：單品惠-6

優(yōu)惠范圍

scope

string(32)

否

GLOBAL- 全場代金券
SINGLE- 單品優(yōu)惠
示例值：SINGLE

優(yōu)惠類型

type

string(32)

否

COUPON- 代金券，需要走結(jié)算資金的充值型代金券,（境外商戶券幣種與支付幣種一致）
DISCOUNT- 優(yōu)惠券，不走結(jié)算資金的免充值型優(yōu)惠券，（境外商戶券幣種與標(biāo)價(jià)幣種一致
示例值：DISCOUNT

優(yōu)惠券面額

amount

int

是

用戶享受優(yōu)惠的金額
示例值：5

貨幣類型

currency

string(16)

否

符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼
示例值：CNY

活動(dòng)ID

activity_id

string(32)

否

在微信商戶后臺(tái)配置的批次ID
示例值：931386

微信出資

wechatpay_contribute_amount

int

否

特指由微信支付商戶平臺(tái)創(chuàng)建的優(yōu)惠，出資金額等于本項(xiàng)優(yōu)惠總金額
示例值：0

商戶出資

merchant_contribute_amount

int

否

特指商戶自己創(chuàng)建的優(yōu)惠，出資金額等于本項(xiàng)優(yōu)惠總金額
示例值：0

其他出資

other_contribute_amount

int

否

其他出資方出資金額
示例值：5

+ 單品列表

goods_detail

Array

否

單品信息，使用Json格式

參數(shù)名	變量	類型	必填	描述
商品編碼	goods_id	string(32)	是	由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成示例值：商品編碼
商品備注	goods_remark	string(128)	否	goods_remark為備注字段，按照配置原樣返回，字段內(nèi)容在微信后臺(tái)配置券時(shí)進(jìn)行設(shè)置。示例值：1001
商品數(shù)量	quantity	int	是	用戶購買的數(shù)量示例值：1
商品價(jià)格	price	int	是	單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(jià)(例如：用戶對(duì)一筆100元的訂單使用了商場發(fā)的紙質(zhì)優(yōu)惠券100-50，則活動(dòng)商品的單價(jià)應(yīng)為原單價(jià)-50) 示例值：528800

注意：goods_remark為備注字段，按照配置原樣返回，goods_tag是訂單優(yōu)惠標(biāo)記，用于區(qū)分訂單是否可以享受優(yōu)惠，兩個(gè)字段內(nèi)容都在微信后臺(tái)配置券時(shí)進(jìn)行設(shè)置。

異常返回

參數(shù)名

變量

類型

必填

描述

返回狀態(tài)碼

code

string(32)

是

錯(cuò)誤碼，枚舉值見錯(cuò)誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string(256)

是

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

+ 詳細(xì)的錯(cuò)誤描述

detail

object

否

當(dāng)code為PARAM_ERROR時(shí)返回，詳細(xì)說明見下

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

返回示例：

{
    "id": "1008450740201411110005820873",
    "sp_appid": "wx2421b1c4370ec43b",
    "sub_appid": "",
    "sp_mchid": "10000100",
    "sub_mchid": "20000100",
    "out_trade_no": "20150806125346",
    "payer": {
      "sp_openid": "oUpF8uN95-Ptaags6E_roPHg7AG0",
      "sub_openid" : ""
    },
    "amount" : {
        "total": 528800,
        "currency": "HKD",
        "payer_total": 518799,
        "payer_currency": "CNY",
        "exchange_rate" : {
            "type": "SETTLEMENT_RATE",
            "rate": 80000000
        }
    },
    "trade_type": "MICROPAY",
    "trade_status": "SUCCESS",
    "trade_state_desc": "支付成功",
    "bank_type": "CCB_DEBIT",
    "attach": "支付測試",
    "success_time": "2018-06-08T10:34:56+08:00",
    "promotion_detail":[
        {
            "promotion_id":"109519",
            "name":"單品惠-6",
            "scope":"SINGLE",
            "type":"DISCOUNT",
            "amount":1,
            "currency": "CNY",
            "activity_id":"931386",
            "wechatpay_contribute_amount":1,
            "merchant_contribute_amount":0,
            "other_contribute_amount":0,
            "goods_detail":[
                {
                    "goods_id":"iphone6s_16G",
                    "goods_remark":"商品備注",
                    "quantity":1,
                    "price":528800
                }
            ]
        }
    ]
}

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

錯(cuò)誤碼

錯(cuò)誤碼	描述	解決方案
INVALID_REQUEST	無效請(qǐng)求	請(qǐng)根據(jù)接口返回的詳細(xì)錯(cuò)誤描述信息檢查您的程序
TRADE_ERROR	交易失敗	提示用戶更換支付方式
SYSTEMERROR	系統(tǒng)錯(cuò)誤	請(qǐng)用原請(qǐng)求參數(shù)再次調(diào)用支付接口以確認(rèn)結(jié)果。如果持續(xù)返回SYSTEMERROR，請(qǐng)調(diào)用撤銷接口，并告知用戶更換支付方式。
PARAM_ERROR	請(qǐng)求參數(shù)錯(cuò)誤	請(qǐng)根據(jù)接口返回的詳細(xì)錯(cuò)誤描述信息檢查您的程序
NOTENOUGH	余額不足	提示用戶余額不足或更換支付方式
AUTH_CODE_INVALID	付款碼無效	請(qǐng)檢查是否是微信的付款碼。然后更換out_trade_no和付款碼后再次發(fā)起支付。

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

付款碼支付

提交付款碼支付

接口說明

請(qǐng)求參數(shù)

請(qǐng)求示例：

返回參數(shù)

正常返回

異常返回

返回示例：

錯(cuò)誤碼

版本說明