Have you ever integrated our payment API into your product? Help us improve the developer experience for you and everyone by taking this short survey, get started here

Banks

Get all Banks

Query the bank_code for all Banks in a specified Country.

get https://api.flutterwave.com/v3/banks/:country

Path Params

country string

The Bank Country Code. Expected values include: EG, ET, GH, KE, MW, NG, RW, SL, TZ, UG, US or ZA.

Headers

Authorization string

Pass your secret key as a bearer token in the request header to authorize this call

var request = require('request');
var options = {
  'method': 'GET',
  'url': '{{BASE_API_URL}}/banks/NG',
  'headers': {
    'Authorization': 'Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "{{BASE_API_URL}}/banks/NG",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

require "uri"
require "net/http"

url = URI("{{BASE_API_URL}}/banks/NG")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X"

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

{
  "status": "success",
  "message": "Banks fetched successfully",
  "data": [
    {
      "id": 132,
      "code": "560",
      "name": "Page MFBank"
    },
    {
      "id": 133,
      "code": "304",
      "name": "Stanbic Mobile Money"
    },
    {
      "id": 134,
      "code": "308",
      "name": "FortisMobile"
    },
    {
      "id": 135,
      "code": "328",
      "name": "TagPay"
    },
    {
      "id": 136,
      "code": "309",
      "name": "FBNMobile"
    },
    {
      "id": 137,
      "code": "011",
      "name": "First Bank of Nigeria"
    },
    {
      "id": 138,
      "code": "326",
      "name": "Sterling Mobile"
    },
    {
      "id": 139,
      "code": "990",
      "name": "Omoluabi Mortgage Bank"
    },
    {
      "id": 140,
      "code": "311",
      "name": "ReadyCash (Parkway)"
    },
    {
      "id": 141,
      "code": "057",
      "name": "Zenith Bank"
    },
    {
      "id": 142,
      "code": "068",
      "name": "Standard Chartered Bank"
    },
    {
      "id": 143,
      "code": "306",
      "name": "eTranzact"
    },
    {
      "id": 144,
      "code": "070",
      "name": "Fidelity Bank"
    },
    {
      "id": 145,
      "code": "023",
      "name": "CitiBank"
    },
    {
      "id": 146,
      "code": "215",
      "name": "Unity Bank"
    },
    {
      "id": 147,
      "code": "323",
      "name": "Access Money"
    },
    {
      "id": 148,
      "code": "302",
      "name": "Eartholeum"
    },
    {
      "id": 149,
      "code": "324",
      "name": "Hedonmark"
    },
    {
      "id": 150,
      "code": "325",
      "name": "MoneyBox"
    },
    {
      "id": 151,
      "code": "301",
      "name": "JAIZ Bank"
    },
    {
      "id": 152,
      "code": "050",
      "name": "Ecobank Plc"
    },
    {
      "id": 153,
      "code": "307",
      "name": "EcoMobile"
    },
    {
      "id": 154,
      "code": "318",
      "name": "Fidelity Mobile"
    },
    {
      "id": 155,
      "code": "319",
      "name": "TeasyMobile"
    },
    {
      "id": 156,
      "code": "999",
      "name": "NIP Virtual Bank"
    },
    {
      "id": 157,
      "code": "320",
      "name": "VTNetworks"
    },
    {
      "id": 158,
      "code": "221",
      "name": "Stanbic IBTC Bank"
    },
    {
      "id": 159,
      "code": "501",
      "name": "Fortis Microfinance Bank"
    },
    {
      "id": 160,
      "code": "329",
      "name": "PayAttitude Online"
    },
    {
      "id": 161,
      "code": "322",
      "name": "ZenithMobile"
    },
    {
      "id": 162,
      "code": "303",
      "name": "ChamsMobile"
    },
    {
      "id": 163,
      "code": "403",
      "name": "SafeTrust Mortgage Bank"
    },
    {
      "id": 164,
      "code": "551",
      "name": "Covenant Microfinance Bank"
    },
    {
      "id": 165,
      "code": "415",
      "name": "Imperial Homes Mortgage Bank"
    },
    {
      "id": 166,
      "code": "552",
      "name": "NPF MicroFinance Bank"
    },
    {
      "id": 167,
      "code": "526",
      "name": "Parralex"
    },
    {
      "id": 168,
      "code": "035",
      "name": "Wema Bank"
    },
    {
      "id": 169,
      "code": "084",
      "name": "Enterprise Bank"
    },
    {
      "id": 170,
      "code": "063",
      "name": "Diamond Bank"
    },
    {
      "id": 171,
      "code": "305",
      "name": "Paycom"
    },
    {
      "id": 172,
      "code": "100",
      "name": "SunTrust Bank"
    },
    {
      "id": 173,
      "code": "317",
      "name": "Cellulant"
    },
    {
      "id": 174,
      "code": "401",
      "name": "ASO Savings and & Loans"
    },
    {
      "id": 175,
      "code": "030",
      "name": "Heritage"
    },
    {
      "id": 176,
      "code": "402",
      "name": "Jubilee Life Mortgage Bank"
    },
    {
      "id": 177,
      "code": "058",
      "name": "GTBank Plc"
    },
    {
      "id": 178,
      "code": "032",
      "name": "Union Bank"
    },
    {
      "id": 179,
      "code": "232",
      "name": "Sterling Bank"
    },
    {
      "id": 180,
      "code": "076",
      "name": "Skye Bank"
    },
    {
      "id": 181,
      "code": "082",
      "name": "Keystone Bank"
    },
    {
      "id": 182,
      "code": "327",
      "name": "Pagatech"
    },
    {
      "id": 183,
      "code": "559",
      "name": "Coronation Merchant Bank"
    },
    {
      "id": 184,
      "code": "601",
      "name": "FSDH"
    },
    {
      "id": 185,
      "code": "313",
      "name": "Mkudi"
    },
    {
      "id": 186,
      "code": "214",
      "name": "First City Monument Bank"
    },
    {
      "id": 187,
      "code": "314",
      "name": "FET"
    },
    {
      "id": 188,
      "code": "523",
      "name": "Trustbond"
    },
    {
      "id": 189,
      "code": "315",
      "name": "GTMobile"
    },
    {
      "id": 190,
      "code": "033",
      "name": "United Bank for Africa"
    },
    {
      "id": 191,
      "code": "044",
      "name": "Access Bank"
    },
    {
      "id": 567,
      "code": "90115",
      "name": "TCF MFB"
    }
  ]
}



{}

Get Bank Branches

Query the branch code (destination_branch_code) for a specific Bank. This is required for Bank transfers to Benin, Cameroon, Chad, Côte d’Ivoire, DR Congo, Gabon, Ghana, Malawi, Rwanda, Senegal, Sierra Leone, Tanzania, and Uganda.

get https://api.flutterwave.com/v3/banks/:id/branches

Path Params

id int32

This is the Bank's unique ID, it is returned in the call to fetch banks as data.id.

Headers

Authorization string

Pass your secret key as a bearer token in the request header to authorize this call

var request = require('request');
var options = {
  'method': 'GET',
  'url': '{{BASE_API_URL}}/banks/280/branches',
  'headers': {
    'Authorization': 'Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "{{BASE_API_URL}}/banks/280/branches",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

require "uri"
require "net/http"

url = URI("{{BASE_API_URL}}/banks/280/branches")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X"

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

{
  "status": "success",
  "message": "Bank branches fetched successfully",
  "data": [
    {
      "id": 992,
      "branch_code": "GH190101",
      "branch_name": "STANBIC BANK GHANA LTD-ACCRA MAIN",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 993,
      "branch_code": "GH190102",
      "branch_name": "STANBIC BANK GHANA LTD-AIRPORT CITY",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 994,
      "branch_code": "GH190103",
      "branch_name": "STANBIC BANK GHANA LTD-SPINTEX ROAD",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 995,
      "branch_code": "GH190104",
      "branch_name": "STANBIC BANK GHANA LTD-ACCRA MALL",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 996,
      "branch_code": "GH190105",
      "branch_name": "STANBIC BANK GHANA -NORTH INDUSTIAL AREA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 997,
      "branch_code": "GH190106",
      "branch_name": "STANBIC BANK GHANA-TEMA INDUSTRIAL AREA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 998,
      "branch_code": "GH190107",
      "branch_name": "STANBIC BANK GHANA LTD-GRAPHIC ROAD",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 999,
      "branch_code": "GH190108",
      "branch_name": "STANBIC BANK GHANA LTD-MAKOLA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1000,
      "branch_code": "GH190109",
      "branch_name": "STANBIC BANK GHANA LTD-RIND ROAD",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1001,
      "branch_code": "GH190110",
      "branch_name": "STANBIC BANK GHANA LTD-ACHIMOTA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1002,
      "branch_code": "GH190112",
      "branch_name": "STANBIC BANK GHANA LTD-KASOA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1003,
      "branch_code": "GH190401",
      "branch_name": "STANBIC BANK GHANA LTD-TAKORADI",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1004,
      "branch_code": "GH190402",
      "branch_name": "STANBIC BANK GHANA LTD-TARKWA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1005,
      "branch_code": "GH190501",
      "branch_name": "STANBIC BANK GHANA LTD-HO",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1006,
      "branch_code": "GH190601",
      "branch_name": "STANBIC BANK GHANA LTD-HARPER-KUMASI",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1007,
      "branch_code": "GH190701",
      "branch_name": "STANBIC BANK GHANA LTD-SUNYANI",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1008,
      "branch_code": "GH190901",
      "branch_name": "STANBIC BANK GHANA LTD-BOLGATANGA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1009,
      "branch_code": "GH191001",
      "branch_name": "STANBIC BANK GHANA LTD-WA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1010,
      "branch_code": "GH190113",
      "branch_name": "STANBIC BANK GH LTD - TEMA FISHING HABOUR",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1011,
      "branch_code": "GH190111",
      "branch_name": "STANBIC BANK GHANA LTD-ROMAN RIDGE",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1012,
      "branch_code": "GH190801",
      "branch_name": "STANBIC BANK GHANA LTD-TAMALE",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1013,
      "branch_code": "GH190121",
      "branch_name": "STANBIC BANK -STANBIC HEIGHTS BRANCH",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1014,
      "branch_code": "GH190603",
      "branch_name": "STABIC BANK GHANA LIMITED - ADUM",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHAC",
      "bank_id": 280
    },
    {
      "id": 1015,
      "branch_code": "GH190114",
      "branch_name": "STANBIC BANK GHANA LTD-MOVENPICK",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1016,
      "branch_code": "GH190118",
      "branch_name": "STANBIC BANK - MADINA BRANCH",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHAC",
      "bank_id": 280
    },
    {
      "id": 1017,
      "branch_code": "GH190602",
      "branch_name": "STANBIC BANK GHANA LTD-SUAME",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHAC",
      "bank_id": 280
    },
    {
      "id": 1018,
      "branch_code": "GH190117",
      "branch_name": "STANBIC BANK GHANA LTD- ASHIAMAN",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHAC",
      "bank_id": 280
    },
    {
      "id": 1019,
      "branch_code": "GH190125",
      "branch_name": "STANBIC BANK-JUNCTION MALL BRANCH",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1020,
      "branch_code": "GH190120",
      "branch_name": "STANBIC BANK GHANA LTD-LAPAZ",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1021,
      "branch_code": "GH190116",
      "branch_name": "STANBIC BANK GHANA LTD-DANSOMAN",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1022,
      "branch_code": "GH190115",
      "branch_name": "STANBIC MADINA",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHAC",
      "bank_id": 280
    },
    {
      "id": 1023,
      "branch_code": "GH190130",
      "branch_name": "STANBIC BANK GHANA LTD - LEGON",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHACXXX",
      "bank_id": 280
    },
    {
      "id": 1024,
      "branch_code": "GH190119",
      "branch_name": "STANBIC BANK - EAST LEGON",
      "swift_code": "SBICGHAC",
      "bic": "SBICGHAC",
      "bank_id": 280
    }
  ]
}



{}
Loading...