微信支付-開發(fā)者文檔

返回上一層文檔首頁(yè) / 合單JSAPI下單API

合單JSAPI下單API

最新更新時(shí)間：2023.03.10 版本說(shuō)明

使用合單支付接口，用戶只輸入一次密碼，即可完成多個(gè)訂單的支付。目前最多一次可支持50筆訂單進(jìn)行合單支付。

注意：

? 訂單如果需要進(jìn)行抽傭等，需要在合單中指定需要進(jìn)行分賬（profit_sharing為true）；指定后，交易資金進(jìn)入二級(jí)商戶賬戶，處于凍結(jié)狀態(tài)，系統(tǒng)默認(rèn)凍結(jié)180天，可在后續(xù)使用分賬接口進(jìn)行分賬，利用分賬完結(jié)進(jìn)行資金解凍，實(shí)現(xiàn)抽傭和對(duì)二級(jí)商戶的賬期。

接口說(shuō)明

適用對(duì)象：電商平臺(tái) 服務(wù)商

請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/combine-transactions/jsapi

請(qǐng)求方式：POST

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

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

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

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

參數(shù)名

變量

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

必填

描述

合單商戶appid

combine_appid

string[1,32]

是

body 合單發(fā)起方的appid。
示例值：wxd678efh567hg6787

合單商戶號(hào)

combine_mchid

string[1,32]

是

body 合單發(fā)起方商戶號(hào)，服務(wù)商和電商模式下，傳服務(wù)商商戶號(hào)。
示例值：1900000109

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

combine_out_trade_no

string[1,32]

是

body 合單支付總訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫字母_-|*@ ，且在同一個(gè)商戶號(hào)下唯一。
示例值：P20150806125346

+場(chǎng)景信息

scene_info

object

否

body 支付場(chǎng)景信息描述

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
商戶端設(shè)備號(hào)	device_id	string[7,16]	否	終端設(shè)備號(hào)（門店號(hào)或收銀設(shè)備ID）。示例值：POS1:123
用戶終端IP	payer_client_ip	string[1,45]	是	用戶的客戶端IP，支持IPv4和IPv6兩種格式的IP地址。格式: ip(ipv4+ipv6) 示例值：14.17.22.32

+子單信息

sub_orders

array

是

body 最多支持子單條數(shù)：50

參數(shù)名

變量

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

必填

描述

子單商戶號(hào)

mchid

string[1,32]

是

子單發(fā)起方商戶號(hào)，必須與發(fā)起方appid有綁定關(guān)系。
示例值：1900000109

附加數(shù)據(jù)

attach

string[1,128]

是

附加數(shù)據(jù)，在查詢API和支付通知中原樣返回，可作為自定義參數(shù)使用。
示例值：深圳分店

+訂單金額

amount

object

是

訂單金額

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
標(biāo)價(jià)金額	total_amount	int64	是	子單金額，單位為分。境外場(chǎng)景下，標(biāo)價(jià)金額要超過(guò)商戶結(jié)算幣種的最小單位金額，例如結(jié)算幣種為美元，則標(biāo)價(jià)金額必須大于1美分示例值：100
標(biāo)價(jià)幣種	currency	string[1,8]	是	符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，人民幣：CNY。示例值：CNY

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

out_trade_no

string[6,32]

是

商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫字母_-|*@ ，且在同一個(gè)商戶號(hào)下唯一。
示例值：20150806125346

訂單優(yōu)惠標(biāo)記

goods_tag

string[1,32]

否

訂單優(yōu)惠標(biāo)記，使用代金券或立減優(yōu)惠功能時(shí)需要的參數(shù)，說(shuō)明詳見(jiàn)代金券或立減優(yōu)惠
示例值：WXG

二級(jí)商戶號(hào)

sub_mchid

string[1,32]

是

服務(wù)商子商戶的商戶號(hào)，被合單方。直連商戶不用傳二級(jí)商戶號(hào)
示例值：1900000109

商品描述

description

string[1,127]

是

商品簡(jiǎn)單描述。需傳入應(yīng)用市場(chǎng)上的APP名字-實(shí)際商品名稱，例如：天天愛(ài)消除-游戲充值。
示例值：騰訊充值中心-QQ會(huì)員充值

+結(jié)算信息

settle_info

Object

否

結(jié)算信息

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
是否指定分賬	profit_sharing	boolean	否	是否指定分賬，枚舉值： true：是 false：否示例值：true
補(bǔ)差金額	subsidy_amount	int64	否	SettleInfo.profit_sharing為true時(shí)，該金額才生效。注意：?jiǎn)喂P訂單最高補(bǔ)差金額為10000元示例值：10

子商戶應(yīng)用ID

sub_appid

string[1,32]

否

子商戶申請(qǐng)的應(yīng)用ID，全局唯一。請(qǐng)求基礎(chǔ)下單接口時(shí)請(qǐng)注意APPID的應(yīng)用屬性，例如公眾號(hào)場(chǎng)景下，需使用應(yīng)用屬性為公眾號(hào)的APPID 若sub_openid有傳的情況下，sub_appid必填，且sub_appid需與sub_openid對(duì)應(yīng)
示例值：wxd678efh567hg6999

+支付者

combine_payer_info

object

是

body 支付者信息

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
用戶標(biāo)識(shí)	openid	string[1,128]	二選一	使用合單appid獲取的對(duì)應(yīng)用戶openid。是用戶在商戶appid下的唯一標(biāo)識(shí)。獲取用戶openid指引示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶子標(biāo)識(shí)	sub_openid	string[1, 128]	二選一	服務(wù)商模式下，使用某個(gè)子商戶的Appid獲取的對(duì)應(yīng)用戶Openid，是用戶在該子商戶Appid下的唯一標(biāo)識(shí)。openid和sub_openid可以選傳其中之一，如果選擇傳sub_openid，則必須傳sub_appid。示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

交易起始時(shí)間

time_start

string[1,14]

否

body 訂單生成時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。
示例值：2019-12-31T15:59:59+08:00

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

time_expire

string[1,14]

否

body 訂單失效時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。
示例值：2019-12-31T15:59:59+08:00

通知地址

notify_url

string[1,256]

是

body 接收微信支付異步通知回調(diào)地址，通知url必須為直接可訪問(wèn)的URL，不能攜帶參數(shù)。
格式: URL
示例值：https://yourapp.com/notify

請(qǐng)求示例

JSON


{
	"combine_out_trade_no": "20150806125346",
	"combine_mchid": "1900000109",
	"combine_appid": "wxd678efh567hg6787",
	"scene_info": {
		"device_id": "POS1:123",
		"payer_client_ip": "14.17.22.32"
	},
	"sub_orders": [{
		"mchid": "1900000109",
		"attach": "深圳分店",
		"amount": {
			"total_amount": 10,
			"currency": "CNY"
		},
		"out_trade_no": "20150806125346",
		"sub_mchid": "1230000109",
		"description": "騰訊充值中心-QQ會(huì)員充值"
	}],
	"combine_payer_info": {
		"openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
	},
	"time_start": "2019-12-31T15:59:59+08:00",
	"time_expire": "2019-12-31T16:59:59+08:00",
	"notify_url": "https://yourapp.com/notify"
}

    
｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
預(yù)支付交易會(huì)話標(biāo)識(shí)	prepay_id	string[1,64]	是	數(shù)字和字母。微信生成的預(yù)支付會(huì)話標(biāo)識(shí)，用于后續(xù)接口調(diào)用使用，該值有效期為2小時(shí)。示例值：wx201410272009395522657a690389285100

返回示例

正常示例


{
 "prepay_id": "wx201410272009395522657a690389285100"
}


    http://2323weixin.qq.com

錯(cuò)誤碼公共錯(cuò)誤碼

狀態(tài)碼	錯(cuò)誤碼	描述	解決方案
202	USERPAYING	用戶支付中，需要輸入密碼	等待5秒，然后調(diào)用被掃訂單結(jié)果查詢API，查詢當(dāng)前訂單的不同狀態(tài)，決定下一步的操作
403	TRADE_ERROR	交易錯(cuò)誤	因業(yè)務(wù)原因交易失敗，請(qǐng)查看接口返回的詳細(xì)信息
500	SYSTEMERROR	系統(tǒng)錯(cuò)誤	系統(tǒng)異常，請(qǐng)用相同參數(shù)重新調(diào)用
401	SIGN_ERROR	簽名錯(cuò)誤	請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求
403	RULELIMIT	業(yè)務(wù)規(guī)則限制	因業(yè)務(wù)規(guī)則限制請(qǐng)求頻率，請(qǐng)查看接口返回的詳細(xì)信息
400	PARAM_ERROR	參數(shù)錯(cuò)誤	請(qǐng)根據(jù)接口返回的詳細(xì)信息檢查請(qǐng)求參數(shù)
403	OUT_TRADE_NO_USED	商戶訂單號(hào)重復(fù)	請(qǐng)核實(shí)商戶訂單號(hào)是否重復(fù)提交
404	ORDERNOTEXIST	訂單不存在	請(qǐng)檢查訂單是否發(fā)起過(guò)交易
400	ORDER_CLOSED	訂單已關(guān)閉	當(dāng)前訂單已關(guān)閉，請(qǐng)重新下單
500	OPENID_MISMATCH	openid和appid不匹配	請(qǐng)確認(rèn)openid和appid是否匹配
403	NOAUTH	商戶無(wú)權(quán)限	請(qǐng)商戶前往申請(qǐng)此接口相關(guān)權(quán)限
400	MCH_NOT_EXISTS	商戶號(hào)不存在	請(qǐng)檢查商戶號(hào)是否正確
500	INVALID_TRANSACTIONID	訂單號(hào)非法	請(qǐng)檢查微信支付訂單號(hào)是否正確
400	INVALID_REQUEST	無(wú)效請(qǐng)求	請(qǐng)根據(jù)接口返回的詳細(xì)信息檢查
429	FREQUENCY_LIMITED	頻率超限	請(qǐng)降低請(qǐng)求接口頻率
500	BANKERROR	銀行系統(tǒng)異常	銀行系統(tǒng)異常，請(qǐng)用相同參數(shù)重新調(diào)用
400	APPID_MCHID_NOT_MATCH	appid和mch_id不匹配	請(qǐng)確認(rèn)appid和mch_id是否匹配
403	ACCOUNTERROR	賬號(hào)異常	用戶賬號(hào)異常，無(wú)需更多操作

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

微信支付合作伙伴平臺(tái)

合單JSAPI下單API

注意：

接口說(shuō)明

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

請(qǐng)求示例

返回參數(shù)

返回示例

錯(cuò)誤碼公共錯(cuò)誤碼