Resolve Card Bin

curl --request GET \
  --url https://api.flutterwave.com/v3/card-bins/{bin} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.flutterwave.com/v3/card-bins/{bin}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/card-bins/{bin}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/card-bins/{bin}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/card-bins/{bin}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

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

GET

card-bins

{bin}

Resolve Card Bin

curl --request GET \
  --url https://api.flutterwave.com/v3/card-bins/{bin} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.flutterwave.com/v3/card-bins/{bin}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/card-bins/{bin}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/card-bins/{bin}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/card-bins/{bin}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

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

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

bin

integer<int32>

required

Example:

539983

Response

status

string

required

message

string

required

data

Data85 · object

required

Show child attributes

Example:

{
  "issuing_country": " NIGERIA NG",
  "bin": "539983",
  "card_type": "MASTERCARD",
  "issuer_info": "MASTERCARD GUARANTY TRUST BANK Mastercard Naira Debit Card  "
}

API Documentation

Charges

Tokenized Charges

Preauthorization

Transactions

Transfers

Beneficiaries

Virtual Cards

Virtual Account Numbers

Collection Subaccounts

Payout Subaccounts

Subscriptions

Payment Plans

Bill Payments

Banks

Misc

Settlements

Otps

Chargebacks

Resolve Card Bin

Authorizations

Path Parameters

Response