用途:这是 Paystack Verification API 的中文整理,提供 KYC 验证工具,主要用于银行账户解析、账户归属校验以及银行卡 BIN 查询,可帮助确认账户归属的客户是否正确。依赖 paystack-setup 提供的 paystackRequest 辅助方法;如需获取银行代码,可参考 paystack-miscellaneous。
主要接口:GET /bank/resolve,把账号解析为户名;POST /bank/validate,校验账户归属(含身份证明文件验证);GET /decision/bin/:bin,解析银行卡 BIN。
账户解析:必填 account_number(银行账号)与 bank_code(银行代码,来自 List Banks 接口),返回账号与户名。文档给出的示例中,账号 0022728151、银行代码 063 解析出的户名是 WES GIBBONS。可结合“转账前验证”模式,将解析出的户名与预期姓名做小写比对,若不匹配则抛出错误,从而在付款前拦截异常账户。
账户校验:/bank/validate 为 POST,必填 account_name(客户姓名)、account_number、account_type(personal 或 business)、bank_code、country_code(两位 ISO 代码,如 NG、ZA、GH)、document_type(identityNumber、passportNumber 或 businessRegistrationNumber),document_number 为可选。返回字段包括 verified、verificationMessage、accountAcceptsDebits、accountAcceptsCredits、accountHolderMatch、accountOpen。文档示例中验证通过时 verified 为 true,提示信息为 Account is verified successfully。
BIN 查询:使用卡号前 6 位调用 /decision/bin/:bin,可获取卡组织、卡类型与发卡银行等信息,返回字段包含 bin、brand、sub_brand、country_code、country_name、card_type(DEBIT 或 CREDIT)与 bank。示例中 539983 的品牌为 Mastercard、类型为 DEBIT、发卡行为 Guaranty Trust Bank。
限制:资料未提供接口的收费、地区支持范围、调用限额、错误码及超时重试等细节;具体字段校验规则与异常返回也暂未提供。实际使用需以 paystack-setup 与 Paystack 官方文档为准。