- 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.
URL Endpoints
- JSON: https://trial.serviceobjects.com/BV/web.svc/json/ValidateBIN_V2?BinNumber={BINNUMBER}&LicenseKey={LICENSEKEY}
- XML: https://trial.serviceobjects.com/BV/web.svc/xml/ValidateBIN_V2?BinNumber={BINNUMBER}&LicenseKey={LICENSEKEY}
OrderValidate Inputs
| 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. |
ValidateBIN_V2 Outputs
- 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 |