微信支付-跨境開(kāi)發(fā)者中心

1. 接口說(shuō)明

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

請(qǐng)求URL: https://apihk.mch.weixin.qq.com/v3/global/transactions/native

請(qǐng)求方式: POST

頻率限制:150qps

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

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

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

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

參數(shù)名

變量

類(lèi)型[長(zhǎng)度限制]

必填

描述

商戶(hù)號(hào)

mchid

string[1, 32]

是

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

APPID

appid

string[1, 32]

是

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

子商戶(hù)號(hào)

sub_mchid

string[1, 32]

是

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

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

sp_mchid

string[1, 32]

是

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

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

sp_appid

string[1, 32]

是

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

子商戶(hù)APPID

sub_appid

string[1, 32]

否

Body子商戶(hù)在微信開(kāi)放平臺(tái)申請(qǐng)移動(dòng)應(yīng)用對(duì)應(yīng)的APPID
注意：僅適用于機(jī)構(gòu)模式
示例值：wx8888888888888888

商品描述

description

string[1, 127]

是

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

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

attach

string[1, 127]

否

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

通知地址

notify_url

string[1,256]

是

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

商戶(hù)訂單號(hào)

out_trade_no

string[1, 32]

是

Body商戶(hù)系統(tǒng)內(nèi)部的訂單號(hào),32個(gè)字符內(nèi)、可包含字母；重新下單時(shí)請(qǐng)更換單號(hào)，其他說(shuō)明見(jiàn)商戶(hù)訂單號(hào)
示例值：1217752501201407033233368018

商品標(biāo)記

goods_tag

string[1, 32]

否

Body商品標(biāo)記
示例值：WXG

交易類(lèi)型

trade_type

string[1, 16]

是

BodyJSAPI：公眾號(hào)支付
NATIVE：掃碼支付
APP：App支付
MWEB：H5支付
MICROPAY：付款碼支付
示例值：NATIVE

指定支付方式

limit_pay

string[1, 32]

否

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

交易起始時(shí)間

time_start

string[1,64]

否

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

交易結(jié)束時(shí)間

time_expire

string[1,64]

否

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

MCC碼

merchant_category_code

string[1, 16]

是

Body商戶(hù)行業(yè)編碼，值列表詳見(jiàn)商戶(hù)行業(yè)編碼
示例值：4111

支付者

payer

object

否

Body支付者信息，詳細(xì)說(shuō)明見(jiàn)下文

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

收起

訂單金額

amount

object

是

Body訂單金額信息，詳細(xì)說(shuō)明見(jiàn)下文

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
總金額	total	int	是	訂單總金額，幣種的最小單位，只能為整數(shù)，詳見(jiàn)交易金額示例值：888
貨幣類(lèi)型	currency	string[1, 16]	是	符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼示例值：HKD

收起

場(chǎng)景信息

scene_info

object

否

Body場(chǎng)景信息對(duì)象，詳細(xì)說(shuō)明見(jiàn)下文

參數(shù)名

變量

類(lèi)型[長(zhǎng)度限制]

必填

描述

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

device_id

string[1, 32]

否

終端設(shè)備號(hào)(商戶(hù)自定義，如門(mén)店編號(hào))
示例值：013467007045764

商戶(hù)端設(shè)備IP

device_ip

string[1, 40]

否

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

用戶(hù)終端IP

payer_client_ip

string[1, 40]

否

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

操作員ID

operator_id

string[1, 32]

否

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

商戶(hù)門(mén)店信息

store_info

object

否

Body門(mén)店信息對(duì)象，詳細(xì)說(shuō)明見(jiàn)下文

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
編號(hào)	id	string[1, 32]	否	商戶(hù)側(cè)門(mén)店ID 示例值：0001
名稱(chēng)	name	string[1, 32]	是	商戶(hù)側(cè)門(mén)店名稱(chēng) 示例值：騰訊大廈分店
詳細(xì)地址	address	string[1, 64]	是	詳細(xì)的商戶(hù)門(mén)店地址示例值：廣東省深圳市南山區(qū)科技中一道10000號(hào)

收起

優(yōu)惠功能

detail

object

否

Body優(yōu)惠功能信息，詳細(xì)說(shuō)明見(jiàn)下文

參數(shù)名

變量

類(lèi)型[長(zhǎng)度限制]

必填

描述

訂單原價(jià)

cost_price

int

否

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

商品小票ID

receipt_id

string[1, 32]

否

商家小票ID
示例值：wx123

單品列表

goods_detail

Array

否

Body單品信息，使用Json格式

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

收起

請(qǐng)求示例

機(jī)構(gòu)模式直連模式


{
    "sp_appid": "wxdace645e0bc2c424",
    "sp_mchid": "10000100",
    "sub_mchid": "20000100",
    "out_trade_no": "YX201710140020Z",
    "merchant_category_code": "4111",
    "notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
    "trade_type": "NATIVE",
    "amount": {
        "total": 10,
        "currency": "HKD"
    },
    "attach": "QR code test",
    "description": "QR code test",
    "goods_tag": "001",
    "detail": {
        "cost_price": 10000,
        "receipt_id": "1234",
        "goods_detail": [
            {
                "goods_id": "iphone6s_16G",
                "wxpay_goods_id": "1001",
                "goods_name": "iPhone6s 16G",
                "quantity": 1,
                "price": 10
            }
        ]
    },
    "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": "YX202111100020Z",
	"merchant_category_code": "4111",
	"notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
	"trade_type": "NATIVE",
	"amount": {
		"total": 10,
		"currency": "HKD"
	},
	"attach": "QR code test",
	"description": "QR code test",
	"goods_tag": "001",
	"detail": {
		"cost_price": 10000,
		"receipt_id": "1234",
		"goods_detail": [{
			"goods_id": "iphone6s_16G",
			"wxpay_goods_id": "1001",
			"goods_name": "iPhone6s 16G",
			"quantity": 1,
			"price": 10
		}]
	},
	"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"
		}
	}
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回參數(shù)

正常返回

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
二維碼鏈接	code url	string[1,64]	是	用于生成二維碼，展示給用戶(hù)進(jìn)行掃碼支付示例值：weixin://wxpay/s/An4baqw

異常返回

參數(shù)名

變量

類(lèi)型[長(zhǎng)度限制]

必填

描述

返回狀態(tài)碼

code

string[1, 32]

是

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

返回信息

message

string[1, 256]

是

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

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

detail

object

否

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

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

收起

返回示例

正常示例異常示例


{
    "code url": "weixin://wxpay/s/An4baqw"
}

 
{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "與ALLOF schema不符",
		"location": "body"
	}
}

4. 錯(cuò)誤碼

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

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類(lèi)產(chǎn)品

其他產(chǎn)品

Native支付下單API

1. 接口說(shuō)明

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

請(qǐng)求示例

3. 返回參數(shù)

正常返回

異常返回

返回示例

4. 錯(cuò)誤碼