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

1. 接口說明

適用對象:直連模式機構模式

請求URL: https://apihk.mch.weixin.qq.com/v3/global/micropay/transactions/pay

請求方式: POST

頻率限制:150qps

Path指該參數為路徑參數

Query指該參數為URL參數

Body指該參數需在請求JSON傳參

2. 請求參數

參數名

變量

類型[長度限制]

必填

描述

商戶號

mchid

string[1, 32]

是

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

APPID

appid

string[1, 32]

是

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

子商戶號

sub_mchid

string[1, 32]

是

Body微信支付分配的子商戶號
注意：僅適用于機構模式
示例值：1900000109

機構商戶號

sp_mchid

string[1, 32]

是

Body微信支付分配的機構商戶號
注意：僅適用于機構模式
示例值：1900000100

機構APPID

sp_appid

string[1, 32]

是

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

子商戶APPID

sub_appid

string[1, 32]

否

Body子商戶在微信開放平臺申請移動應用對應的APPID
注意：僅適用于機構模式
示例值：wx8888888888888888

商品描述

description

string[1, 127]

是

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

商戶數據

attach

string[1, 127]

否

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

商戶訂單號

out_trade_no

string[1, 32]

是

Body商戶系統(tǒng)內部的訂單號,32個字符內、可包含字母；重新下單時請更換單號，其他說明見商戶訂單號
示例值：1217752501201407033233368018

商品標記

goods_tag

string[1, 32]

否

Body商品標記
示例值：WXG

交易類型

trade_type

string[1, 16]

是

BodyMICROPAY：刷卡支付
示例值：MICROPAY

指定支付方式

limit_pay

string[1, 32]

否

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

MCC碼

merchant_category_code

string[1, 16]

是

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

支付者

payer

object

是

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

參數名	變量	類型[長度限制]	必填	描述
授權碼	auth_code	string[1, 128]	是	掃碼支付授權碼，即用戶打開微信錢包顯示的碼? 示例值：120061098828009406

收起

訂單金額

amount

object

是

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

參數名	變量	類型[長度限制]	必填	描述
總金額	total	int	是	訂單總金額，幣種的最小單位，只能為整數，詳見交易金額示例值：888
貨幣類型	currency	string[1, 16]	是	符合ISO 4217標準的三位字母代碼示例值：HKD

收起

場景信息

scene_info

object

否

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

參數名

變量

類型[長度限制]

必填

描述

商戶端設備號

device_id

string[1, 32]

否

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

商戶端設備IP

device_ip

string[1, 40]

否

商戶側設備IP，取公網出口IP，支持IPV6
示例值：128.0.0.1

用戶終端IP

payer_client_ip

string[1, 40]

否

用戶側設備IP，取公網出口IP，支持IPV6
示例值：128.0.0.1

操作員ID

operator_id

string[1, 32]

否

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

商戶門店信息

store_info

object

否

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

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

收起

優(yōu)惠功能

detail

array

否

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

參數名

變量

類型[長度限制]

必填

描述

訂單原價

cost_price

int

否

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

商品小票ID

receipt_id

string[1, 32]

否

商家小票ID
示例值：wx123

單品列表

goods_detail

Array

否

Body單品信息，使用Json格式

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

收起

請求示例

機構模式直連模式


{
	"sp_appid": "wxdace645e0bc2c424",
	"sp_mchid": "10000100",
	"sub_mchid": "20000100",
	"out_trade_no": "20150806125346",
	"merchant_category_code": "4111",
	"payer": {
		"auth_code": "134650720866361395"
	},
	"trade_type": "MICROPAY",
	"amount": {
		"total": 1,
		"currency": "HKD"
	},
	"attach": "Payment Test",
	"description": "Image Store - Tencent Building in Shenzhen - QQ Doll",
	"goods_tag": "1234",
	"limit_pay": "no_credit",
	"detail": [{
		"cost_price": 1,
		"receipt_id": "1234",
		"goods_detail": [{
			"goods_id": "iphone6s_16G",
			"wxpay_goods_id": "3405",
			"goods_name": "iPhone6s 16G",
			"quantity": 1,
			"price": 1
		}]
	}],
	"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": "Tencent Building Branch",
			"address": "Nanshan District, Shenzhen, Guangdong"
		}
	}
}


{
	"appid": "wxdace645e0bc2c424",
	"mchid": "10000100",
	"out_trade_no": "20150806125346",
	"merchant_category_code": "4111",
	"payer": {
		"auth_code": "134650720866361395"
	},
	"trade_type": "MICROPAY",
	"amount": {
		"total": 1,
		"currency": "HKD"
	},
	"attach": "Payment Test",
	"description": "Image Store - Tencent Building in Shenzhen - QQ Doll",
	"goods_tag": "1234",
	"limit_pay": "no_credit",
	"detail": [{
		"cost_price": 1,
		"receipt_id": "1234",
		"goods_detail": [{
			"goods_id": "iphone6s_16G",
			"wxpay_goods_id": "3405",
			"goods_name": "iPhone6s 16G",
			"quantity": 1,
			"price": 1
		}]
	}],
	"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": "Tencent Building Branch",
			"address": "Nanshan District, Shenzhen, Guangdong"
		}
	}
}


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


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

3. 返回參數

正常返回

參數名

變量

類型[長度限制]

必填

描述

微信支付訂單號

id

string[1, 32]

是

微信支付訂單號
示例值：1217752501201407033233368018

商戶號

mchid

string[1, 32]

是

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

APPID

appid

string[1, 32]

是

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

子商戶號

sub_mchid

string[1, 32]

是

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

機構商戶號

sp_mchid

string[1, 32]

是

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

機構APPID

sp_appid

string[1, 32]

是

機構在微信公眾平臺申請服務號對應的APPID
示例值：wx8888888888888888

子商戶APPID

sub_appid

string[1, 32]

否

子商戶在微信開放平臺申請移動應用對應的APPID
示例值：wx8888888888888888

商戶訂單號

out_trade_no

string[1, 32]

是

返回的商戶訂單號
示例值：1217752501201407033233368018

交易類型

trade_type

string[1, 16]

是

刷卡支付
示例值：MICROPAY

交易狀態(tài)

trade_state

string[1, 32]

是

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

交易狀態(tài)描述

trade_state_desc

string[1, 256]

是

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

付款銀行

bank_type

string[1, 32]

是

銀行類型，采用字符串類型的銀行標識，值列表詳見銀行類型
示例值：CMC

商戶數據

attach

string(1, 127)

否

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

支付完成時間

success_time

string[1, 64]

是

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

支付者

payer

object

是

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

參數名	變量	類型[長度限制]	必填	描述
用戶標識	openid	string[1, 128]	否	用戶在商戶appid對應下的唯一標識，需要傳appid才有返回注意：僅適用于直連模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶標識（機構）	sp_openid	string[1, 128]	否	用戶在機構sp_appid對應下的唯一標識，openid和sub_openid可以選傳其中之一，如果選擇傳sub_openid,則必須傳sub_appid。下單前需要調用【網頁授權】接口獲取到用戶的openid。注意：僅適用于機構模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶標識（子商戶）	sub_openid	string[1, 128]	否	用戶在子商戶sub_appid下用戶唯一標識，openid和sub_openid可以選傳其中之一，如果選擇傳sub_openid,則必須傳sub_appid。下單前需要調用【網頁授權】接口獲取到用戶的openid，注意：僅適用于機構模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

收起

訂單金額

amount

object

是

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

參數名

變量

類型[長度限制]

必填

描述

訂單金額

total

int

是

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

貨幣類型

currency

string[1, 16]

否

符合ISO 4217標準的三位字母代碼。
示例值：CNY

用戶支付金額

payer_total

int

是

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

支付貨幣類型

payer_currency

string[1, 16]

否

符合ISO 4217標準的三位字母代碼
示例值：888

匯率

exchange_rate

object

否

匯率信息

參數名	變量	類型[長度限制]	必填	描述
匯率類型	type	string[1, 16]	否	SETTLEMENT_RATE,即標價幣種和結算幣種的匯率示例值：SETTLEMENT_RATE
匯率值	rate	int	否	rate值是兌換比例乘以10的8次方。如果標價幣種和結算幣種一致，兌換比例是1，則rate=100000000；如果標價幣種和結算幣種不一致，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：80000000

收起

優(yōu)惠功能

promotion_detail

Object

否

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

參數名

變量

類型[長度限制]

必填

描述

券ID

promotion_id

string[1, 32]

是

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

優(yōu)惠名稱

name

string[1, 64]

否

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

優(yōu)惠范圍

scope

string[1, 32]

否

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

優(yōu)惠類型

type

string[1, 32]

否

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

優(yōu)惠券面額

amount

int

是

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

貨幣類型

currency

string[1, 16]

否

符合ISO 4217標準的三位字母代碼
示例值：CNY

活動ID

activity_id

string[1, 32]

否

在微信商戶后臺配置的批次ID
示例值：931386

微信出資

wechatpay_contribute_amount

int

否

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

商戶出資

merchant_contribute_amount

int

否

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

其他出資

other_contribute_amount

int

否

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

單品列表

amount

object

是

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

參數名	變量	類型[長度限制]	必填	描述
商品編碼	goods_id	string[1, 32]	是	由半角的大小寫字母、數字、中劃線、下劃線中的一種或幾種組成示例值：12345
商品備注	goods_remark	string[1, 128]	否	goods_remark為備注字段，按照配置原樣返回，字段內容在微信后臺配置券時進行設置。示例值：1001
商品數量	quantity	int	是	用戶購買的數量示例值：1
商品價格	price	int	是	單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(例如：用戶對一筆100元的訂單使用了商場發(fā)的紙質優(yōu)惠券100-50，則活動商品的單價應為原單價-50) 示例值：528800
商戶端設備號	device_id	string[1, 32]	否	終端設備號(商戶自定義，如門店編號) 示例值：013467007045764

收起

注意

goods_remark為備注字段，按照配置原樣返回，goods_tag是訂單優(yōu)惠標記，用于區(qū)分訂單是否可以享受優(yōu)惠，兩個字段內容都在微信后臺配置券時進行設置。

異常返回

參數名

變量

類型[長度限制]

必填

描述

返回狀態(tài)碼

code

string[1, 32]

是

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

返回信息

message

string[1, 256]

是

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

詳細的錯誤描述

detail

Object

否

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

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

收起

返回示例

正常示例異常示例


{
	"sp_appid": "wxdace645e0bc2c424",
	"sp_mchid": "10000100",
	"sub_mchid": "20000100",
	"out_trade_no": "20150806125346",
	"merchant_category_code": "4111",
	"payer": {
		"auth_code": "134650720866361395"
	},
	"trade_type": "MICROPAY",
	"amount": {
		"total": 1,
		"currency": "HKD"
	},
	"attach": "Payment Test",
	"description": "Image Store - Tencent Building in Shenzhen - QQ Doll",
	"goods_tag": "1234",
	"limit_pay": "no_credit",
	"promotion_detail": [{
		"cost_price": 1,
		"receipt_id": "1234",
		"goods_detail": [{
			"goods_id": "iphone6s_16G",
			"wxpay_goods_id": "3405",
			"goods_name": "iPhone6s 16G",
			"quantity": 1,
			"price": 1
		}]
	}],
	"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": "Tencent Building Branch",
			"address": "Nanshan District, Shenzhen, Guangdong"
		}
	}
}

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

4. 錯誤碼

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

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產品

資金類產品

其他產品

提交付款碼支付

1. 接口說明

2. 請求參數

請求示例

3. 返回參數

正常返回

異常返回

返回示例

4. 錯誤碼