API字典 / 分賬 / 查詢剩余待分金額API

查詢剩余待分金額API

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

可調(diào)用此接口查詢微信支付訂單的剩余未分賬的金額。

1. 接口說明

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

請求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/transactions/{transaction_id}/amounts

請求方式：get

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

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

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

參數(shù)名	變量	類型[長度限制]	必填	描述
二級商戶號	sub_mchid	string[1, 32]	否	Query微信支付分配的商戶號，請與微信支付訂單的二級商戶號保持一致。（直連商戶不需要，服務(wù)商/機構(gòu)模式下必填）示例值：1900000109
微信支付訂單號	transaction_id	string[1, 32]	是	Path微信支付訂單號示例值：4208450740201411110007820472

URL


https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/transactions/4208450740201411110007820472/amounts?sub_mchid=1900000109

參數(shù)名	變量	類型[長度限制]	必填	描述
微信支付訂單號	transaction_id	string[1, 32]	是	微信支付訂單號示例值：4208450740201411110007820472
訂單剩余待分金額	unsplit_amount	int	是	訂單剩余待分金額，單位為幣種最小單位。（目前為人民幣金額，單位為分）。示例值：1000
貨幣類型	currency	string[1, 10]	是	目前只支持人民幣，"CNY". 示例值：CNY

JSON


{
  "currency": "CNY",
  "transaction_id": "4208450740201411110007820472",
  "unsplit_amount": 1000
}

狀態(tài)碼	錯誤碼	描述	解決方案
400	INVALID_REQUEST	商戶信息與訂單商戶信息不一致	請檢查外部指令單號(out_order_no)/微信支付單號(transaction_id)/二級商戶號(sub_mchid)是否填寫正確
400	INVALID_REQUEST	微信支付訂單與原指令信息不一致	請檢查外部指令單號(out_order_no)/微信支付單號(transaction_id)是否填寫正確
400	INVALID_REQUEST	該訂單不支持分賬	請檢查微信支付訂單號是否填錯，并確認在調(diào)用下單API之前執(zhí)行調(diào)用分賬標記API成功
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)是否填寫正確
500	SYSYTEM_ERROR	商戶發(fā)起分賬請求指定的微信支付訂單資金凍結(jié)流程還未完成，請稍后重試	用戶支付完成后即會觸發(fā)對該筆分賬支付單的資金凍結(jié)流程，建議商戶可在3~5min后重試

頁面導(dǎo)航