最新更新時(shí)間:2022.04.11 版本說明
發(fā)起分賬請(qǐng)求后,可調(diào)用此接口查詢分賬結(jié)果;發(fā)起解凍剩余資金的請(qǐng)求后,可調(diào)用此接口查詢解凍剩余資金的結(jié)果。
適用對(duì)象:直連模式 機(jī)構(gòu)模式
請(qǐng)求URL:https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/{out_order_no}
請(qǐng)求方式:get
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 否 | query微信支付分配的商戶號(hào),請(qǐng)與微信支付訂單的二級(jí)商戶號(hào)保持一致。(直連商戶不需要,服務(wù)商/機(jī)構(gòu)模式下必填) 示例值:1900000109 |
微信支付訂單號(hào) | transaction_id | string[1, 32] | 是 | query微信支付訂單號(hào) 示例值:4208450740201411110007820472 |
商戶分賬單號(hào) | out_order_no | string[1, 64] | 是 | path商戶系統(tǒng)內(nèi)部的分賬單號(hào),在商戶系統(tǒng)內(nèi)部唯一(單次分賬、多次分賬、完結(jié)分賬應(yīng)使用不同的商戶分賬單號(hào)),同一分賬單號(hào)多次請(qǐng)求等同一次。只能是數(shù)字、大小寫字母_- 示例值:P20150806125346 |
https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/P20150806125346?sub_mchid=1900000109&transaction_id=4208450740201411110007820472
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 否 | 微信支付分配的商戶號(hào) 示例值:1900000109 |
微信支付訂單號(hào) | transaction_id | string[1, 32] | 是 | 微信支付訂單號(hào) 示例值:4208450740201411110007820472 |
商戶分賬單號(hào) | out_order_no | string[1, 64] | 是 | 商戶分賬單號(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 | 是 | 分賬接收方列表 商戶在發(fā)起分賬請(qǐng)求或解凍剩余資金請(qǐng)求時(shí),對(duì)同一筆訂單可分給多個(gè)接收方(包括解凍給出資方),分賬明細(xì)描述了每筆分給一個(gè)接收方的資金的狀態(tài)。 |
{
"order_id": "3008450740201411110007820472",
"out_order_no": "P20150806125346",
"receivers": [
{
"account": "1900000109",
"amount": 100,
"create_time": "2015-05-20T13:29:35.120+08:00",
"currency": "CNY",
"description": "分給商戶1900000110",
"detail_id": "36011111111111111111111",
"detail_type": "DISTRIBUTE_TO_OTHERS",
"fail_reason": "ACCOUNT_ABNORMAL",
"finish_time": "2015-05-20T13:29:35.120+08:00",
"rate": 81000000,
"result": "SUCCESS",
"settlement_amount": 110,
"settlement_currency": "HKD",
"type": "MERCHANT_ID"
}
],
"state": "FINISHED",
"sub_mchid": "1900000109",
"transaction_id": "4208450740201411110007820472"
}
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
404 | NOT_FOUND | 分賬指令不存在,請(qǐng)檢查外部指令單號(hào)(out_order_no)是否填寫正確 | 請(qǐng)檢查外部指令單號(hào)(out_order_no)是否填寫正確 |
400 | INVALID_REQUEST | 查詢分賬結(jié)果時(shí)商戶信息與原指令不一致 | 請(qǐng)檢查外部指令單號(hào)(out_order_no)/微信支付單號(hào)(transaction_id)/二級(jí)商戶號(hào)(sub_mchid)是否填寫正確 |
400 | INVALID_REQUEST | 查詢分賬結(jié)果時(shí)微信支付訂單與原指令信息不一致 | 請(qǐng)檢查外部指令單號(hào)(out_order_no)/微信支付單號(hào)(transaction_id)是否填寫正確 |
403 | NO_AUTH | 商戶未簽約境外分賬產(chǎn)品能力 | 請(qǐng)參考產(chǎn)品流程和接入準(zhǔn)備,確認(rèn)商戶具有分賬權(quán)限后再發(fā)起請(qǐng)求 |
403 | NO_AUTH | 商戶已開通分賬產(chǎn)品能力,等待生效中(一般為第二天才生效) | 開通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬,請(qǐng)等待第二天后發(fā)起請(qǐng)求 |
403 | NO_AUTH | 分賬接收方境外權(quán)限被處罰 | 請(qǐng)確認(rèn)分賬接收方均合法合規(guī)后,請(qǐng)發(fā)起分賬請(qǐng)求 |
403 | NO_AUTH | 商戶父子關(guān)系不存在,請(qǐng)使用正確的二級(jí)商戶號(hào)發(fā)起請(qǐng)求 | 請(qǐng)檢查二級(jí)商戶號(hào)(sub_mchid)是否填寫正確 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證