明細(xì)單號(hào)查單接口。商戶可以通過該接口查詢單筆轉(zhuǎn)賬明細(xì)單。返回消息中包含微信明細(xì)單號(hào)、明細(xì)狀態(tài)、轉(zhuǎn)賬金額、失敗原因、收款用戶姓名、用戶OpenID等信息。
# 接口說明
支持商戶:
【普通商戶】
請(qǐng)求方式:
【GET】/v3/transfer/batches/batch-id/{batch_id}/details/detail-id/{detail_id}
請(qǐng)求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點(diǎn)【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點(diǎn) ,指引點(diǎn)擊查看
# 請(qǐng)求參數(shù)
- Authorization 必填 string請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請(qǐng)?jiān)O(shè)置為
application/json
Header HTTP頭參數(shù)
- batch_id 必填 string(64)【微信批次單號(hào)】 微信批次單號(hào),微信商家轉(zhuǎn)賬系統(tǒng)返回的唯一標(biāo)識(shí)
- detail_id 必填 string(64)【微信明細(xì)單號(hào)】 微信支付系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細(xì)單的唯一標(biāo)識(shí)
Path 路徑參數(shù)
請(qǐng)求示例
GET
# 應(yīng)答參數(shù)
- mchid 必填 string(32)【商戶號(hào)】 微信支付分配的商戶號(hào)
- out_batch_no 必填 string(32)【商家批次單號(hào)】 商戶系統(tǒng)內(nèi)部的商家批次單號(hào),在商戶系統(tǒng)內(nèi)部唯一
- batch_id 必填 string(64)【微信批次單號(hào)】 微信批次單號(hào),微信商家轉(zhuǎn)賬系統(tǒng)返回的唯一標(biāo)識(shí)
- appid 必填 string(32)【商戶appid】 申請(qǐng)商戶號(hào)的appid或商戶號(hào)綁定的appid(企業(yè)號(hào)corpid即為此appid)
- out_detail_no 必填 string(32)【商家明細(xì)單號(hào)】 商戶系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細(xì)單的唯一標(biāo)識(shí)
- detail_id 必填 string(64)【微信明細(xì)單號(hào)】 微信支付系統(tǒng)內(nèi)部區(qū)分轉(zhuǎn)賬批次單下不同轉(zhuǎn)賬明細(xì)單的唯一標(biāo)識(shí)
- detail_status 必填 string(32)【明細(xì)狀態(tài)】 INIT: 初始態(tài)。 系統(tǒng)轉(zhuǎn)賬校驗(yàn)中
WAIT_PAY: 待確認(rèn)。待商戶確認(rèn), 符合免密條件時(shí), 系統(tǒng)會(huì)自動(dòng)扭轉(zhuǎn)為轉(zhuǎn)賬中
PROCESSING:轉(zhuǎn)賬中。正在處理中,轉(zhuǎn)賬結(jié)果尚未明確
SUCCESS:轉(zhuǎn)賬成功
FAIL:轉(zhuǎn)賬失敗。需要確認(rèn)失敗原因后,再?zèng)Q定是否重新發(fā)起對(duì)該筆明細(xì)單的轉(zhuǎn)賬(并非整個(gè)轉(zhuǎn)賬批次單) - transfer_amount 必填 integer【轉(zhuǎn)賬金額】 轉(zhuǎn)賬金額單位為“分”
- transfer_remark 必填 string(32)【轉(zhuǎn)賬備注】 單條轉(zhuǎn)賬備注(微信用戶會(huì)收到該備注),UTF8編碼,最多允許32個(gè)字符
- fail_reason 選填 string【明細(xì)失敗原因】 如果轉(zhuǎn)賬失敗則有失敗原因
可選取值:ACCOUNT_FROZEN
: 該用戶賬戶被凍結(jié)REAL_NAME_CHECK_FAIL
: 收款人未實(shí)名認(rèn)證,需要用戶完成微信實(shí)名認(rèn)證NAME_NOT_CORRECT
: 收款人姓名校驗(yàn)不通過,請(qǐng)核實(shí)信息OPENID_INVALID
: Openid格式錯(cuò)誤或者不屬于商家公眾賬號(hào)TRANSFER_QUOTA_EXCEED
: 超過用戶單筆收款額度,核實(shí)產(chǎn)品設(shè)置是否準(zhǔn)確DAY_RECEIVED_QUOTA_EXCEED
: 超過用戶單日收款額度,核實(shí)產(chǎn)品設(shè)置是否準(zhǔn)確MONTH_RECEIVED_QUOTA_EXCEED
: 超過用戶單月收款額度,核實(shí)產(chǎn)品設(shè)置是否準(zhǔn)確DAY_RECEIVED_COUNT_EXCEED
: 超過用戶單日收款次數(shù),核實(shí)產(chǎn)品設(shè)置是否準(zhǔn)確PRODUCT_AUTH_CHECK_FAIL
: 未開通該權(quán)限或權(quán)限被凍結(jié),請(qǐng)核實(shí)產(chǎn)品權(quán)限狀態(tài)OVERDUE_CLOSE
: 超過系統(tǒng)重試期,系統(tǒng)自動(dòng)關(guān)閉ID_CARD_NOT_CORRECT
: 收款人身份證校驗(yàn)不通過,請(qǐng)核實(shí)信息ACCOUNT_NOT_EXIST
: 該用戶賬戶不存在TRANSFER_RISK
: 該筆轉(zhuǎn)賬可能存在風(fēng)險(xiǎn),已被微信攔截OTHER_FAIL_REASON_TYPE
: 其它失敗原因REALNAME_ACCOUNT_RECEIVED_QUOTA_EXCEED
: 用戶賬戶收款受限,請(qǐng)引導(dǎo)用戶在微信支付查看詳情RECEIVE_ACCOUNT_NOT_PERMMIT
: 未配置該用戶為轉(zhuǎn)賬收款人,請(qǐng)?jiān)诋a(chǎn)品設(shè)置中調(diào)整,添加該用戶為收款人PAYEE_ACCOUNT_ABNORMAL
: 用戶賬戶收款異常,請(qǐng)聯(lián)系用戶完善其在微信支付的身份信息以繼續(xù)收款PAYER_ACCOUNT_ABNORMAL
: 商戶賬戶付款受限,可前往商戶平臺(tái)獲取解除功能限制指引TRANSFER_SCENE_UNAVAILABLE
: 該轉(zhuǎn)賬場景暫不可用,請(qǐng)確認(rèn)轉(zhuǎn)賬場景ID是否正確TRANSFER_SCENE_INVALID
: 你尚未獲取該轉(zhuǎn)賬場景,請(qǐng)確認(rèn)轉(zhuǎn)賬場景ID是否正確TRANSFER_REMARK_SET_FAIL
: 轉(zhuǎn)賬備注設(shè)置失敗, 請(qǐng)調(diào)整后重新再試RECEIVE_ACCOUNT_NOT_CONFIGURE
: 請(qǐng)前往商戶平臺(tái)-商家轉(zhuǎn)賬到零錢-前往功能-轉(zhuǎn)賬場景中添加BLOCK_B2C_USERLIMITAMOUNT_BSRULE_MONTH
: 超出用戶單月轉(zhuǎn)賬收款20w限額,本月不支持繼續(xù)向該用戶付款BLOCK_B2C_USERLIMITAMOUNT_MONTH
: 用戶賬戶存在風(fēng)險(xiǎn)收款受限,本月不支持繼續(xù)向該用戶付款MERCHANT_REJECT
: 商戶員工(轉(zhuǎn)賬驗(yàn)密人)已駁回轉(zhuǎn)賬MERCHANT_NOT_CONFIRM
: 商戶員工(轉(zhuǎn)賬驗(yàn)密人)超時(shí)未驗(yàn)密
- openid 必填 string(64)【收款用戶openid】 商戶appid下,某用戶的openid
- user_name 選填 string(1024)【收款用戶姓名】 收款方姓名。采用標(biāo)準(zhǔn)RSA算法,公鑰由微信側(cè)提供
商戶轉(zhuǎn)賬時(shí)傳入了收款用戶姓名、查詢時(shí)會(huì)返回收款用戶姓名 - initiate_time 必填 string(32)【轉(zhuǎn)賬發(fā)起時(shí)間】 轉(zhuǎn)賬發(fā)起的時(shí)間,按照使用rfc3339所定義的格式,格式為YYYY-MM-DDThh:mm:ss+TIMEZONE
- update_time 必填 string(32)【明細(xì)更新時(shí)間】 明細(xì)最后一次狀態(tài)變更的時(shí)間,按照使用rfc3339所定義的格式,格式為YYYY-MM-DDThh:mm:ss+TIMEZONE
200OK
應(yīng)答示例
200 OK
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 | 請(qǐng)參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過 | 請(qǐng)參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請(qǐng)稍后重試 | 請(qǐng)稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
404 | NOT_FOUND | 記錄不存在 | 查詢的轉(zhuǎn)賬明細(xì)單不存在 |
429 | FREQUENCY_LIMITED | 頻率超限 | 請(qǐng)求量不要超過接口調(diào)用頻率限制 |
500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 5開頭的狀態(tài)碼都為系統(tǒng)問題,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |