Service Address
/PaymentDealer/GetBankCardInformation
Request Parameters
PaymentDealerAuthentication
| Parameter |
Explanation |
| DealerCode(string) |
Dealer code issued by the Moka system |
| Username (string) |
Api username given by Moka system |
| Password (string) |
Api password given by Moka system |
| CheckKey (string) |
The control key (DealerCode + "MK" + Username + "PD" + Password) is created by passing this information, combined as a String, through the SHA-256 hash algorithm.
Click here to go to the trial screen. |
BankCardInformationRequest
| Parameter |
Explanation |
| BinNumber (string) |
First 6 digits of Credit Card Number |
Returns
| Parameter |
Explanation |
| BankName (string) |
The bank that owns the bin number (Issuer Bank) – Listed below |
| BankCode (string) |
Bank's national code – Available in the list below |
| BinNumber (string) |
Bin number given to the service |
| CardName (string) |
If the card has a special name, it is written in this field. |
| CardType (string) |
Returns MASTER, VISA, MAESTRO, AMEX, TROY |
| CreditType (string) |
Returns as CreditCard or DebitCard. |
| CardLogo (string) |
The program logo of the card rotates. (Bonus logo, Axess logo etc.) |
| CardTemplate (string) |
The image of the card rotates |
| ProductCategory (string) |
Commercial or Personal information of the card returns |
| GroupName (string) |
The program name of the card returns. (BONUS, AXESS, WORLD, CARDFINANS etc.) |
Sample Request (JSON)
{
"PaymentDealerAuthentication":{
"DealerCode":"XXXX",
"Username":"XXXX",
"Password":"XXXX",
"CheckKey":"28ba1f316e661ee7a0477a13aa30613da548c94a8098829af9255b04d7e916e3"
},
"BankCardInformationRequest":{
"BinNumber":" 526911"
}
}
Successful Request Result
If the sent request data has been processed successfully in Moka, "Success" information is written in the "ResultCode" field of the return object . In the "Data" field, the result of the transaction returned from the bank is found. The status of the operation is checked by checking the "IsSuccessful" (true/false) field in "Data" . If this field returns false, it can be seen why the operation failed on the virtual pos by checking the ResultCode and ResultMessage fields in the same object.
Successful Result Example
{
"Data":{
"BankName":"FİNANSBANK",
"BankCode":"111",
"BinNumber":"526911",
"CardName":"",
"CardType":"MASTER",
"CreditType":"CreditCard",
"CardLogo":"https://cdn.moka.com/Content/BankLogo/CARDFINANS.png",
"CardTemplate":"https://cdn.moka.com/Content/BankCardTemplate/FINANS-MASTER-CREDIT.png",
"ProductCategory":"Bireysel",
"GroupName":"CARDFINANS"
},
"ResultCode":"Success",
"ResultMessage":"",
"Exception":null
}
Failed Request Result
| ResultCode | Explanation |
|---|
| Dealer.CheckPaymentDealerAuthentication.InvalidRequest | The CheckKey may be bad, or the object may be bad, or the JSON may be corrupt. |
| Dealer.CheckPaymentDealerAuthentication.InvalidAccount | No such dealer was found. |
| PaymentDealer.GetBankCardInformation.DealerNotAllowed | This dealer does not have permission. |
| PaymentDealer.GetBankCardInformation.BinNumberNotFound | Bin number not found. |
| EX | An unexpected error has occurred |
Example of Failed Result
{
"Data":null,
"ResultCode":"PaymentDealer.GetBankCardInformation.BinNumberNotFound",
"ResultMessage":"",
"Exception":null
}
ISSUER BANK LIST
