Card bin verification

This document will show you how to verify card bin numbers

There's a need to verify user-provided credentials before initiating payments or giving value. Flutterwave gives you the ability to verify the business identification numbers of bank-issued cards through our card bin check endpoint: https://api.flutterwave.com/v3/card-bins/bin. Simply pass the card bin as a query parameter to the endpoint and authorize the call with your secret key.

Method: GET
Header Params:
Content-Type: application/json,
Authorization: Bearer {{SEC_KEY}}

Parameter	Required	Description
card-bin	True	This is the first 6 digits of the card pan you want to verify

Sample request

cURL

curl --request GET \
  --url https://api.flutterwave.com/v3/card-bins/553188 \
  --header 'content-type: application/json', 'authorization: Bearer "YOUR SEC KEY' \

Response

Valid BIN

{
    "status": "success",
    "message": "completed",
    "data": {
        "issuing_country": "NIGERIA NG",
        "bin": "553188",
        "card_type": "MASTERCARD",
        "issuer_info": " CREDIT"
    }
}

Wrong BIN

{
    "status": "error",
    "message": "completed",
    "data": {
        "nigerian_card": false,
        "response_code": "RR",
        "response_message": "BIN not Found",
        "transaction_reference": "FLW1590500367800"
    }
}