最新更新時間:2022.08.09 版本說明
商戶可以通過該接口查詢單筆轉(zhuǎn)賬明細單。
? API只支持查詢最近30天內(nèi)的轉(zhuǎn)賬明細單,30天之前的轉(zhuǎn)賬明細單請登錄商戶平臺查詢。
? 轉(zhuǎn)賬明細單中涉及金額的字段單位為“分”。
? 如果查詢單號對應的數(shù)據(jù)不存在,那么數(shù)據(jù)不存在的原因可能是:
(1)轉(zhuǎn)賬還在處理中;
(2)轉(zhuǎn)賬批次單受理失敗或還未開始處理導致轉(zhuǎn)賬明細單沒有落地。
在上述情況下,商戶首先需要檢查該商家明細單號是否確實是自己發(fā)起,以及是否是該批次下的,如果商戶確認是自己發(fā)起且是該批次下的,則請商戶不要直接當做轉(zhuǎn)賬失敗處理,請商戶隔幾分鐘再嘗試查詢(請勿轉(zhuǎn)賬和查詢并發(fā)處理)。如果商戶誤把還在轉(zhuǎn)賬處理中的明細單直接當轉(zhuǎn)賬失敗處理,商戶應當自行承擔因此產(chǎn)生的所有損失和責任。
適用對象:直連商戶
請求URL:https://api.mch.weixin.qq.com/v3/transfer/batches/out-batch-no/{out_batch_no}/details/out-detail-no/{out_detail_no}
請求方式:GET
接口限頻: 單個商戶 50QPS,如果超過頻率限制,會報錯FREQUENCY_LIMITED,請降低頻率請求。
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
商家明細單號 | out_detail_no | string[1,32] | 是 | path商戶系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細單的唯一標識,要求此參數(shù)只能由數(shù)字、大小寫字母組成 示例值:x23zy545Bd5436 |
商家批次單號 | out_batch_no | string[1,32] | 是 | path商戶系統(tǒng)內(nèi)部的商家批次單號,要求此參數(shù)只能由數(shù)字、大小寫字母組成,在商戶系統(tǒng)內(nèi)部唯一 示例值:plfk2020042013 |
https://api.mch.weixin.qq.com/v3/transfer/batches/out-batch-no/x23zy545Bd5436/details/out-detail-no/plfk2020042013
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
商家批次單號 | out_batch_no | string[1,32] | 是 | 商戶系統(tǒng)內(nèi)部的商家批次單號,在商戶系統(tǒng)內(nèi)部唯一 示例值:plfk2020042013 |
微信批次單號 | batch_id | string[1,64] | 是 | 微信批次單號,微信商家轉(zhuǎn)賬系統(tǒng)返回的唯一標識 示例值:1030000071100999991182020050700019480001 |
直連商戶的appid | appid | string[1,32] | 是 | 申請商戶號的appid或商戶號綁定的appid(企業(yè)號corpid即為此appid) 示例值:wxf636efh567hg4356 |
商家明細單號 | out_detail_no | string[1,32] | 是 | 商戶系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細單的唯一標識 示例值:x23zy545Bd5436 |
微信明細單號 | detail_id | string[1,64] | 是 | 微信支付系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細單的唯一標識 示例值:1040000071100999991182020050700019500100 |
明細狀態(tài) | detail_status | string[1,32] | 是 | 枚舉值: PROCESSING:轉(zhuǎn)賬中。正在處理中,轉(zhuǎn)賬結(jié)果尚未明確 SUCCESS:轉(zhuǎn)賬成功 FAIL:轉(zhuǎn)賬失敗。需要確認失敗原因后,再決定是否重新發(fā)起對該筆明細單的轉(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月報銷 |
明細失敗原因 | 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)賬存在風險 REALNAME_ACCOUNT_RECEIVED_QUOTA_EXCEED:用戶賬戶收款受限,請引導用戶在微信支付查看詳情 RECEIVE_ACCOUNT_NOT_PERMMIT:未配置該用戶為轉(zhuǎn)賬收款人 PAYER_ACCOUNT_ABNORMAL:商戶賬戶付款受限,可前往商戶平臺-違約記錄獲取解除功能限制指引 PAYEE_ACCOUNT_ABNORMAL:用戶賬戶收款異常,請引導用戶完善其在微信支付的身份信息以繼續(xù)收款 TRANSFER_REMARK_SET_FAIL:轉(zhuǎn)賬備注設(shè)置失敗,請調(diào)整對應文案后重新再試 示例值:ACCOUNT_FROZEN |
用戶在直連商戶應用下的用戶標示 | openid | string[1,128] | 是 | 用戶在直連商戶appid下的唯一標識 示例值:o-MYE42l80oelYMDE34nYD456Xoy |
收款用戶姓名 | user_name | string[1,1024] | 否 | 1、商戶轉(zhuǎn)賬時傳入了收款用戶姓名、查詢時會返回收款用戶姓名; 2、收款方姓名采用標準RSA算法,公鑰由微信側(cè)提供 3、 該字段需進行加密處理,加密方法詳見敏感信息加密說明。(提醒:必須在HTTP頭中上送Wechatpay-Serial) 示例值:757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45 |
轉(zhuǎn)賬發(fā)起時間 | initiate_time | string[1,32] | 是 | 轉(zhuǎn)賬發(fā)起的時間,遵循rfc3339標準格式,格式為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 |
明細更新時間 | update_time | string[1,32] | 是 | 明細最后一次狀態(tài)變更的時間,遵循rfc3339標準格式,格式為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 |
{
"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)賬明細單不存在 |
429 | FREQUENCY_LIMITED | 頻率超限 | 請求量不要超過接口調(diào)用頻率限制 |