最新更新時(shí)間：2022.04.11 版本說(shuō)明
商戶在下單之前，調(diào)用該API來(lái)標(biāo)記該筆商戶訂單后續(xù)會(huì)使用資金分賬功能，在支付完成后該筆訂單款項(xiàng)會(huì)被凍結(jié)在商戶賬戶中，等待商戶的分賬指令或解凍剩余資金指令來(lái)執(zhí)行資金的分發(fā)。
? 該接口須在商戶調(diào)用下單接口之前調(diào)用，否則分賬標(biāo)記可能無(wú)效（無(wú)效是指該筆訂單后續(xù)無(wú)法使用資金分賬功能）；
? 該接口中參數(shù)須和商戶下單接口中相關(guān)參數(shù)（二級(jí)商戶號(hào)/商戶訂單號(hào)/訂單標(biāo)價(jià)金額）保持一致，否則分賬標(biāo)記將無(wú)效；
? 在用戶支付完成后即會(huì)觸發(fā)對(duì)該筆分賬支付單的資金凍結(jié)流程，建議商戶可在3~5min后通過(guò)【查詢(xún)剩余待分金額API】來(lái)確認(rèn)該筆訂單是否可執(zhí)行分賬（注：可分賬的訂單會(huì)返回當(dāng)前剩余待分賬金額，若不能分賬的訂單，會(huì)返回錯(cuò)誤提示）。
適用對(duì)象： 直連模式 機(jī)構(gòu)模式
請(qǐng)求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/transactions/mark
請(qǐng)求方式：post
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類(lèi)型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 否 | body微信支付分配的商戶號(hào)，請(qǐng)與微信支付訂單的二級(jí)商戶號(hào)保持一致。（直連商戶不需要，服務(wù)商/機(jī)構(gòu)模式下必填） 示例值：1900000109 |
| 商戶訂單號(hào) | out_trade_no | string[6, 32] | 是 | body需要標(biāo)記的商戶訂單號(hào)，請(qǐng)和下單參數(shù)中的商戶訂單號(hào)保持一致。 示例值：P20150806125346 |
| 訂單標(biāo)價(jià)幣種 | currency | string[1, 10] | 是 | body訂單標(biāo)價(jià)幣種，目前只支持人民幣標(biāo)價(jià)的訂單進(jìn)行分賬，"CNY". 示例值：CNY |
{
"currency": "CNY",
"out_trade_no": "P20150806125346",
"sub_mchid": "1900000109"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 需要分賬的訂單，標(biāo)價(jià)幣種目前只支持CNY | 修改標(biāo)記幣種為CNY，再重新發(fā)起調(diào)用 |
| 400 | INVALID_REQUEST | 該訂單已經(jīng)確認(rèn)不能分賬，請(qǐng)?jiān)谙聠吻罢{(diào)用分賬標(biāo)記API | 請(qǐng)參照接入指引，按照業(yè)務(wù)流程發(fā)起調(diào)用 |
| 403 | NO_AUTH | 商戶未簽約境外分賬產(chǎn)品能力 | 請(qǐng)參考產(chǎn)品流程和接入準(zhǔn)備，確認(rèn)商戶具有分賬權(quán)限后再發(fā)起請(qǐng)求 |
| 403 | NO_AUTH | 商戶已開(kāi)通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效) | 開(kāi)通分賬產(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)是否填寫(xiě)正確 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證