Retrieve card information such as network, type, and issuing bank by providing the card's BIN (Bank Identification Number): the first 6 to 11 digits of the card number. Never send the full card number; more than 11 digits is rejected with 400.
The card details are found under the first 6 digits. One 6-digit BIN can be shared by issuers in several countries, so for a Mastercard card looked up with 6 to 11 digits, Astrada also runs a more precise issuer-country check on the digits sent. That check can return a different issuerCountry, issuerRegion and issuerName than the first 6 digits alone would. Send more digits (up to 11) for a more precise issuer country; never send the full card number.
When the digits sent match card ranges in more than one country, the response keeps the 6-digit values and adds issuerCountryAmbiguous, issuerCountryCandidates, and a warnings entry with code ISSUER_COUNTRY_NOT_CONFIRMED. In every other case none of these three fields is present.
Lookups for every other network are unaffected. If the precise check gives no answer, the request still succeeds with the 6-digit values. In sandbox the precise check is not run, so sandbox responses never include these fields.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
