微信支付-分賬

返回上一層文檔首頁 / 查詢分賬回退結(jié)果API

查詢分賬回退結(jié)果API

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

商戶需要核實回退結(jié)果，可調(diào)用此接口查詢回退結(jié)果

注意：

? 如果分賬回退接口返回狀態(tài)為處理中，可調(diào)用此接口查詢回退結(jié)果

接口說明

適用對象：直連商戶

請求URL：https://api.mch.weixin.qq.com/v3/profitsharing/return-orders/{out_return_no}

請求方式：GET

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

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

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

請求參數(shù)

參數(shù)名	變量	類型[長度限制]	必填	描述
商戶回退單號	out_return_no	string[1,64]	是	path調(diào)用回退接口提供的商戶系統(tǒng)內(nèi)部的回退單號示例值：R20190516001
商戶分賬單號	out_order_no	string[1,64]	是	query原發(fā)起分賬請求時使用的商戶系統(tǒng)內(nèi)部的分賬單號示例值：P20190806125346

請求示例


https://api.mch.weixin.qq.com/v3/profitsharing/return-orders/R20190516001?&out_order_no=P20190806125346


｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名	變量	類型[長度限制]	必填	描述
微信分賬單號	order_id	string[1, 64]	是	原發(fā)起分賬請求時，微信返回的微信分賬單號，與商戶分賬單號一一對應(yīng)。示例值：3008450740201411110007820472
商戶分賬單號	out_order_no	string[1, 64]	是	原發(fā)起分賬請求時使用的商戶系統(tǒng)內(nèi)部的分賬單號示例值：P20150806125346
商戶回退單號	out_return_no	string[1, 64]	是	調(diào)用回退接口提供的商戶系統(tǒng)內(nèi)部的回退單號示例值：R20190516001
微信回退單號	return_id	string[1, 64]	是	微信分賬回退單號，微信支付系統(tǒng)返回的唯一標(biāo)識示例值：3008450740201411110007820472
回退商戶號	return_mchid	string[1, 32]	是	只能對原分賬請求中成功分給商戶接收方進(jìn)行回退示例值：86693852
回退金額	amount	int	是	需要從分賬接收方回退的金額，單位為分，只能為整數(shù) 示例值：10
回退描述	description	string[1, 80]	是	分賬回退的原因描述示例值：用戶退款
回退結(jié)果	result	string[1, 32]	是	如果請求返回為處理中，則商戶可以通過調(diào)用回退結(jié)果查詢接口獲取請求的最終處理結(jié)果。如果查詢到回退結(jié)果在處理中，請勿變更商戶回退單號，使用相同的參數(shù)再次發(fā)起分賬回退，否則會出現(xiàn)資金風(fēng)險。在處理中狀態(tài)的回退單如果5天沒有成功，會因為超時被設(shè)置為已失敗。枚舉值： PROCESSING：處理中 SUCCESS：已成功 FAILED：已失敗示例值：SUCCESS
失敗原因	fail_reason	string[1, 64]	否	失敗原因。包含以下枚舉值： ACCOUNT_ABNORMAL：原分賬接收方賬戶異常 TIME_OUT_CLOSED：超時關(guān)單 PAYER_ACCOUNT_ABNORMAL：原分賬分出方賬戶異常 INVALID_REQUEST: 描述參數(shù)設(shè)置失敗示例值：TIME_OUT_CLOSED
創(chuàng)建時間	create_time	string[1, 64]	是	分賬回退創(chuàng)建時間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領(lǐng)先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示，北京時間2015年5月20日 13點29分35秒。示例值：2015-05-20T13:29:35+08:00
完成時間	finish_time	string[1, 64]	是	分賬回退完成時間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領(lǐng)先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示，北京時間2015年5月20日 13點29分35秒。示例值：2015-05-20T13:29:35+08:00

返回示例

正常示例


{
  "order_id": "3008450740201411110007820472",
  "out_order_no": "P20150806125346",
  "out_return_no": "R20190516001",
  "return_id": "3008450740201411110007820472",
  "return_mchid": "86693852",
  "amount": 10,
  "description": "用戶退款",
  "result": "SUCCESS",
  "fail_reason": "TIME_OUT_CLOSED",
  "create_time": "2015-05-20T13:29:35+08:00",
  "finish_time": "2015-05-20T13:29:35+08:00"
}


http://2323weixin.qq.com

錯誤碼公共錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
500	SYSTEM_ERROR	系統(tǒng)錯誤	系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用
400	PARAM_ERROR	商戶號未設(shè)置	請使用正確的參數(shù)重新調(diào)用
429	RATELIMIT_EXCEED	商戶發(fā)起分賬回退查詢的頻率過高	請降低頻率后重試
404	RESOURCE_NOT_EXISTS	記錄不存在	請檢查請求的單號是否正確

技術(shù)咨詢

文檔反饋

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

微信支付商戶平臺