Bin Lookup
BIN lookup is a subscription service. Contact [email protected] or [email protected] to gain access to our BIN lookup product.
The BIN Lookup endpoint uses the same authentication model as the Tokenize method in the Mobile API. See the documentation for generating the authentication key here.
Endpoints
| Environment | URL |
|---|---|
| Test | https://test-htp.tokenex.com/api/sdk/BinLookup |
API Parameters
| Parameter | Data Type | Description |
|---|---|---|
| TokenExID | string | The merchant's TokenEx ID. |
| Timestamp | string | The timestamp (UTC) when the hash is generated, in yyyyMMddHHmmss format. |
| AuthenticationKey | string | The Authentication Key generated on the merchant's server. |
| Pan | string | The PAN to lookup in BIN database |
| TokenScheme | enum | The Token Scheme to be used to tokenize the provided data. See https://docs.tokenex.com/?page=appendix#token-schemes for TokenSchemes. |
Request
{
"tokenexid": "YourTokenExID",
"timestamp": "20180109161437",
"authenticationKey": "3mHJFag1ICQiwRdSw1QY86WUvt3IDklswf6AA/q+wdU=",
"pan": "4109931020342877",
"tokenScheme": "sixTOKENfour"
}
Response
{
"Error": null,
"Success": true,
"ReferenceNumber": "24032109095063825804",
"BinData": {
"BinMin": "4109931020000000000",
"BinMax": "4109931029999999999",
"BinLength": 8,
"CleanBankName": "Metro Credit Union",
"ProductName": "Visa Traditional",
"CardBrand": "VISA",
"CountryAlpha2": "US",
"CountryName": "UNITED STATES OF AMERICA",
"CountryNumeric": "840",
"Type": "Credit",
"BankName": "METRO CREDIT UNION",
"BankUrl": "",
"BankPhone": "",
"ProductCode": "A",
"Prepaid": false,
"Regulated": false,
"RegulatedName": "GOVERNMENT EXEMPT INTERCHANGE FEE",
"Reloadable": false,
"PanOrToken": "pan",
"AccountUpdater": false,
"Alm": false,
"DomesticOnly": false,
"GamblingBlocked": false,
"Level2": false,
"Level3": false,
"IssuerCurrency": "USD",
"CardSegmentType": "Consumer",
"ComboCard": "",
"CardBrandIsAdditional": false,
"CorrelationId": "eyJGaWxlSWQiOjcxMzcsIlZlcnNpb24iOjQwfQ==",
"SharedBin": false,
"Cost": [],
"Authentication": [],
"AdditionalCardBrands": []
}
}
Updated 7 months ago