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.ravepay.co/i/v1/extras/bin_check.

Simply pass the query parameters below as

Card BIN Verification Parameter Description

Method: GET
Header Params - Content-Type: application/json

Parameters	Required	Description
card_bin	True	This is the first 6 digits of the card
public_key	True	This is your merchant public key

Sample Request Payload

Sample Request Object

{
  "card_bin": "0690000034",
  "public_key": "FLWPUBK-4e9d4e37974a61157ce8ca4f43c84936-X"
}

For more details about Card BIN Verification, see our reference section here

Response

Verified Card BIN Response

{
  "status": "success",
  "message": "Completed",
  "data": {
    "issuing_country": "NIGERIA NG",
    "bin": "537883",
    "card_type": "MASTERCARD",
    "issuer_info": "GUARANTY TRUST BANK Mastercard Naira Debit Card"
  }
}

Wrong Card BIN Response

{
    "status": "success",
    "message": "Completed",
    "data": {
        "data": {
            "country": null,
            "cardBin": null,
            "cardName": null,
            "transactionReference": "FLW1584033233795",
            "nigeriancard": false,
            "responseMessage": "BIN not Found",
            "responseCode": "RR"
        },
        "status": "success"
    }
}