銀行卡二要素

介面簡介

本介面提供銀行卡二要素（姓名、銀行卡號）一致性核驗服務。透過傳入使用者姓名和銀行卡號，系統實時比對銀行預留資訊，返回兩者是否匹配的驗證結果，幫助開發者快速確認使用者身份資訊的真實性。

適用場景

• 金融開戶稽覈：在使用者繫結銀行卡或開通支付功能時，驗證持卡人身份。
• 電商提現風控：確保提現賬戶歸屬權，防止資金盜用風險。
• 企業薪酬發放：校驗員工提交的工資卡資訊準確性，減少打款失敗率。
• 信貸申請初審：作為基礎身份核驗環節，輔助評估申請人資料可信度。

請求與返回說明

• 請求方式：GET
• 核心引數：
• name：持卡人真實姓名（字串）
• bankcard：待驗證的銀行卡號（字串）
• 返回結果：
• code：狀態碼，SUCCESS 表示請求成功。
• data.result：核驗結論，值為“一致”時表示姓名與卡號匹配。
• data.desc：結果描述，如“姓名與銀行卡號一致”。

接入建議

1. 隱私合規：姓名與銀行卡號屬於敏感個人資訊，傳輸過程請務必使用 HTTPS 加密，並遵循相關法律法規進行資料脫敏儲存。
2. 異常處理：建議對 code 非 SUCCESS 的情況做相容處理，避免因網路波動或上游服務臨時異常導致業務中斷。
3. 輸入校驗：在前端或業務層預先校驗銀行卡號格式（如長度、純數字），減少無效請求呼叫，最佳化成本與效能。