API字典 / 分賬（發(fā)起退款） / 查詢訂單剩余可退款金額API

查詢訂單剩余可退款金額API

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

若商戶對于一筆分賬支付訂單發(fā)起多次分賬后，可通過該API查詢該筆訂單的剩余未分的可退款金額和可使用墊付資金退款的金額。

注意：

? 一筆分賬支付訂單支付成功后，該筆訂單款項會被凍結(jié)在商戶賬戶中，商戶可通過請求分賬指令或解凍剩余資金指令來執(zhí)行分出或解凍操作，也可用于用戶退款（商戶退款A(yù)PI）。
可通過查詢剩余待分賬金額查詢到該筆訂單已被凍結(jié)、商戶可用于分出或解凍的金額（該金額為訂單結(jié)算扣除平臺交易手續(xù)費之后的金額）；
而該API提供的剩余未分可退款金額是指該筆訂單已被凍結(jié)、可用于退還給用戶的貨款金額（包含平臺退回的相應(yīng)比例的手續(xù)費）。

? 比如，若一筆訂單金額為 100 元人民幣，手續(xù)費比例為 1%，則交易手續(xù)費為 1 元。此時，該訂單的剩余待分賬金額為：99 元，剩余未分可退款為 100 元。
若商戶通過請求分賬API指定分賬出境 49.5 元，此時，該訂單的剩余待分賬金額為：99-49.5=49.5 元，剩余未分可退款金額為 49.5 + 49.5 / (100 (1 - 1%)) = 50 元（剩余待分賬金額+對應(yīng)部分應(yīng)退還的手續(xù)費），可使用墊付資金退款的金額也為: 50 元（分賬出境金額 + 對應(yīng)部分應(yīng)退還手續(xù)）

? 手續(xù)費的計算以該接口返回為準，平臺側(cè)會保證，當(dāng)一筆訂單發(fā)生全額退款時，退款退還的手續(xù)費等于原訂單支付所收手續(xù)費。

1. 接口說明

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

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

請求方式：GET

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

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

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

2. 請求參數(shù)

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

請求示例

URL


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


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


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


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

3. 返回參數(shù)

參數(shù)名	變量	類型[長度限制]	必填	描述
微信支付訂單號	transaction_id	string[1, 32]	是	微信支付訂單號示例值：4208450740201411110007820472
訂單剩余可退款金額	refundable_amount	int	是	訂單中被凍結(jié)在商戶賬戶中可用于退款的金額，單位為幣種最小單位（目前為人民幣金額，單位為分）。資金使用說明：若訂單凍結(jié)金額用于退款，則訂單剩余可分賬金額也會相應(yīng)減少。示例值：1000
貨幣類型	currency	string[1, 10]	是	目前只支持人民幣，"CNY". 示例值：CNY
訂單剩余可使用墊付資金退款的金額	funds_refundable_amount	int	否	訂單剩余可以使用【可墊付退款】額度請求退款的金額，僅已經(jīng)解凍出境部分可以使用墊付資金發(fā)起退款（目前為人民幣金額，單位為分）。資金使用說明：若訂單發(fā)起墊付退款，則訂單剩余可使用墊付資金退款的金額也相應(yīng)減少。示例值：100

返回示例

正常示例


{
  "currency": "CNY",
  "refundable_amount": 1000,
  "transaction_id": "4208450740201411110007820472"
  "funds_refundable_amount": "100"
}


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


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


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

4. 錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
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)品能力當(dāng)天不能發(fā)起分賬，請等待第二天后發(fā)起請求
403	NO_AUTH	商戶父子關(guān)系不存在，請使用正確的二級商戶號發(fā)起請求	請檢查二級商戶號(sub_mchid)是否填寫正確
400	INVALID_REQUEST	商戶信息與訂單商戶信息不一致	請檢查二級商戶號(sub_mchid)/微信支付單號(transaction_id)是否填寫正確
500	SYSYTEM_ERROR	商戶發(fā)起分賬請求指定的微信支付訂單資金凍結(jié)流程還未完成，請稍后重試	用戶支付完成后即會觸發(fā)對該筆分賬支付單的資金凍結(jié)流程，建議商戶可在3~5min后重試

頁面導(dǎo)航

語言

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類產(chǎn)品

其他產(chǎn)品

查詢訂單剩余可退款金額API

1. 接口說明

2. 請求參數(shù)

請求示例

3. 返回參數(shù)

返回示例

4. 錯誤碼