最新更新時間：2021.05.14 版本說明
查詢對私銀行卡號對應(yīng)的開戶銀行信息（僅支持部分銀行的對私銀行卡）
? 單商戶單接口最大請求頻率不超過300TPS；
? 該接口應(yīng)答信息中的銀行列表數(shù)據(jù)可能為多條，表示無法確認(rèn)卡號所屬的唯一銀行，需要引導(dǎo)用戶從中選擇具體一家銀行；
? 查詢到的數(shù)據(jù)條數(shù)為0時僅說明暫時無法識別銀行卡號對應(yīng)的開戶銀行，不表示卡號一定有誤；
? 【銀行別名編碼】和【銀行別名】字段僅用于前端展示、檢索支行；
? 微信支付入駐、修改結(jié)算銀行卡、付款到銀行卡等接口中需要使用【開戶銀行編碼】和【開戶銀行】字段；
? 商戶上送敏感信息時使用微信支付平臺公鑰加密，證書序列號包含在請求HTTP頭部的Wechatpay-Serial，詳見接口規(guī)則
適用對象： 服務(wù)商
請求URL：https://api.mch.weixin.qq.com/v3/capital/capitallhh/banks/search-banks-by-bank-account
請求方式：GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 銀行卡號 | account_number | string[1, 512] | 是 | query1、僅支持對私的個人銀行卡號 2、卡號組成和長度遵循開戶銀行對照表。 3、該字段需進(jìn)行加密處理，加密方法詳見敏感信息加密說明。(提醒：必須在HTTP頭中上送Wechatpay-Serial) 示例值：d+xT+MQCvrLHUVDWv/8MR/dB7TkXLVfSrUxMPZy6jWWYzpRrEEaYQE8ZRGYoeorwC+w== |
https://api.mch.weixin.qq.com/v3/capital/capitallhh/banks/search-banks-by-bank-account?account_number=d+xT+MQCvrLHUVDWv/8MR/dB7TkXLVfSrUxMPZy6jWWYzpRrEEaYQE8ZRGYoeorwC+w==
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 查詢數(shù)據(jù)總條數(shù) | total_count | int | 是 | 根據(jù)卡號查詢到的銀行列表數(shù)據(jù)的總條數(shù)，未查詢到對應(yīng)銀行列表時默認(rèn)返回0，最大不超過兩百條。 示例值：10 |
| +銀行列表 | data | array | 否 | 根據(jù)本次銀行賬戶查詢的銀行列表數(shù)據(jù) 當(dāng)銀行列表數(shù)據(jù)為多條時，標(biāo)識無法確認(rèn)卡號所屬的唯一銀行，需根據(jù)用戶實際情況從中選擇具體一家銀行 |
{
"total_count":10,
"data": [
{
"bank_alias": "工商銀行深圳前海微眾銀行",
"bank_alias_code": "1000006247",
"account_bank": "招商銀行其他銀行",
"account_bank_code": 1001,
"need_bank_branch": true
}
]
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 銀行卡非儲蓄卡 | 暫不支持信用卡，請更換為儲蓄卡。 |
| 400 | INVALID_REQUEST | 查詢結(jié)果超限 | 暫不支持查詢該銀行卡的開戶銀行 |
| 404 | NOT_FOUND | 查詢結(jié)果為空 | 請商戶檢查需要查詢的id或者請求URL是否正確 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 調(diào)用太頻繁，請降低調(diào)用接口頻率 |
| 401 | SIGN_ERROR | 簽名驗證失敗 | 請檢查簽名參數(shù)和方法是否都符合簽名算法要求 |