BIN Lookup

The BIN (Bank Identification Number) lookup endpoint returns card details — brand, issuer, card type, and funding source — for a given card number prefix or encrypted card. Use this to display card brand icons at checkout or to apply Merchant Choice Routing (MCR) logic for dual-branded cards.

Card Details / BIN Lookup

Bin lookup of Card Number

post

/api/v2/card/card-details

The Card Details API endpoints will bin lookup and provides card details.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

x-vfi-api-idempotencykeystringOptional

Example: 63bbc548-d2de-4546-b106-880a5018461c

A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.

Body

or

Responses

201

The details of the bin range or card. May contain more than one record if a co-branded card.

application/json

400

Bad Request

application/json

401

Unauthorised

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post/api/v2/card/card-details

POST /oidc/api/v2/card/card-details HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 171

{
  "prefix": 492912,
  "entity_id": "30b8bec8-5042-4e67-939c-5453fbe41711",
  "query_context": {
    "supported_card_brands": [
      "VISA"
    ],
    "amount_details": {
      "amount": 1,
      "currency_code": "AED"
    }
  }
}

{
  "bin_details": [
    {
      "bin": 492912,
      "card_brand": "VISA",
      "type": "CREDIT",
      "funding_source": "CREDIT",
      "issuer_country": "ZZZ",
      "issuer_name": "HSBC",
      "added_leading_zeroes": 1,
      "checksum_algorithm": "LUHN",
      "card_product": "VISA CLASSIC"
    }
  ]
}

Request Variants

By Prefix

Submit prefix (4–8 digits). Optionally include entity_id and query_context for MCR support.

{
  "prefix": "492912",
  "entity_id": "30b8bec8-5042-4e67-939c-5453fbe41711"
}

By Encrypted Card

Submit encrypted_card and public_key_alias (obtained from Secure Card Capture).

{
  "encrypted_card": "U3dhZ2dlciByb2Nrcw==",
  "public_key_alias": "KEY00101"
}

Key Response Fields

CardDetailsResponse
  └── bin_details[]
        ├── bin              ← matched BIN prefix (4–8 digits)
        ├── card_brand       ← e.g. VISA, MASTERCARD, AMEX
        ├── type             ← account type (CREDIT, DEBIT, STORED_VALUE, etc.)
        ├── funding_source   ← CREDIT, DEBIT, PREPAID, UNKNOWN
        ├── issuer_name      ← e.g. HSBC, BARCLAYS
        ├── issuer_country   ← ISO 3166-1 alpha-3
        └── card_product     ← e.g. VISA CLASSIC

For co-branded cards, bin_details may contain more than one entry — one per brand. Use query_context.supported_card_brands to filter results to brands your merchant accepts.

Supplying query_context.amount_details (amount + currency) enables automatic MCR brand selection if your entity is configured for Merchant Choice Routing.