Transfers

Get started with your transfers to local and international customers.

Initiate a Transfer

Initiate local and international transfers to Bank accounts and Mobile Money wallets.

post https://api.flutterwave.com/v3/transfers

Body Params

account_bank string

The recipient's bank code. You can query all available banks and their corresponding codes from the get banks endpoint.

account_number string

This is the recipient's account number.

amount int32

This is the amount to be transferred to the recipient.

currency int32

The currency of the Transfer. Learn more about supported currencies here.

narration string

This is the narration for the transfer e.g. payments for x services provided.

debit_subaccount string

The id of a payout subaccount wallet. This is required if you choose to use the PSA as the source of funds for your transfer.

Show optional parameters

Headers

Authorization string

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

{
    //Transfer to a Nigerian bank account
    "account_bank": "044",
    "account_number": "0690000040",
    "amount": 5500,
    "narration": "Akhlm Pstmn Trnsfr xx007",
    "currency": "NGN",
    "reference": "akhlm-pstmnpyt-rfxx007_PMCKDU_1",
    "callback_url": "https://www.flutterwave.com/ng/",
    "debit_currency": "NGN"
}
{
    //Transfer to a US bank account
    "amount": 50,
    "narration": "Test Int'l bank transfers",
    "currency": "USD",
    "reference": "new-intl-test-transfer1",
    "beneficiary_name": "Flutterwave Developers",
      "meta": [
    {
      "account_number": "09182972BH",
      "routing_number": "0000000002993",
      "swift_code": "ABJG190",
      "bank_name": "BANK OF AMERICA, N.A., SAN FRANCISCO, CA",
      "beneficiary_name": "Flutterwave Developers",
      "beneficiary_address": "San Francisco, 4 Newton",
      "beneficiary_country": "US"
    }
  ]
}
{
  //Transfer to a Nigerian USD domiciliary account
  "account_number": "0690000036",
  "account_bank": "044",
  "narration": "Sample USD DOM transfer",
  "amount": 50,
  "reference": "sample_ref",
  "currency": "USD",
  "debit_currency": "USD",
  "beneficiary_name": "Flutterwave Developers",
  "meta": [
    {
      "first_name": "Flutterwave",
      "last_name": "Developers",
      "email": "developers@flutterwavego.com",
      "beneficiary_country": "NG",
      "mobile_number": "+2348000000000",
      "sender": "Flutterwave Engineering",
      "merchant_name": "Flutterwave"
    }
  ]
}
{
    //Transfer to a bank account in UK or EU
    "amount": 50,
    "narration": "Test EU Int'l bank transfers",
    "currency": "EUR",
    "reference": "new-intl-eu-test-transfer",
    "beneficiary_name": "Flutterwave Developers",
    "meta": [
        {
        "account_number": "DA091983888373BGH",
        "routing_number": "BECFDE7HKKX", 
        "swift_code": "BECFDE7HKKX", 
        "bank_name": "LLOYDS BANK",
        "beneficiary_name": "Flutterwave Developers",
        "beneficiary_country": "DE", 
        "postal_code": "80489", 
        "street_number": "31",
        "street_name": "Handelsbank Elsenheimer Str.",
        "city": "München"
        }
    ]
}
{
    //Transfer to a South African bank account
    "account_bank": "FNB",
    "account_number": "0031625807099",
    "amount": 500,
    "narration": "Withdraw Fiat",
    "currency": "ZAR",
    "reference": "496_PMCKDU_1",
    "debit_currency":"NGN",
    "beneficiary_name": "Flutterwave Developers",
    "callback_url": "https://www.flutterwave.com/ng/",
    "meta": [
        {
            "first_name": "Flutterwave",
            "last_name": "Developers",
            "email": "developers@flutterwavego.com",
            "mobile_number": "+2348000000000",
            "recipient_address": "234 Kings road, Cape Town"
        }
    ]
}
{
    //Transfer to an Egyptian bank account
    "account_number": "100035129997",
    "account_bank": "CIB",
    "narration": "Sample EGP transfer",
    "amount": 50,
    "reference": "sample-ref-001-002",
    "currency": "EGP",
    "beneficiary_name": "Flutterwave Developers",
    "meta": [
        {
            "sender": "Cornelius",
            "sender_id_expiry": "2025-12-31",
            "sender_id_number": "123454",
            "sender_date_of_birth": "1990-01-01",
            "sender_id_type": "01",
            "beneficiary_address": "123 mawin street",
            "beneficiary_id_number": "ID5467833322222",
            "is_cash_pickup": false,
            "transfer_purpose": "02"
        }
    ]
}
{
    //Transfer to a Kenyan bank account
    "account_bank": "68",
    "account_number": "0031625807099",
    "amount": 500,
    "narration": "Withdraw Fiat",
    "currency": "KES",
    "reference": "496_PMCKDU_1",
    "debit_currency":"USD",
    "beneficiary_name": "Flutterwave Developers",
    "callback_url": "https://mycallbackurl.com/kes/callback",
    "meta": [
        {
            "sender": "Flutterwave Developers",
            "sender_country": "UK",
            "mobile_number": "+2348000000000"
        }
    ]
}
{
    //Transfer to a Ghanaian bank account
    "account_bank": "GH280100",
    "account_number": "0031625807099",
    "amount": 50,
    "narration": "Test GHS bank transfers",
    "currency": "GHS",
    "reference": "new-GHS-test-transfer1",
    "callback_url": "https://www.flutterwave.com/ng/",
    "destination_branch_code": "GH280103",
    "beneficiary_name": "Flutterwave Developers"
}
{
  //Transfer to a KES mobile money number  
  "account_bank": "MPS",
  "account_number": "2540700000000",
  "amount": 50,
  "narration": "New transfer",
  "currency": "KES",
  "reference": "mk-902837-jk",
  "beneficiary_name": "Flutterwave Developers",
  "meta": {
        "sender": "Obembe Mark",
        "sender_country": "US",
        "mobile_number": "12313131231231"
  }
}
{
  //Transfer to a XAF/XOF mobile money number excluding Senegalese mobile numbers
  //Supported Countries: Cote D'Ivoire, Mali, Cameroon
  "account_bank": "FMM",
  "account_number": "250700000000",
  "amount": 50,
  "narration": "New franco transfer",
  "currency": "XAF",
  "reference": "new-franco-momo-test-transfer",
  "beneficiary_name": "Flutterwave Developers"
}
{
    //Transfer to a Senegal mobile money number
    //Supported Country: Senegal
    "account_bank": "ORANGEMONEY", //you can also pass EMONEY or FREEMONEY
    "account_number": "2217857532",
    "beneficiary_name": "Taju Afobaje",
    "amount": 100,
    "narration": "MoMo Transfer to Senegal",
    "currency": "XOF",
    "reference": "TRF-21928319023-2312",
    "callback_url": "https://www.flutterwave.com/",
    "debit_currency": "XOF"
}
{
  //Transfer to a GHS mobile money number
  "account_bank": "MTN",
  "account_number": "233500000000",
  "amount": 50,
  "narration": "New GHS momo transfer",
  "currency": "GHS",
  "reference": "new-ghs-momo-transfer",
  "beneficiary_name": "Flutterwave Developers"
}
{
  //Transfer to a RWF mobile money number  
  "account_bank": "MPS",
  "account_number": "233500000000",
  "amount": 50,
  "narration": "New RWF momo transfer",
  "currency": "RWF",
  "reference": "new-rwf-momo-transfer",
  "beneficiary_name": "Flutterwave Developers"
}
{
  //Transfer to a UGX mobile money number   
  "account_bank": "MPS",
  "account_number": "233500000000",
  "amount": 50,
  "narration": "UGX momo transfer",
  "currency": "UGX",
  "reference": "ugx-momo-transfer",
  "beneficiary_name": "Flutterwave Developers"
}
{
  //Transfer to a ZMW mobile money number 
  "account_bank": "MPS",
  "account_number": "250700000000",
  "amount": 50,
  "narration": "New ZMW transfer",
  "currency": "ZMW",
  "reference": "new-ZMW-momo-test-transfer",
  "beneficiary_name": "Flutterwave Developers"
}
{
    //Transfer to a F4B Wallet 
    "account_bank": "flutterwave",
    "account_number": "00118468",
    "amount": 5500,
    "narration": "payment for x service provided",
    "currency": "NGN",
    "reference": "wallet-transfer",
    "debit_currency": "NGN"
}
{
  //Transfer to a Barter Wallet  
  "account_number": "+2348000000000",
  "account_bank": "barter",
  "narration": "Test",
  "amount": 20,
  "reference": "barter-transfer-2",
  "currency": "NGN",
  "beneficiary_name": "Flutterwave Developers"
}
{
  "status": "success",
  "message": "Transfer Queued Successfully",
  "data": {
    "id": 26251,
    "account_number": "0690000040",
    "bank_code": "044",
    "full_name": "Flutterwave Developers",
    "created_at": "2020-01-20T16:09:34.000Z",
    "currency": "NGN",
    "debit_currency": "NGN",
    "amount": 5500,
    "fee": 45,
    "status": "NEW",
    "reference": "akhlm-pstmnpyt-rfxx007_PMCKDU_1",
    "meta": null,
    "narration": "Akhlm Pstmn Trnsfr xx007",
    "complete_message": "",
    "requires_approval": 0,
    "is_approved": 1,
    "bank_name": "ACCESS BANK NIGERIA"
  }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 221082,
        "account_number": "FOREIGN-ACCOUNT",
        "bank_code": "FOREIGN-BANK",
        "full_name": "Mark Cuban",
        "created_at": "2023-11-08T15:43:47.000Z",
        "currency": "USD",
        "amount": 500,
        "fee": 45,
        "status": "NEW",
        "reference": "d1a5b51a94ed0607",
        "meta": [
            {
                "RoutingNumber": "0000000002993",
                "SwiftCode": "ABJG190",
                "BankName": "BANK OF AMERICA, N.A., SAN FRANCISCO, CA",
                "BeneficiaryName": "Mark Cuban",
                "BeneficiaryAddress": "San Francisco, 4 Newton",
                "BeneficiaryCountry": "US",
                "MerchantName": "Glory Amuah",
                "SenderCountry": "NG",
                "SenderAddress": "Lagos",
                "SenderMobileNumber": "+2348140244958",
                "AccountNumber": "FOREIGN-ACCOUNT",
                "Sender": "Glory Amuah",
                "Address": "San Francisco, 4 Newton",
                "MobileNumber": "23480000000000"
            }
        ],
        "narration": "Test Int'l bank transfers",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 161265,
        "account_number": "0690000036",
        "bank_code": "044",
        "full_name": "Flutterwave Developers",
        "created_at": "2021-01-13T09:23:04.000Z",
        "currency": "USD",
        "debit_currency": "USD",
        "amount": 65,
        "fee": 40.325,
        "status": "NEW",
        "reference": "khlm-dom-5245",
        "meta": [
            {
                "FirstName": "Flutterwave",
                "LastName": "Developers",
                "EmailAddress": "developers@flutterwavego.com",
                "beneficiary_country": "NG",
                "MobileNumber": "+2348000000000",
                "Sender": "Iphie",
                "account_number": "0690000036",
                "routing_number": "044",
                "MerchantName": "Flutterwave"
            }
        ],
        "narration": "Test Payout",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "ACCESS BANK NIGERIA"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 221083,
        "account_number": "FOREIGN-ACCOUNT",
        "bank_code": "FOREIGN-BANK",
        "full_name": "John Twain",
        "created_at": "2023-11-08T15:48:08.000Z",
        "currency": "EUR",
        "amount": 500,
        "fee": 45,
        "status": "NEW",
        "reference": "a68e06b331590d75",
        "meta": [
            {
                "RoutingNumber": "BECFDE7HKKX",
                "SwiftCode": "BECFDE7HKKX",
                "BankName": "LLOYDS BANK",
                "BeneficiaryName": "John Twain",
                "BeneficiaryCountry": "DE",
                "PostalCode": "80489",
                "StreetNumber": "31",
                "StreetName": "Handelsbank Elsenheimer Str.",
                "City": "München",
                "MerchantName": "Glory Amuah",
                "SenderCountry": "NG",
                "SenderAddress": "Lagos",
                "SenderMobileNumber": "+2348140244958",
                "AccountNumber": "FOREIGN-ACCOUNT",
                "Sender": "Glory Amuah",
                "Address": null,
                "MobileNumber": "23480000000000"
            }
        ],
        "narration": "Test EU Int'l bank transfers",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 221084,
        "account_number": "FOREIGN-ACCOUNT",
        "bank_code": "FOREIGN-BANK",
        "full_name": "John Twain",
        "created_at": "2023-11-08T15:50:44.000Z",
        "currency": "GBP",
        "amount": 500,
        "fee": 45,
        "status": "NEW",
        "reference": "31b2925a80c5bf2e",
        "meta": [
            {
                "RoutingNumber": "BECFDE7HKKX",
                "SwiftCode": "BECFDE7HKKX",
                "BankName": "LLOYDS BANK",
                "BeneficiaryName": "John Twain",
                "BeneficiaryCountry": "DE",
                "PostalCode": "80489",
                "StreetNumber": "31",
                "StreetName": "Handelsbank Elsenheimer Str.",
                "City": "München",
                "MerchantName": "Glory Amuah",
                "SenderCountry": "NG",
                "SenderAddress": "Lagos",
                "SenderMobileNumber": "+2348140244958",
                "AccountNumber": "FOREIGN-ACCOUNT",
                "Sender": "Glory Amuah",
                "Address": null,
                "MobileNumber": "23480000000000"
            }
        ],
        "narration": "Test GBP Int'l bank transfers",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 221064,
        "account_number": "0031625807099",
        "bank_code": "FNB",
        "full_name": "James Arthur",
        "created_at": "2023-11-08T14:01:31.000Z",
        "currency": "ZAR",
        "debit_currency": "ZAR",
        "amount": 500,
        "fee": 10,
        "status": "NEW",
        "reference": "e743ed584c954a91",
        "meta": [
            {
                "FirstName": "James",
                "LastName": "Arthur",
                "EmailAddress": "test@test.com",
                "MobileNumber": "+23457558595",
                "Address": "Lavington Nairobi",
                "MerchantName": "Glory Amuah",
                "SenderCountry": "NG",
                "SenderAddress": "Lagos",
                "SenderMobileNumber": "+2348140244958",
                "AccountNumber": "0031625807099",
                "RoutingNumber": "FNB",
                "Sender": "Glory Amuah"
            }
        ],
        "narration": "Withdraw Fiat",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "First National Bank"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 221062,
        "account_number": "100035129997",
        "bank_code": "ADIB",
        "full_name": "sarah ade",
        "created_at": "2023-11-08T13:55:39.000Z",
        "currency": "EGP",
        "debit_currency": "EGP",
        "amount": 100,
        "fee": 1,
        "status": "NEW",
        "reference": "9431f2328c68b367",
        "meta": [
            {
                "Sender": "Emmanuel V",
                "BeneficiaryMobileNumber": "06703933333",
                "SenderIdExpiry": "02/02/2026",
                "SenderDateOfBirth": "01/01/1997",
                "SenderIdNumber": "PAS23433389011",
                "SenderIdType": "Business registration / licence",
                "IsCashPickup": false,
                "BeneficiaryAddress": "123 mawin street",
                "BeneficiaryIdNumber": "ID546783332222",
                "TransferPurpose": "FOR MEDICAL TREATMENT",
                "BeneficiaryCountry": "EG",
                "SenderAddress": "Lagos",
                "SenderMobileNumber": "+2348140244958",
                "SenderCountry": "NG",
                "SenderDob": "01/01/1997",
                "SenderEmailAddress": "glory.amuah@flutterwavego.com",
                "MerchantName": "Glory Amuah",
                "BeneficiaryName": "sarah ade"
            }
        ],
        "narration": "egp test",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "Abu Dhabi Islamic Bank"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 127831,
        "account_number": "0031625807099",
        "bank_code": "GH280100",
        "full_name": "Flutterwave Developers",
        "created_at": "2020-06-25T11:24:01.000Z",
        "currency": "GHS",
        "amount": 50,
        "fee": 20,
        "status": "NEW",
        "reference": "new-GHS-test-transfer2",
        "meta": null,
        "narration": "Test GHS bank transfers",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "ACCESS BANK GH LTD"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 127886,
        "account_number": "2540782773934",
        "bank_code": "MPS",
        "full_name": "Flutterwave Developers",
        "created_at": "2020-06-25T14:03:51.000Z",
        "currency": "KES",
        "amount": 50,
        "fee": 45,
        "status": "NEW",
        "reference": "mk-902837-jk",
        "meta": null,
        "narration": "New transfer",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 127890,
        "account_number": "250780411008",
        "bank_code": "FMM",
        "full_name": "Flutterwave Developers",
        "created_at": "2020-06-25T14:11:45.000Z",
        "currency": "XAF",
        "amount": 50,
        "fee": 500,
        "status": "NEW",
        "reference": "new-franco-momo-test-transfer",
        "meta": null,
        "narration": "New franco transfer",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 217647,
        "account_number": "2217857532",
        "bank_code": "FREEMONEY",
        "full_name": "Taju Afobaje",
        "created_at": "2023-06-23T12:32:32.000Z",
        "currency": "XOF",
        "debit_currency": "XOF",
        "amount": 100,
        "fee": 2,
        "status": "NEW",
        "reference": "TRF-21928319023-231202",
        "meta": [
            {
                "Sender": "Agba Tester",
                "SenderCountry": "NG",
                "SenderAddress": "Lagos",
                "SenderMobileNumber": "+2348100001201"
            }
        ],
        "narration": "MoMo Transfer to Senegal",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 127889,
        "account_number": "233542773934",
        "bank_code": "MTN",
        "full_name": "Flutterwave Developers",
        "created_at": "2020-06-25T14:09:42.000Z",
        "currency": "RWF",
        "amount": 50,
        "fee": 45,
        "status": "NEW",
        "reference": "new-rwf-momo-transfer",
        "meta": null,
        "narration": "New RWF momo transfer",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 127894,
        "account_number": "233542773934",
        "bank_code": "MPS",
        "full_name": "Flutterwave Developers",
        "created_at": "2020-06-25T14:39:16.000Z",
        "currency": "UGX",
        "amount": 50,
        "fee": 500,
        "status": "NEW",
        "reference": "ugx-momo-transfer",
        "meta": null,
        "narration": "UGX momo transfer",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 8773850,
        "account_number": "250780411008",
        "bank_code": "MPS",
        "full_name": "Flutterwave Developers",
        "created_at": "2021-05-14T16:01:31.000Z",
        "currency": "ZMW",
        "amount": 50,
        "fee": 1.5,
        "status": "NEW",
        "reference": "new-ZMW-momo-test-transfer",
        "meta": null,
        "narration": "New ZMW transfer",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "Mobile Money"
    }
}
{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 128286,
        "account_number": 2587731,
        "bank_code": "flutterwave",
        "full_name": "FLUTTERWAVE V3 DOCS",
        "created_at": "2020-06-29T21:35:15.000Z",
        "currency": "NGN",
        "debit_currency": "NGN",
        "amount": 100,
        "fee": 0,
        "status": "NEW",
        "reference": "wallet-transfer",
        "meta": {
            "wallet_email": "deji+v3docs@flutterwavego.com",
            "AccountId": 118468,
            "merchant_id": "00118468"
        },
        "narration": "payment for x service provided",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "wallet"
    }
}
{
  "status": "success",
  "message": "Transfer Queued Successfully",
  "data": {
        "id": 6968703,
        "account_number": "+2348xxxxxxxx8",
        "bank_code": "barter",
        "full_name": "Flutterwave Developers",
        "created_at": "2021-02-10T11:32:59.000Z",
        "currency": "NGN",
        "amount": 20,
        "fee": 0,
        "status": "NEW",
        "reference": "barter-transfer-2",
        "meta": null,
        "narration": "Test",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}
{}

Retry a Transfer

This section describes how to retry a previously failed transfer.

post https://api.flutterwave.com/v3/transfers/:id/retries

Path Params

id int32

This is the unique identifier for the transfer you want to retry. It is returned in the call to create a transfer 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': 'POST',
  'url': '{{BASE_API_URL}}/transfers/166948/retries',
  'headers': {
    'Authorization': 'Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X',
    'Content-Type': 'application/json'
  }
};
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}}/transfers/166948/retries",
  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",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
require "uri"
require "net/http"

url = URI("{{BASE_API_URL}}/transfers/166948/retries")

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

response = http.request(request)
puts response.read_body
{
  "status": "success",
  "message": "Transfer retry attempt queued.",
  "data": {
    "id": 166948,
    "account_number": "0690000041",
    "bank_code": "044",
    "full_name": "Flutterwave Developers",
    "created_at": "2021-01-29T10:50:58.000Z",
    "currency": "NGN",
    "debit_currency": "NGN",
    "amount": 1000,
    "fee": 10.75,
    "status": "NEW",
    "reference": "TRF-640361604052_RETRY_2",
    "meta": null,
    "complete_message": "",
    "requires_approval": 0,
    "is_approved": 1,
    "bank_name": "ACCESS BANK NIGERIA"
  }
}
{}

Create a Bulk transfer

This section describes how to create a bulk transfer, i.e. a transfer attempt for multiple transfers.

post https://api.flutterwave.com/v3/bulk-transfers

Body Params

currency int32

The currency of the Transfer. Learn more about supported currencies here.

bulk_data object
An array of objects containing the transfer charge data. This array contains the same payload you would passed to create a single transfer with multiple different values.
first_name string

This is the first name of the transfer recipient.

last_name string

This is the last name of the transfer recipient.

email string

This is the email address of the transfer recipient.

mobile_number string

This is the mobile number of the recipient. If the recipient's email address is passed, this becomes an optional parameter.

recipient_address string

This is the address of the transfer recipient.

Show optional parameters

Headers

Authorization string

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

var axios = require('axios');
var data = JSON.stringify({
  "title": "Test_ZAR_Bulk_Transfers_1",
  "bulk_data": [
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 1900,
            "currency": "ZAR",
            "narration": "Test transfer to F4B Developers",
            "reference": "bulk_Transfers_0019_PMCK",
            "meta": [
                {
                "first_name": "F4B",
                "last_name": "Developers",
                "email": "developers@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 3200,
            "currency": "ZAR",
            "narration": "Test transfer to Support",
            "reference": "bulk_Transfers_0020_PMCK",
            "meta": [
                {
                "first_name": "Flutterwave",
                "last_name": "Support",
                "email": "support@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 6950,
            "currency": "ZAR",
            "narration": "Test transfer to Flutterwave Developers",
            "reference": "bulk_Transfers_0021_PMCK",
            "meta": [
                {
                "first_name": "Flutterwave",
                "last_name": "Developers",
                "email": "developers@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 1500,
            "currency": "ZAR",
            "narration": "Test transfer to Wavers",
            "reference": "bulk_Transfers_0022_PMCK",
            "meta": [
                {
                "first_name": "Wavers",
                "last_name": "N/A",
                "email": "hi@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        }
    ]
});

var config = {
  method: 'post',
  url: 'https://api.flutterwave.com/v3/bulk-transfers/',
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.flutterwave.com/v3/bulk-transfers/',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "title": "Test_ZAR_Bulk_Transfers_1",
    "bulk_data": [
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 1900,
            "currency": "ZAR",
            "narration": "Test transfer to F4B Developers",
            "reference": "bulk_Transfers_0019_PMCK",
            "meta": [
                {
                "first_name": "F4B",
                "last_name": "Developers",
                "email": "developers@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 3200,
            "currency": "ZAR",
            "narration": "Test transfer to Support",
            "reference": "bulk_Transfers_0020_PMCK",
            "meta": [
                {
                "first_name": "Flutterwave",
                "last_name": "Support",
                "email": "support@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 6950,
            "currency": "ZAR",
            "narration": "Test transfer to Flutterwave Developers",
            "reference": "bulk_Transfers_0021_PMCK",
            "meta": [
                {
                "first_name": "Flutterwave",
                "last_name": "Developers",
                "email": "developers@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 1500,
            "currency": "ZAR",
            "narration": "Test transfer to Wavers",
            "reference": "bulk_Transfers_0022_PMCK",
            "meta": [
                {
                "first_name": "Wavers",
                "last_name": "N/A",
                "email": "hi@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        }
    ]
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
require "uri"
require "json"
require "net/http"

url = URI("https://api.flutterwave.com/v3/bulk-transfers/")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X"
request.body = JSON.dump({
  "title": "Test_ZAR_Bulk_Transfers_1",
  "bulk_data": [
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 1900,
            "currency": "ZAR",
            "narration": "Test transfer to F4B Developers",
            "reference": "bulk_Transfers_0019_PMCK",
            "meta": [
                {
                "first_name": "F4B",
                "last_name": "Developers",
                "email": "developers@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 3200,
            "currency": "ZAR",
            "narration": "Test transfer to Support",
            "reference": "bulk_Transfers_0020_PMCK",
            "meta": [
                {
                "first_name": "Flutterwave",
                "last_name": "Support",
                "email": "support@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 6950,
            "currency": "ZAR",
            "narration": "Test transfer to Flutterwave Developers",
            "reference": "bulk_Transfers_0021_PMCK",
            "meta": [
                {
                "first_name": "Flutterwave",
                "last_name": "Developers",
                "email": "developers@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        },
        {
            "bank_code": "FNB",
            "account_number": "0031625807099",
            "amount": 1500,
            "currency": "ZAR",
            "narration": "Test transfer to Wavers",
            "reference": "bulk_Transfers_0022_PMCK",
            "meta": [
                {
                "first_name": "Wavers",
                "last_name": "N/A",
                "email": "hi@flutterwavego.com",
                "mobile_number": "+23457558595",
                "recipient_address": "234 Kings road, Cape Town"
                }
            ]
        }
    ]
})

response = https.request(request)
puts response.read_body
{
    "status": "success",
    "message": "Bulk transfer queued",
    "data": {
        "id": 2013,
        "created_at": "2020-01-20T16:36:29.000Z",
        "approver": "N/A"
    }
}

{}

Get Transfer fees

This endpoint help the merchant/developer query the fee for the transfer being made.

get https://api.flutterwave.com/v3/transfers/fee

Query Params

amount int32

This is the amount to be transferred.

Show optional parameters

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}}/transfers/fee?amount=10000',
  '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}}/transfers/fee?amount=10000",
  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}}/transfers/fee?amount=10000")

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": "Transfer fee fetched",
    "data": [
        {
            "fee_type": "value",
            "currency": "NGN",
            "fee": 45
        },
        {
            "fee_type": "value",
            "currency": "KES",
            "fee": 100
        },
        {
            "fee_type": "value",
            "currency": "GHS",
            "fee": 5
        },
        {
            "fee_type": "value",
            "currency": "USD",
            "fee": 40
        },
        {
            "fee_type": "value",
            "currency": "UGX",
            "fee": 5000
        },
        {
            "fee_type": "value",
            "currency": "TZS",
            "fee": 3000
        },
        {
            "fee_type": "value",
            "currency": "GBP",
            "fee": 35
        },
        {
            "fee_type": "value",
            "currency": "EUR",
            "fee": 35
        },
        {
            "fee_type": "value",
            "currency": "ZMW",
            "fee": 62.6
        },
        {
            "fee_type": "value",
            "currency": "ZAR",
            "fee": 10
        },
        {
            "fee_type": "value",
            "currency": "RWF",
            "fee": 1000
        }
    ]
}
{}

Get all Transfers

This endpoint allows the developer/merchant to spool all their transfers.

get https://api.flutterwave.com/v3/transfers

Query Params

Show optional parameters

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}}/transfers',
  '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}}/transfers",
  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}}/transfers")

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": "Transfers fetched",
    "meta": {
        "page_info": {
            "total": 150,
            "current_page": 1,
            "total_pages": 15
        }
    },
    "data": [
        {
            "id": 26255,
            "account_number": "0690000034",
            "bank_code": "044",
            "full_name": "Ade Bond",
            "created_at": "2020-01-20T16:36:33.000Z",
            "currency": "NGN",
            "debit_currency": null,
            "amount": 5000,
            "fee": 53750,
            "status": "PENDING",
            "reference": "akhlm-blktrnsfr-xy03",
            "meta": null,
            "narration": "akhlm blktrnsfr",
            "approver": null,
            "complete_message": "Transaction is currently being processed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "ACCESS BANK NIGERIA"
        },
        {
            "id": 26254,
            "account_number": "0690000034",
            "bank_code": "044",
            "full_name": "Ade Bond",
            "created_at": "2020-01-20T16:34:41.000Z",
            "currency": "NGN",
            "debit_currency": null,
            "amount": 5000,
            "fee": 53750,
            "status": "PENDING",
            "reference": "akhlm-blktrnsfr-xy02",
            "meta": null,
            "narration": "akhlm blktrnsfr",
            "approver": null,
            "complete_message": "Transaction is currently being processed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "ACCESS BANK NIGERIA"
        },
        {
            "id": 26252,
            "account_number": "0690000040",
            "bank_code": "042",
            "full_name": "N/A",
            "created_at": "2020-01-20T16:10:30.000Z",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 5500,
            "fee": 45,
            "status": "FAILED",
            "reference": "akhlm-pstmnpyt-rfxx008_PMCKDU_1",
            "meta": null,
            "narration": "Akhlm Pstmn Trnsfr xx008",
            "approver": null,
            "complete_message": "Account resolve failed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "N/A"
        },
        {
            "id": 26251,
            "account_number": "0690000040",
            "bank_code": "044",
            "full_name": "Alexis Sanchez",
            "created_at": "2020-01-20T16:09:34.000Z",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 5500,
            "fee": 45,
            "status": "PENDING",
            "reference": "akhlm-pstmnpyt-rfxx007_PMCKDU_1",
            "meta": null,
            "narration": "Akhlm Pstmn Trnsfr xx007",
            "approver": null,
            "complete_message": "Transaction is currently being processed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "ACCESS BANK NIGERIA"
        },
        {
            "id": 26250,
            "account_number": "0690000040",
            "bank_code": "041",
            "full_name": "N/A",
            "created_at": "2020-01-20T16:08:43.000Z",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 5500,
            "fee": 45,
            "status": "FAILED",
            "reference": "akhlm-pstmnpyt-rfxx006_PMCKDU_1",
            "meta": null,
            "narration": "Akhlm Pstmn Trnsfr xx006",
            "approver": null,
            "complete_message": "Account resolve failed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "N/A"
        },
        {
            "id": 26249,
            "account_number": "0690000039",
            "bank_code": "041",
            "full_name": "N/A",
            "created_at": "2020-01-20T16:08:09.000Z",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 5500,
            "fee": 45,
            "status": "FAILED",
            "reference": "akhlm-pstmnpyt-rfxx005_PMCKDU_1",
            "meta": null,
            "narration": "Akhlm Pstmn Trnsfr xx005",
            "approver": null,
            "complete_message": "Account resolve failed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "N/A"
        },
        {
            "id": 26248,
            "account_number": "0690000044",
            "bank_code": "041",
            "full_name": "N/A",
            "created_at": "2020-01-20T16:07:35.000Z",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 5500,
            "fee": 45,
            "status": "FAILED",
            "reference": "akhlm-pstmnpyt-rfxx004_PMCKDU_1",
            "meta": null,
            "narration": "Akhlm Pstmn Trnsfr xx004",
            "approver": null,
            "complete_message": "Account resolve failed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "N/A"
        },
        {
            "id": 26169,
            "account_number": "0690000034",
            "bank_code": "044",
            "full_name": "Ade Bond",
            "created_at": "2020-01-19T23:04:14.000Z",
            "currency": "NGN",
            "debit_currency": null,
            "amount": 500,
            "fee": 5375,
            "status": "PENDING",
            "reference": "akhlm-blktrnsfr-xy01",
            "meta": null,
            "narration": "akhlm blktrnsfr",
            "approver": null,
            "complete_message": "Transaction is currently being processed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "ACCESS BANK NIGERIA"
        },
        {
            "id": 26168,
            "account_number": "0690000041",
            "bank_code": "044",
            "full_name": "Alexis Rogers",
            "created_at": "2020-01-19T22:49:08.000Z",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 5500,
            "fee": 45,
            "status": "PENDING",
            "reference": "akhlm-pstmnpyt-rfxx002_PMCK",
            "meta": null,
            "narration": "Akhlm Pstmn Trnsfr xx002",
            "approver": null,
            "complete_message": "Transaction is currently being processed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "ACCESS BANK NIGERIA"
        },
        {
            "id": 26167,
            "account_number": "0690000044",
            "bank_code": "044",
            "full_name": "Mercedes Daniel",
            "created_at": "2020-01-19T22:44:03.000Z",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 5500,
            "fee": 45,
            "status": "PENDING",
            "reference": "akhlm-pstmnpyt-rfxx001_PMCKDU_1",
            "meta": null,
            "narration": "Akhlm Pstmn Trnsfr xx001",
            "approver": null,
            "complete_message": "Transaction is currently being processed",
            "requires_approval": 0,
            "is_approved": 1,
            "bank_name": "ACCESS BANK NIGERIA"
        }
    ]
}

{}

Fetch a Transfer

This endpoint helps you fetch the details of a transfer.

get https://api.flutterwave.com/v3/transfers/:id

Path Params

id int32

This is the numeric ID of the transfer you want to fetch. It is returned in the call to create a transfer 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}}/transfers/26251',
  '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}}/transfers/26251",
  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}}/transfers/26251")

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": "Transfer fetched",
    "data": {
        "id": 1933222,
        "account_number": "0251238458",
        "bank_code": "058",
        "full_name": " Flutterwave Developers",
        "created_at": "2020-06-11T00:36:20.000Z",
        "currency": "NGN",
        "debit_currency": "NGN",
        "amount": 300,
        "fee": 10.75,
        "status": "SUCCESSFUL",
        "reference": "new-actual-transfer-ref1",
        "meta": null,
        "narration": "Akhlm Pstmn Trnsfr xx007",
        "approver": null,
        "complete_message": "Transaction was successful",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "GTBANK PLC"
    }
}

{}

Fetch a Transfer Retry

This endpoint helps you fetch the details of a transfer retry.

get https://api.flutterwave.com/v3/transfers/:id/retries

Path Params

id int32

This is the numeric ID of the transfer you want to fetch. It is returned in the call to create a transfer 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}}/transfers/166765/retries',
  '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}}/transfers/166765/retries",
  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}}/transfers/166765/retries")

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": "Transfer retry attempts retrieved.",
    "data": [
        {
            "id": 166947,
            "account_number": "0690000041",
            "bank_code": "044",
            "bank_name": "ACCESS BANK NIGERIA",
            "full_name": "Alexis Rogers",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 1000,
            "fee": 10.75,
            "status": "FAILED",
            "reference": "TRF-640361604052_RETRY_1",
            "narration": null,
            "complete_message": "Transaction is currently being processed",
            "meta": null,
            "requires_approval": 0,
            "is_approved": 1,
            "created_at": "2021-01-29T10:42:14.000Z"
        },
        {
            "id": 166948,
            "account_number": "0690000041",
            "bank_code": "044",
            "bank_name": "ACCESS BANK NIGERIA",
            "full_name": "Alexis Rogers",
            "currency": "NGN",
            "debit_currency": "NGN",
            "amount": 1000,
            "fee": 10.75,
            "status": "PENDING",
            "reference": "TRF-640361604052_RETRY_2",
            "narration": null,
            "complete_message": "Transaction is currently being processed",
            "meta": null,
            "requires_approval": 0,
            "is_approved": 1,
            "created_at": "2021-01-29T10:50:58.000Z"
        }
    ]
}

{}

Fetch a Bulk Transfer

This endpoint helps you get the status and details of a bulk transfer.

get https://api.flutterwave.com/v3/transfers

Query Params

batch_id int32

This is the numeric ID of the bulk transfer you want to fetch. It is returned in the call to create a bulk transfer 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}}/transfers?26251',
  '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}}/transfers?26251",
  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}}/transfers?26251")

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": "Transfer fetched",
    "data": {
        "id": 1933222,
        "account_number": "0251238458",
        "bank_code": "058",
        "full_name": " Kendrick Graham",
        "created_at": "2020-06-11T00:36:20.000Z",
        "currency": "NGN",
        "debit_currency": "NGN",
        "amount": 300,
        "fee": 10.75,
        "status": "SUCCESSFUL",
        "reference": "new-actual-transfer-ref1",
        "meta": null,
        "narration": "Akhlm Pstmn Trnsfr xx007",
        "approver": null,
        "complete_message": "Transaction was successful",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "GTBANK PLC"
    }
}
{}

Get Transfer Rates

This endpoint helps you to querys the transfer rate for international transfers.

get https://api.flutterwave.com/v3/transfers/rates

Query Params

amount int32

This is the amount to transfer to the recipient.

destination_currency string

This is the currency of the wallet you are making a transfer to.

source_currency string

This is the currency of the wallet being debited for the transfer.

Headers

Authorization string

Pass your secret key as a bearer token in the request header to authorize this call. Unauthorized calls would return a 401 http code or raise unauthorized error in the different SDKs.

{
    "status": "success",
    "message": "Transfer amount fetched",
    "data": {
        "rate": 624.24,
        "source": {
            "currency": "NGN",
            "amount": 624240
        },
        "destination": {
            "currency": "USD",
            "amount": 1000
        }
    }
}
{}
More on Transfer rates.
This endpoint is particularly for Flutterwave developers and merchants making interwallet transfers, it is not meant for checking conversation rates. To properly make use of this endpoint. You should read our notes on rates.
Loading...