Bank Card Number Verification Interface

Description

Merchant can check whether the bank card number is supported.

Interface Endpoint

https://apis.geoswift.com/remittance/cardBin/verify

Name Type& Max Description Requirement
merchantId varchar(9) The unique identity of the merchant in Geoswift system. Merchant can log in the merchant operation and management system to check M
bankCardNumber varchar(19) Payee bank card number M
partnerId varchar(9) The unique identifier of the secondary merchant under the main merchant in the Geoswift system.
Note: this parameter can be omitted if the initiating merchant is the main merchant.		 C
hmac - The result of parameter signature,generated by the merchant.For the method of obtaining hmac,please reference to "Geoswift encryption and decryption process specification" M

Sample

{ "bankCardNumber": "62*********60", "hmac": "mzh/8X7vysdp3MgkrgVNFNRNZEOt9//DSE45O3M0DxcauZx8WWtrDkE4e6NZwuCg1AyuoU9ZWHj1j+RpL8GR/wqPs leXp+TFdM6Y0Hc1/2MMrMs8P6N+6SS3EfLMJPr4Q6svoPAr2vBTmKD3Pm/BwyevmyjEko+Hc1p0KsDmSLk9YzEnwjWbJhASXut 8Q9nhhJNPbc0PgNrr/dWghNM/T6oD1zCAlX9GH72A5zr4JuKy5kivILdjlLO35tumQq4j1LLPZYuOs0IXenf7yPVR7HLNNXyEo 8DIAKC7hkUz5eLEg09/JQPbDP2kjuToc+G4+1MirFpW9D1SrgmxO6de5w==", "merchantId": "G90008001" }

Response Parameter Fields

Name Description
merchantId The same as the request parameter
bankCardNumber The same as the request parameter
status SUCCESS
FAILED
ERROR
verifyResult TRUE the card is supported
FALSE the card is not supported
requestDateTime Card check request time
completeDateTime Card check completion time
partnerId The same as the request parameter
hmac The result of parameter signature,generated by Geoswift.For the signature verification process,please reference to "Geoswift encryption and decryption process specification"

Sample

{ "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" }