微信支付境外文檔-分賬

解凍剩余資金API

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

不需要進(jìn)行分賬的訂單，可直接調(diào)用本接口將訂單的金額全部解凍給訂單出資方賬戶(hù)（原訂單資金結(jié)算賬戶(hù)）；調(diào)用分賬接口后，需要解凍剩余資金時(shí)，可調(diào)用本接口將剩余的未分賬金額全部解凍給訂單出資方賬戶(hù)。

注意：

? 此接口采用異步處理模式，即在接收到商戶(hù)請(qǐng)求后，會(huì)先受理請(qǐng)求再異步處理，最終的分賬結(jié)果可以通過(guò)查詢(xún)分賬接口獲取；

? 該接口返回成功后，解凍出境的金額將和非分賬訂單金額一起參與軋差結(jié)算，與商戶(hù)的結(jié)算合同中的相關(guān)結(jié)算周期、起結(jié)點(diǎn)等提現(xiàn)規(guī)則保持一致；

? 出資方指和微信支付發(fā)生實(shí)際結(jié)算、資金入賬的商戶(hù)；在境外機(jī)構(gòu)商模式下為機(jī)構(gòu)商戶(hù)、在服務(wù)商模式下為二級(jí)商戶(hù)。

接口說(shuō)明

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

請(qǐng)求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/unfreeze

請(qǐng)求方式：post

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

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

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

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

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
二級(jí)商戶(hù)號(hào)	sub_mchid	string[1, 32]	否	body微信支付分配的商戶(hù)號(hào)，請(qǐng)與微信支付訂單的二級(jí)商戶(hù)號(hào)保持一致。（直連商戶(hù)不需要，服務(wù)商/機(jī)構(gòu)模式下必填）示例值：1900000109
微信支付訂單號(hào)	transaction_id	string[1, 32]	是	body微信支付訂單號(hào) 示例值：4208450740201411110007820472
商戶(hù)分賬單號(hào)	out_order_no	string[1, 64]	是	body商戶(hù)系統(tǒng)內(nèi)部的分賬單號(hào)，在商戶(hù)系統(tǒng)內(nèi)部唯一，同一分賬單號(hào)多次請(qǐng)求等同一次。只能是數(shù)字、大小寫(xiě)字母_-。注：該單號(hào)用于標(biāo)識(shí)商戶(hù)側(cè)發(fā)起的不同分賬指令請(qǐng)求（包括請(qǐng)求分賬API/解凍剩余資金API）。若需要對(duì)同一筆微信支付訂單進(jìn)行多次資金分發(fā)處理，請(qǐng)注意更換【商戶(hù)分賬單號(hào)】后再發(fā)起調(diào)用，否則會(huì)被微信支付服務(wù)視為同一請(qǐng)求重入。示例值：P20150806125346
分賬描述	description	string[1, 80]	是	body分賬的原因描述，分賬賬單中需要體現(xiàn) 示例值：解凍全部剩余資金

請(qǐng)求示例

JSON


{
  "description": "解凍全部剩余資金",
  "out_order_no": "P20150806125346",
  "sub_mchid": "1900000109",
  "transaction_id": "4208450740201411110007820472"
}


｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名

變量

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

必填

描述

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

sub_mchid

string[1, 32]

否

微信支付分配的商戶(hù)號(hào)
示例值：1900000109

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

transaction_id

string[1, 32]

是

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

商戶(hù)分賬單號(hào)

out_order_no

string[1, 64]

是

商戶(hù)分賬單號(hào)，同請(qǐng)求入?yún)ⅰ?br/> 示例值：P20150806125346

微信分賬單號(hào)

order_id

string[1, 64]

是

微信分賬單號(hào)，微信系統(tǒng)返回的唯一標(biāo)識(shí)。
示例值：3008450740201411110007820472

分賬單狀態(tài)

state

string

是

分賬單狀態(tài)（每個(gè)接收方的分賬結(jié)果請(qǐng)查看receivers中的result字段）。
PROCESSING：處理中
FINISHED：分賬完成
示例值：FINISHED

+ 分賬接收方列表

receivers

array

是

分賬接收方列表
商戶(hù)在發(fā)起分賬請(qǐng)求或解凍剩余資金請(qǐng)求時(shí)，對(duì)同一筆訂單可分給多個(gè)接收方（包括解凍給出資方），分賬明細(xì)描述了每筆分給一個(gè)接收方的資金的狀態(tài)。

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
分賬幣種	currency	string[3, 3]	是	分賬幣種，同請(qǐng)求入?yún)ⅰ?br/> 示例值：CNY
分賬金額	amount	int	是	分賬金額，同請(qǐng)求入?yún)ⅰ?br/> 示例值：100
分賬描述	description	string[1, 80]	是	商戶(hù)傳入的分賬描述，同請(qǐng)求入?yún)ⅰ?br/> 示例值：分給商戶(hù)1900000110
接收方類(lèi)型	type	string	是	接收方類(lèi)型，同請(qǐng)求入?yún)ⅰ? MERCHANT_ID：商戶(hù)號(hào) PERSONAL_OPENID：個(gè)人OpenID，由商戶(hù)APPID轉(zhuǎn)換得到 PERSONAL_SUB_OPENID：是個(gè)人Sub_OpenID，由二級(jí)商戶(hù)APPID轉(zhuǎn)換得到示例值：MERCHANT_ID
接收方賬號(hào)	account	string[1, 64]	是	接收方賬號(hào)，同請(qǐng)求入?yún)ⅰ?br/> 示例值：1900000109
分賬明細(xì)結(jié)果	result	string	是	每一筆分賬明細(xì)轉(zhuǎn)賬的結(jié)果。 PENDING：待分賬， SUCCESS：分賬成功， CLOSED：已關(guān)閉，示例值：SUCCESS
分賬明細(xì)失敗原因	fail_reason	string	否	分賬明細(xì)失敗原因。在分賬明細(xì)結(jié)果為"CLOSED"時(shí)才會(huì)被設(shè)置。 NO_RELATION：分賬關(guān)系已解除 SUB_MERCHANT_FRONEN：二級(jí)商戶(hù)被凍結(jié) MCH_CONTRACT_SETTLE_OFF：商戶(hù)結(jié)算合同為關(guān)閉結(jié)算狀態(tài) MCH_CONTRACT_FROZEN：商戶(hù)結(jié)算合同被凍結(jié) ACCOUNT_ABNORMAL：分賬接收賬戶(hù)異常 RECEIVER_HIGH_RISK：高風(fēng)險(xiǎn)接收方 RECEIVER_REAL_NAME_NOT_VERIFIED：接收方未實(shí)名 NO_AUTH：分賬權(quán)限已解除 DEFAULT_ERROR：默認(rèn)錯(cuò)誤示例值：ACCOUNT_ABNORMAL
分賬明細(xì)創(chuàng)建時(shí)間	create_time	string[1, 64]	是	分賬明細(xì)創(chuàng)建時(shí)間，遵循RFC3339標(biāo)準(zhǔn)格式示例值：2015-05-20T13:29:35.120+08:00
分賬明細(xì)完成時(shí)間	finish_time	string[1, 64]	否	分賬明細(xì)完成時(shí)間，遵循RFC3339標(biāo)準(zhǔn)格式。在分賬明細(xì)結(jié)果為"SUCCESS"或"CLOSED"時(shí)才會(huì)被設(shè)置。示例值：2015-05-20T13:29:35.120+08:00
分賬明細(xì)單號(hào)	detail_id	string[1, 64]	是	微信分賬明細(xì)單號(hào)，每筆分賬業(yè)務(wù)執(zhí)行的明細(xì)單號(hào)。示例值：36011111111111111111111
分賬明細(xì)類(lèi)型	detail_type	string	是	分賬明細(xì)分為兩類(lèi)，包括分出給其他接收方和解凍給出資方。可由該字段來(lái)區(qū)分，若明細(xì)類(lèi)型為UNFREEZE_TO_SPONSOR(解凍給出資方)時(shí)，分賬明細(xì)中還會(huì)返回出資方結(jié)算幣種、結(jié)算金額、匯率值等信息。 DISTRIBUTE_TO_OTHERS：分出給其他接收方 UNFREEZE_TO_SPONSOR：解凍給出資方出境示例值：DISTRIBUTE_TO_OTHERS
出資方結(jié)算幣種	settlement_currency	string[3, 3]	否	出資方的結(jié)算幣種，明細(xì)類(lèi)型為UNFREEZE_TO_SPONSOR(解凍給出資方)時(shí)該字段才會(huì)被設(shè)置。示例值：HKD
出資方結(jié)算金額	settlement_amount	int	否	該筆明細(xì)通過(guò)換匯后最終結(jié)算給出資方的金額，采用最小幣種單位。示例值：110
匯率值	rate	int	否	分賬幣種與結(jié)算幣種的兌換比例乘以10的8次方即為此值。若分賬幣種與結(jié)算幣種均為人民幣，則兌換比值為1，匯率值為100,000,000; 若結(jié)算幣種為美元，假設(shè)美元兌換人民幣的比例為6.5，則匯率值為650,000,000。示例值：81000000

返回示例

正常示例


{
    "order_id": "7100000751202203238029563456088",
    "out_order_no": "P20150806125346",
    "receivers": [
      {
        "account": "999952224",  # 出資方商戶(hù)號(hào)
        "amount": 995,
        "create_time": "2022-03-23T17:59:23+08:00",
        "currency": "CNY",
        "description": "解凍全部剩余資金",
        "detail_id": "7200000751202203238029563456171",
        "detail_type": "UNFREEZE_TO_SPONSOR",
        "rate_value": 83640300,
        "result": "PENDING",
        "settlement_amount": 1189,
        "settlement_currency": "HKD",
        "type": "MERCHANT_ID"
      }
    ],
    "state": "PROCESSING",
    "sub_mchid": "1900000109",
    "transaction_id": "4208450740201411110007820472"
  }


http://2323weixin.qq.com

錯(cuò)誤碼

狀態(tài)碼	錯(cuò)誤碼	描述	解決方案
400	INVALID_REQUEST	分賬請(qǐng)求中的商戶(hù)信息與原支付訂單商戶(hù)信息不一致	請(qǐng)仔細(xì)檢查訂單號(hào)是否填錯(cuò)、二級(jí)子商戶(hù)是否未填或填錯(cuò)
400	INVALID_REQUEST	該訂單不支持分賬	請(qǐng)檢查微信支付訂單號(hào)是否填錯(cuò)，并確認(rèn)在調(diào)用下單API之前執(zhí)行調(diào)用分賬標(biāo)記API成功
403	NO_AUTH	商戶(hù)未簽約境外分賬產(chǎn)品能力	請(qǐng)參考產(chǎn)品流程和接入準(zhǔn)備，確認(rèn)商戶(hù)具有分賬權(quán)限后再發(fā)起請(qǐng)求
403	NO_AUTH	商戶(hù)已開(kāi)通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效)	開(kāi)通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬，請(qǐng)等待第二天后發(fā)起請(qǐng)求
403	NO_AUTH	商戶(hù)父子關(guān)系不存在，請(qǐng)使用正確的二級(jí)商戶(hù)號(hào)發(fā)起請(qǐng)求	請(qǐng)檢查二級(jí)商戶(hù)號(hào)(sub_mchid)是否填寫(xiě)正確
400	INVALID_REQUEST	商戶(hù)解凍剩余資金時(shí)指令(out_order_no)已存在，且明細(xì)內(nèi)容不符合預(yù)期	若為不同分賬請(qǐng)求，請(qǐng)更換外部指令單號(hào)(out_order_no)再發(fā)起分賬請(qǐng)求
403	NOTENOUGH	請(qǐng)求分賬時(shí)校驗(yàn)到可分金額不足	可通過(guò)【查詢(xún)剩余可分金額API】來(lái)獲取訂單當(dāng)前的可分金額
500	SYSYTEMERROR	商戶(hù)發(fā)起分賬請(qǐng)求指定的微信支付訂單資金凍結(jié)流程還未完成，請(qǐng)稍后重試	用戶(hù)支付完成后即會(huì)觸發(fā)對(duì)該筆分賬支付單的資金凍結(jié)流程，建議商戶(hù)可在3~5min后重試

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

境外分賬API

解凍剩余資金API

注意：

接口說(shuō)明

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

請(qǐng)求示例

返回參數(shù)

返回示例

錯(cuò)誤碼

版本說(shuō)明