API字典 / 分賬 / 分賬標記API

分賬標記API

最新更新時間：2022.08.04 版本說明

商戶在下單之前，調(diào)用該API來標記該筆商戶訂單后續(xù)會使用資金分賬功能，在支付完成后該筆訂單款項會被凍結(jié)在商戶賬戶中，等待商戶的分賬指令或解凍剩余資金指令來執(zhí)行資金的分發(fā)。

注意：

? 該接口須在商戶調(diào)用下單接口之前調(diào)用，否則分賬標記可能無效（無效是指該筆訂單后續(xù)無法使用資金分賬功能）；

? 該接口中參數(shù)須和商戶下單接口中相關(guān)參數(shù)（二級商戶號/商戶訂單號/訂單標價金額）保持一致，否則分賬標記將無效；

? 在用戶支付完成后即會觸發(fā)對該筆分賬支付單的資金凍結(jié)流程，建議商戶可在3~5min后通過【查詢剩余待分金額API】來確認該筆訂單是否可執(zhí)行分賬（注：可分賬的訂單會返回當前剩余待分賬金額，若不能分賬的訂單，會返回錯誤提示）。

1. 接口說明

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

請求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/transactions/mark

請求方式：POST

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

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

Body指該參數(shù)需在請求JSON傳參

參數(shù)名	變量	類型[長度限制]	必填	描述
二級商戶號	sub_mchid	string[1, 32]	否	Body微信支付分配的商戶號，請與微信支付訂單的二級商戶號保持一致。（直連商戶不需要，服務(wù)商/機構(gòu)模式下必填）示例值：1900000109
商戶訂單號	out_trade_no	string[6, 32]	是	Body需要標記的商戶訂單號，請和下單參數(shù)中的商戶訂單號保持一致。示例值：P20150806125346
訂單標價幣種	currency	string[1, 10]	是	Body訂單標價幣種，目前只支持人民幣標價的訂單進行分賬，"CNY". 示例值：CNY

JSON


{
  "currency": "CNY",
  "out_trade_no": "P20150806125346",
  "sub_mchid": "1900000109"
}


									{
										"stock_id": "PHP",
										"stock_creator_mchid": "123456",
										"offset": 10,
										"limit": 10,
									}


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


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

處理成功，應(yīng)答無內(nèi)容

正常示例


    204
    處理成功，應(yīng)答無內(nèi)容


									{
示例代碼
									}

狀態(tài)碼	錯誤碼	描述	解決方案
400	INVALID_REQUEST	需要分賬的訂單，標價幣種目前只支持CNY	修改標記幣種為CNY，再重新發(fā)起調(diào)用
400	INVALID_REQUEST	該訂單已經(jīng)確認不能分賬，請在下單前調(diào)用分賬標記API	請參照接入指引，按照業(yè)務(wù)流程發(fā)起調(diào)用
403	NO_AUTH	商戶未簽約境外分賬產(chǎn)品能力	請參考產(chǎn)品流程和接入準備，確認商戶具有分賬權(quán)限后再發(fā)起請求
403	NO_AUTH	商戶已開通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效)	開通分賬產(chǎn)品能力當天不能發(fā)起分賬，請等待第二天后發(fā)起請求
403	NO_AUTH	分賬接收方境外權(quán)限被處罰	請確認分賬接收方均合法合規(guī)后，請發(fā)起分賬請求
403	NO_AUTH	商戶父子關(guān)系不存在，請使用正確的二級商戶號發(fā)起請求	請檢查二級商戶號(sub_mchid)是否填寫正確

頁面導(dǎo)航

語言