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