银行卡号检测接口
功能描述
商户可以通过此接口检测银行卡号是否支持。
接口地址
https://apis.geoswift.com/remittance/cardBin/verify
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在汇元通系统的唯一id，可在商户后台查看 |
M |
| bankCardNumber |
银行卡号 |
varchar(19) |
收款方银行卡号 |
M |
| partnerId |
服务商 id |
varchar(9) |
二级商户上属服务商商户在汇元通系统 的唯一身份标识（如果发起商户自身即为 主商户此项可不传） |
C |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"bankCardNumber": "62*********60",
"hmac": "mzh/8X7vysdp3MgkrgVNFNRNZEOt9//DSE45O3M0DxcauZx8WWtrDkE4e6NZwuCg1AyuoU9ZWHj1j+RpL8GR/wqPs
leXp+TFdM6Y0Hc1/2MMrMs8P6N+6SS3EfLMJPr4Q6svoPAr2vBTmKD3Pm/BwyevmyjEko+Hc1p0KsDmSLk9YzEnwjWbJhASXut
8Q9nhhJNPbc0PgNrr/dWghNM/T6oD1zCAlX9GH72A5zr4JuKy5kivILdjlLO35tumQq4j1LLPZYuOs0IXenf7yPVR7HLNNXyEo
8DIAKC7hkUz5eLEg09/JQPbDP2kjuToc+G4+1MirFpW9D1SrgmxO6de5w==",
"merchantId": "G90008001"
}
]]>
返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| bankCardNumber |
银行卡号 |
同请求参数 |
| status |
请求状态 |
SUCCESS 成功，代表查询请求成功 |
| FAILED 失败 |
| ERROR 错误 |
| verifyResult |
卡号检测结果 |
TRUE 卡号支持 |
| FALSE 卡号不支持 |
| requestDateTime |
请求时间 |
卡号检测查询时间 |
| completeDateTime |
完成时间 |
卡号检测返回结果时间 |
| partnerId |
服务商 id |
同请求参数 |
| hmac |
参数签名 |
汇元通生成的参数签名结果，验签过程请参考解密流程 |
示例
<![CDATA[
{
"bankCardNumber": "62**********60",
"completeDateTime": "2022-06-13 15:44:00",
"hmac": "NYZCEqvdFKWlQjJnByI53t3EWKPDGO3GyZ8tMoYx9i+hSS9uOj17ZWbem9mLnR9s0ytPco4
dgINnt4SpE/S9l1KLkTntf6c8v4HLeHWqYyrhCe9oTXG8sGoljw4K1ho8Xzogj4DXlVejgNAf4wowwa+
HZjiLbJ/vpLifG/W7nevmYHgKS2O43/5tgPdVOHPjdnqAsCQ5IQnBf7qP0jWAmDfIFG9FctYurCNhgfRf
R94hoYWD0RyAVaKz6xRRvs3PbNIIUqKXtymLMRzV0mV2orZMPenNDw4ZC28cMpSX+kcLNi/fOe22m3schEo
jVY0wTSxOWNaSehvwMi8hrRS9Bw==",
"merchantId": "G90008001",
"requestDateTime": "2022-06-13 15:44:00",
"status": "SUCCESS",
"verifyResult": "FALSE"
}
]]>