BIN Inquiry

Service Address

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

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

ResultCodeExplanation
Dealer.CheckPaymentDealerAuthentication.InvalidRequestThe CheckKey may be bad, or the object may be bad, or the JSON may be corrupt.
Dealer.CheckPaymentDealerAuthentication.InvalidAccountNo such dealer was found.
PaymentDealer.GetBankCardInformation.DealerNotAllowedThis dealer does not have permission.
PaymentDealer.GetBankCardInformation.BinNumberNotFoundBin 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


image