• Uses the provided BIN to retrieve charge card and bank information. If the specified BIN is not found, an error will be returned requesting a valid BIN.

 

Name Type Description
BinNumber String The six-digit BIN you wish to validate. The BIN is the first six digits of a given charge card number.
LicenseKey String Your license key to use the service.
  • If no errors are encountered a BinValidationInfo element will be returned with the following information. If there is an error, an Error object will be returned (explained in next section).
Name Type Value Description
Status String “OK” or “NotFound” A value indicating whether or not the input BIN was found in our system.
BIN [1] String Varies The input BIN.
BankName String Varies The name of the bank that issued the charge card.
Brand String Varies The brand associated with the given BIN. (i.e. Mastercard, Visa, Discover etc)
CardType String Varies Credit, Debit, or Prepaid.
SubType String Varies Description of the type of card issued by the bank (i.e. Business, Classic, Platinum, etc.)
Country String Varies Name of the country where the issuing bank is located.
CountryISO2 String Varies Name of the country where the issuing bank is located.
Phone String Varies List of service phone numbers associated with the charge card
Warnings Code[] Varies A series of codes and warning descriptions that correspond to different information given about the BIN. See below for a table of codes and descriptions
Notes Code[] Varies A series of codes and note descriptions that provide additional information about the BIN. (There are currently no note codes associated with this operation)
InformationComponents InformationComponent[] Varies A array of name value pairs with additional fields and information about the BIN.(There are currently no Information Components in use in this operation)
Error Error Varies Error object indicating why the service could not return a result. See “Errors” for more information.
DEBUG String Unused in this service.
  • Code
Name Type Values Description
Code Int Varies A code that will correspond to the given description
Description String Varies A description containing additional information.
  • InformationComponent
Name Type Values Description
Name String Varies The variable name of the Name-Value pair that is to be returned.
Value String Varies The resulting value of the of the variable returned in the “Name”.
  • Warnings*
Code Description
1 Bank Information Not Found
2 No Card Type Found
3 No Country Associated with BIN
*New Warnings will be added in the future to the BIN Validation service