最新更新時間：2022.08.09 版本說明
商戶可以通過該接口查詢單筆轉(zhuǎn)賬明細(xì)單。
? API只支持查詢最近30天內(nèi)的轉(zhuǎn)賬明細(xì)單，30天之前的轉(zhuǎn)賬明細(xì)單請登錄商戶平臺查詢。
? 轉(zhuǎn)賬明細(xì)單中涉及金額的字段單位為“分”。
? 如果查詢單號對應(yīng)的數(shù)據(jù)不存在，那么數(shù)據(jù)不存在的原因可能是：
（1）轉(zhuǎn)賬還在處理中；
（2）轉(zhuǎn)賬批次單受理失敗或還未開始處理導(dǎo)致轉(zhuǎn)賬明細(xì)單沒有落地。
在上述情況下，商戶首先需要檢查該商家明細(xì)單號是否確實是自己發(fā)起，以及是否是該批次下的，如果商戶確認(rèn)是自己發(fā)起且是該批次下的，則請商戶不要直接當(dāng)做轉(zhuǎn)賬失敗處理，請商戶隔幾分鐘再嘗試查詢（請勿轉(zhuǎn)賬和查詢并發(fā)處理）。如果商戶誤把還在轉(zhuǎn)賬處理中的明細(xì)單直接當(dāng)轉(zhuǎn)賬失敗處理，商戶應(yīng)當(dāng)自行承擔(dān)因此產(chǎn)生的所有損失和責(zé)任。
適用對象：直連商戶
請求URL：https://api.mch.weixin.qq.com/v3/transfer/batches/batch-id/{batch_id}/details/detail-id/{detail_id}
請求方式：GET
接口限頻： 單個商戶 50QPS，如果超過頻率限制，會報錯FREQUENCY_LIMITED，請降低頻率請求。
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信批次單號 | batch_id | string[1,64] | 是 | path微信批次單號，微信商家轉(zhuǎn)賬系統(tǒng)返回的唯一標(biāo)識 示例值：1030000071100999991182020050700019480001 |
| 微信明細(xì)單號 | detail_id | string[1,64] | 是 | path微信支付系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細(xì)單的唯一標(biāo)識 示例值：1040000071100999991182020050700019500100 |
https://api.mch.weixin.qq.com/v3/transfer/batches/batch-id/10300000711009999911/details/detail-id/1040000071100999991
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商戶號 | mchid | string[1,32] | 是 | 微信支付分配的商戶號 示例值：1900001109 |
| 商家批次單號 | out_batch_no | string[1,32] | 是 | 商戶系統(tǒng)內(nèi)部的商家批次單號，在商戶系統(tǒng)內(nèi)部唯一 示例值：plfk2020042013 |
| 微信批次單號 | batch_id | string[1,64] | 是 | 微信批次單號，微信商家轉(zhuǎn)賬系統(tǒng)返回的唯一標(biāo)識 示例值：1030000071100999991182020050700019480001 |
| 直連商戶的appid | appid | string[1,32] | 是 | 申請商戶號的appid或商戶號綁定的appid（企業(yè)號corpid即為此appid） 示例值：wxf636efh567hg4356 |
| 商家明細(xì)單號 | out_detail_no | string[1,32] | 是 | 商戶系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細(xì)單的唯一標(biāo)識 示例值：x23zy545Bd5436 |
| 微信明細(xì)單號 | detail_id | string[1,64] | 是 | 微信支付系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細(xì)單的唯一標(biāo)識 示例值：1040000071100999991182020050700019500100 |
| 明細(xì)狀態(tài) | detail_status | string[1,32] | 是 | 枚舉值： PROCESSING:轉(zhuǎn)賬中。正在處理中，轉(zhuǎn)賬結(jié)果尚未明確 SUCCESS:轉(zhuǎn)賬成功 FAIL:轉(zhuǎn)賬失敗。需要確認(rèn)失敗原因后，再決定是否重新發(fā)起對該筆明細(xì)單的轉(zhuǎn)賬（并非整個轉(zhuǎn)賬批次單） 示例值：SUCCESS |
| 轉(zhuǎn)賬金額 | transfer_amount | int | 是 | 轉(zhuǎn)賬金額單位為分 示例值：200000 |
| 轉(zhuǎn)賬備注 | transfer_remark | string[1,32] | 是 | 單條轉(zhuǎn)賬備注（微信用戶會收到該備注），UTF8編碼，最多允許32個字符 示例值：2020年4月報銷 |
| 明細(xì)失敗原因 | fail_reason | string[1,64] | 否 | 如果轉(zhuǎn)賬失敗則有失敗原因 ACCOUNT_FROZEN：賬戶凍結(jié) REAL_NAME_CHECK_FAIL：用戶未實名 NAME_NOT_CORRECT：用戶姓名校驗失敗 OPENID_INVALID：Openid校驗失敗 TRANSFER_QUOTA_EXCEED：超過用戶單筆收款額度 DAY_RECEIVED_QUOTA_EXCEED：超過用戶單日收款額度 MONTH_RECEIVED_QUOTA_EXCEED：超過用戶單月收款額度 DAY_RECEIVED_COUNT_EXCEED：超過用戶單日收款次數(shù) PRODUCT_AUTH_CHECK_FAIL：產(chǎn)品權(quán)限校驗失敗 OVERDUE_CLOSE：轉(zhuǎn)賬關(guān)閉 ID_CARD_NOT_CORRECT：用戶身份證校驗失敗 ACCOUNT_NOT_EXIST：用戶賬戶不存在 TRANSFER_RISK：轉(zhuǎn)賬存在風(fēng)險 REALNAME_ACCOUNT_RECEIVED_QUOTA_EXCEED：用戶賬戶收款受限，請引導(dǎo)用戶在微信支付查看詳情 RECEIVE_ACCOUNT_NOT_PERMMIT：未配置該用戶為轉(zhuǎn)賬收款人 PAYER_ACCOUNT_ABNORMAL：商戶賬戶付款受限，可前往商戶平臺-違約記錄獲取解除功能限制指引 PAYEE_ACCOUNT_ABNORMAL：用戶賬戶收款異常，請引導(dǎo)用戶完善其在微信支付的身份信息以繼續(xù)收款 TRANSFER_REMARK_SET_FAIL：轉(zhuǎn)賬備注設(shè)置失敗，請調(diào)整對應(yīng)文案后重新再試 示例值：ACCOUNT_FROZEN |
| 用戶在直連商戶應(yīng)用下的用戶標(biāo)示 | openid | string[1,128] | 是 | 用戶在直連商戶appid下的唯一標(biāo)識 示例值：o-MYE42l80oelYMDE34nYD456Xoy |
| 收款用戶姓名 | user_name | string[1,1024] | 否 | 1、商戶轉(zhuǎn)賬時傳入了收款用戶姓名、查詢時會返回收款用戶姓名； 2、收款方姓名采用標(biāo)準(zhǔn)RSA算法，公鑰由微信側(cè)提供 3、 該字段需進(jìn)行加密處理，加密方法詳見敏感信息加密說明。(提醒：必須在HTTP頭中上送Wechatpay-Serial) 示例值：757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45 |
| 轉(zhuǎn)賬發(fā)起時間 | initiate_time | string[1,32] | 是 | 轉(zhuǎn)賬發(fā)起的時間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss.sss表示時分秒毫秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領(lǐng)先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35.120+08:00表示北京時間2015年05月20日13點29分35秒 示例值：2015-05-20T13:29:35.120+08:00 |
| 明細(xì)更新時間 | update_time | string[1,32] | 是 | 明細(xì)最后一次狀態(tài)變更的時間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss.sss表示時分秒毫秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領(lǐng)先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35.120+08:00表示北京時間2015年05月20日13點29分35秒 示例值：2015-05-20T13:29:35.120+08:00 |
{
"mchid": "1900001109",
"out_batch_no": "plfk2020042013",
"batch_id": "1030000071100999991182020050700019480001",
"appid": "wxf636efh567hg4356",
"out_detail_no": "x23zy545Bd5436",
"detail_id": "1040000071100999991182020050700019500100",
"detail_status": "SUCCESS",
"transfer_amount": 200000,
"transfer_remark": "2020年4月報銷",
"fail_reason": "ACCOUNT_FROZEN",
"openid": "o-MYE42l80oelYMDE34nYD456Xoy",
"user_name": "757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45",
"initiate_time": "2015-05-20T13:29:35.120+08:00",
"update_time": "2015-05-20T13:29:35.120+08:00"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 5開頭的狀態(tài)碼都為系統(tǒng)問題，請使用相同參數(shù)稍后重新調(diào)用 |
| 400 | PARAM_ERROR | 參數(shù)錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 404 | NOT_FOUND | 記錄不存在 | 查詢的轉(zhuǎn)賬明細(xì)單不存在 |
| 429 | FREQUENCY_LIMITED | 頻率超限 | 請求量不要超過接口調(diào)用頻率限制 |