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

Bank account transfers

Hey👋. We recommend checking out the overview to understand the basics of making transfers first.

Send money quickly to different bank accounts across multiple countries with Flutterwave. You can see supported currencies and countries below.

CurrencySupported Countries
EURSEPA countries
GBPUK
GHSGhana
KESKenya
NGNNigeria
SLLSierra Leone
TZSTanzania
UGXUganda
USDNigeria (domicilliary account), US
XAFCameroon, Chad, DR Congo, Gabon
XOFBenin, Côte d'Ivoire, Senegal
ZARSouth Africa

In this explainer, we cover the essentials of making a bank account transfer. Kindly refer to our overview for more information on the entire transfer process.

Initiating Bank transfers

When making a bank transfer, you need to follow these steps:

  • Collect the required details. In most cases, only the recipient's details are necessary. However, you'll also need the customer's details for certain transfers.
  • Get the required bank codes: query our banks endpoints to get the appropriate bank codes for the transfer.

Transfers to Benin, Cameroon, Chad, Côte d’Ivoire, DR Congo, Gabon, Ghana, Malawi, Rwanda, Senegal, Sierra Leone, Tanzania, and Uganda all require destination_branch_code.

You can query this code using the bank branches endpoint.

  • Send the details to the initiate transfer endpoint. See example requests in the next section.

Tanzania Bank Transfers

Feature request

Transfers to Tanzanian bank accounts are not available by default. You need to request to have this feature enabled.

Send money to Tanzanian Bank Accounts.

Pre-requisites

  1. Complete your KYC and ensure that your account is approved for transactions.
  2. Request for this feature on your account via email or our support form.
  3. Whitelist your server IP addresses to prevent security errors.
  4. Fund your TZS balance. You can do this by:
    • Directly funding via collections, this funding method is limited to a max value equivalent to $1,000.
    • Indirect funding via FX conversion from a different currency balance i.e. wallet-to-wallet transfers.

Basic terminology

  • Sender: This is the customer initiating the transfer. Some of their details are required to complete the payouts.
  • Beneficiary: This is the individual receiving the transfer.

Payout flow

Like most transfers on Flutterwave, TZS bank transfers are easy to execute. Simply follow these steps to make these transfers:

  • Collect the sender and beneficiary's information. Some important information to collect include the account information, sender's name and address.
{
  "reference": "", #merchant_input
  "currency": "", #merchant_input
  "amount": 0.0, #merchant_input
  "callback_url": "", #merchant_input
  "narration": "", #merchant_input
  "debit_currency": "", #merchant_input
  "debit_subaccount": "",#merchant_input
  "account_bank": "", #beneficiary_information
  "account_number": "",#beneficiary_information
  "beneficiary_name": "", #beneficiary_information
  "meta": [
    {
      "sender": "", #sender_information
      "sender_country": "",#sender_information
      "sender_address": "" #sender_information
    }
  ]
}

  • Fetch the beneficiary's bank code using the bank and banks branches endpoints.

  • Send your payment request with all the needed transfer information to the transfers endpoint to create the payout.

{
  "reference": "YOUR_TRANSFER_REFERENCE",
  "currency": "TZS",
  "amount": 50,
  "callback_url": "https://example.com", #Optional
  "narration": "Test TZS Bank Transfer.", #Optional
  "debit_currency": "NGN", #Optional
  "debit_subaccount": "PSAFF2118D1A33844332",#Optional 
  "account_bank": "11288192",
  "account_number": "233500000000",
  "beneficiary_name": "Example User",
  "meta": [
    {
      "sender": "Sample Usermon",
      "sender_country": "TZ",
      "sender_address": "Block-8 Kivukoni Road"
    }
  ]
}


{
 "status": "success",
 "message": "Transfer Queued Successfully",
 "data": {
   "id": 641154,
   "account_number": "0112728000",
   "bank_code": "11288192",
   "full_name": "Example User",
   "created_at": "2024-07-29T11:36:14.000Z",
   "currency": "TZS",
   "debit_currency": "NGN",
   "amount": 1000,
   "fee": 1000,
   "status": "NEW",
   "reference": "4d2ba109f22cd912",
   "meta": [
     {
       "Sender": "Sample User",
       "SenderCountry": "TZ",
       "SenderAddress": "Block-XM Kivukoni Road"
     }
   ],
   "narration": "Payment for goods",
   "complete_message": "",
   "requires_approval": 0,
   "is_approved": 1,
   "bank_name": "Tanzania Agricultural Development Bank"
 }
}

  • Verify your transfer status, there are many ways to do this:

    • You can poll the transfer status using the transfer status endpoint.
    • If you have webhooks enabled on your dashboard, check the transfer webhooks to confirm it's status.
    • For transfers with callback_id, We'll send the transfer details with its status using the specified URL.
{
   "event": "transfer.completed",
   "event.type": "Transfer",
   "data": {
    "id": 641154,
    "account_number": "233500000000",
    "bank_name": "Tanzania Agricultural Development Bank",
    "bank_code": "11288192",
    "fullname": "Example User",
    "created_at": "2024-07-29T11:36:14.000Z",
    "currency": "TZS",
    "debit_currency": "NGN",
    "amount": 1000,
    "fee": 1000,
    "status": "SUCCESSFUL",
    "reference": "4d2ba109f22cd912",
    "meta": [
      {
        "Sender": "Sample Usermon",
        "SenderCountry": "TZ",
        "SenderAddress": "Block-XM Kivukoni Road"
      }
    ],
    "narration": "Payment for goods",
    "approver": null,
    "complete_message": "Successful",
    "requires_approval": 0,
    "is_approved": 1
   }
 }

{
    "status": "success",
    "message": "Transfer fetched",
    "data": {
        "id": 641154,
        "account_number": "233500000000",
        "bank_code": "11288192",
        "full_name": "Example User",
        "created_at": "2024-07-29T11:36:14.000Z",
        "currency": "TZS",
        "debit_currency": "NGN",
        "amount": 1000,
        "fee": 1000,
        "status": "SUCCESSFUL",
        "reference": "4d2ba109f22cd912",
        "meta": [
            {
                "sender": "Sample User"
            }
        ],
        "narration": "Payment for goods",
        "approver": null,
        "complete_message": "Successful",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "Tanzania Agricultural Development Bank"
    }
}

Be sure to visit our testing helpers documentation for information on how to test your transfers.

Ethiopian Bank Transfers

Send funds to Ethiopian bank accounts.

Pre-requisites

  1. Complete your KYC and ensure that your account is approved for transactions.
  2. Whitelist your server IP addresses to prevent security errors.
  3. Ensure your balance has sufficient funds. If needed, fund it using an alternate balance, see the list of supported currencies for ETB transfers.

Payout flow

Here are the steps to send money to Ethiopian bank accounts:

  • Collect the beneficiary's details name, bank, and account number. You also need to specify additional information, see the expected data requirements below:
{
  "reference": "", #merchant_input
  "currency": "", #merchant_input
  "amount": 0.0, #merchant_input
  "callback_url": "", #merchant_input
  "narration": "", #merchant_input
  "debit_currency": "", #merchant_input
  "debit_subaccount": "",#merchant_input
  "account_bank": "", #beneficiary_information
  "account_number": "",#beneficiary_information
  "beneficiary_name": "",#beneficiary_information
}

  • Fetch the beneficiary's bank code. Send this as the account_bank in your request.

  • Include the debit_currency parameter in your request to debit from a different currency balance.

  • Initiate your transfer using the required data and the transfers endpoint.

{
  "reference": "YOUR_TRANSFER_REFERENCE", #Optional
  "currency": "ETB"
  "amount": 50,
  "callback_url": "https://example.com", #Optional
  "narration": "Test ETB Bank Transfer.", #Optional
  "debit_currency": "NGN", #Optional
  "debit_subaccount": "PSAFF2118D1A33844332",#Optional 
  "account_bank": "1",
  "account_number": "1234567840",
  "beneficiary_name": "Example User"
}


{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 80472315,
        "account_number": "1234567840",
        "bank_code": "1",
        "full_name": "Example User",
        "created_at": "2024-08-07T13:08:03.000Z",
        "currency": "ETB",
        "debit_currency": "NGN",
        "amount": 50,
        "fee": 505.61,
        "status": "NEW",
        "reference": "YOUR_TRANSFER_REFERENCE",
        "meta": [
            "{\"meta_name\":\"fee currency conversion\",\"from_currency\":\"USD\",\"from_amount\":5,\"to_currency\":\"ETB\",\"to_amount\":505.61,\"rate\":101.12236013}"
        ],
        "narration": "Test ETB Bank Transfer.",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "Abay Bank S.C."
    }
}

  • Verify your transfer status, there are many ways to do this:

    • You can poll the transfer status using the transfer status endpoint.
    • If you have webhooks enabled on your dashboard, check the transfer webhooks to confirm it's status.
    • For transfers with callback_id, We'll send the transfer details with its status using the specified URL.
{
  "event": "transfer.completed",
  "event.type": "Transfer",
  "data": {
    "id": 641197,
    "account_number": "1234567840",
    "bank_name": "Abay Bank S.C.",
    "bank_code": "1",
    "fullname": "Frank Jones",
    "created_at": "2024-07-29T15:05:15.000Z",
    "currency": "ETB",
    "debit_currency": "NGN",
    "amount": 100,
    "fee": 0,
    "status": "SUCCESSFUL",
    "reference": "TEST_Transfer_001234_success_mock",
    "meta": [
      "{\"meta_name\":\"fee currency conversion\",\"from_currency\":\"USD\",\"from_amount\":5,\"to_currency\":\"ETB\",\"to_amount\":null}"
    ],
    "narration": "Sample Ethiopia Transfer",
    "approver": null,
    "complete_message": "Successful",
    "requires_approval": 0,
    "is_approved": 1
  }
}

{
    "status": "success",
    "message": "Transfer fetched",
    "data": {
        "id": 641197,
        "account_number": "1234567840",
        "bank_code": "1",
        "full_name": "Frank Jones",
        "created_at": "2024-07-29T15:05:15.000Z",
        "currency": "ETB",
        "debit_currency": "NGN",
        "amount": 100,
        "fee": 0,
        "status": "SUCCESSFUL",
        "reference": "TEST_Transfer_001234_success_mock",
        "meta": [
            {
                "meta_name": "fee currency conversion",
                "from_currency": "USD",
                "from_amount": 5,
                "to_currency": "ETB",
                "to_amount": null
            }
        ],
        "narration": "Sample Ethiopia Transfer",
        "approver": null,
        "complete_message": "Successful",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "Abay Bank S.C."
    }
}

Be sure to visit our testing helpers documentation for information on how to test your transfers.

Examples

Here are some examples to help your implementation.

Transfers to NGN Accounts

{
    "account_bank": "044",
    "account_number": "1234567840",
    "amount": 200,
    "narration": "Payment for things",
    "currency": "NGN",
    "reference": "jh678b3kol1Z",
    "callback_url": "https://webhook.site/b3e505b0-fe02-430e-a538-22bbbce8ce0d",
    "debit_currency": "NGN"
}

Transfers to USD Accounts

These examples demonstrate transfers to USD and USD-domicilliary accounts (First Bank, FCMB, Polaris Bank, UBA, Wema Bank, and Zenith Bank).

{
  "amount": 500,
  "narration": "Sample USD Transfer",
  "currency": "USD",
+ "beneficiary_name": "Mark Cuban",
  "meta": [
    {
+     "account_number": "09182972BH",
+     "routing_number": "0000000002993",
+     "swift_code": "ABJG190",
+     "bank_name": "BANK OF AMERICA, N.A., SAN FRANCISCO, CA",
+     "beneficiary_name": "Mark Cuban",
+     "beneficiary_address": "San Francisco, 4 Newton",
+     "beneficiary_country": "US"
    }
  ]
}

{
  "account_number": "5090280719",
  "account_bank": "214",
  "amount": 2000,
  "currency": "USD",
  "narration": "Example FCMB DOM Payout",
  "reference": "SAMPLE-REF",
+ "beneficiary_name": "Tobi Jones",
  "meta": [
    {
+      "sender": "Flutterwave Developers",
+      "sender_address": "35a, Ladi Alakija Avenue, Lekki",
+      "sender_country": "NG",
+      "sender_id_number": "00000000000",
+      "sender_id_type": "drivers license",
+      "sender_id_expiry": "05-2023",
+      "sender_mobile_number": "2348000000000",
+      "sender_occupation": "Consultant",
+      "sender_beneficiary_relationship": "Customer",
+      "recipient_address": "19, Olubunmi Rotimi street, Lekki",
+      "beneficiary_country": "NG",
+      "mobile_number": "2348000000000",
+      "email": "tobi@jones.com",
+      "beneficiary_occupation": "Student",
+      "transfer_purpose": "Wallet withdrawal", 
    }
  ]
}

{
  "account_bank": "044",
  "account_number": "1234567840",
  "amount": 3000,
  "currency": "USD",
  "narration": "Example Fidelity Bank DOM Payout",
  "reference": "SAMPLE-REF",
  "meta": [
    {
+      "sender": "Another User",
+      "sender_city": "Abuja",
+      "first_name": "Example",
+      "last_name": "User",
+      "email": "user@example.com",
+      "beneficiary_country": "NG",
+      "mobile_number": "+2348010901234",
+      "merchant_name": "Spotify"
    }
  ]
}

{
  "account_number": "5090280719",
  "account_bank": "101",
  "amount": 1000,
  "currency": "USD",
  "narration": "Example Providus DOM Payout",
+ "beneficiary_name": "Example User",
  "meta": [
    {
+      "sender": "Test User",
+      "sender_address": "35a Ladi Alakija Avenue lekki1",
+      "sender_city": "Lekki",
+      "sender_country": "NG",
+      "sender_id_number": "22244857954",
+      "sender_mobile_number": "+2348022913114",
+      "sender_email_address": "tester@example.com",
+      "first_name": "Example",
+      "last_name": "User",
+      "recipient_address": "TinCan VI",
+      "beneficiary_state": "Lagos",
+      "beneficiary_country": "NG",
+      "beneficiary_mobile_number": "2348022913114",
+      "routing_number": "101",
+      "account_number": "5090280719",
    }
  ]
}

{
  "account_bank": "044",
  "account_number": "1234567840",
  "amount": 2400,
  "currency": "USD",
  "narration": "Example Union Bank DOM Payout",
  "reference": "SAMPLE-REF",
  "meta": [
    {
+      "sender": "Another User",
+      "sender_city": "Abuja",
+      "first_name": "Example",
+      "last_name": "User",
+      "email": "user@example.com",
+      "beneficiary_country": "NG",
+      "mobile_number": "+2348010901234",
+      "merchant_name": "Spotify"
    }
  ]
}

{
  "account_bank": "044",
  "account_number": "1234567840",
  "amount": 2000,
  "currency": "USD",
  "narration": "Example DOM Payout",
  "reference": "SAMPLE-REF",
  "meta": [
    {
+      "sender": "Another User",
+      "first_name": "Example",
+      "last_name": "User",
+      "email": "user@example.com",
+      "beneficiary_country": "NG",
+      "mobile_number": "+2348131133933",
+      "merchant_name": "Spotify"
    }
  ]
}

Transfers to EUR and GBP accounts

{
  "amount": 500,
  "narration": "Sample EUR Transfer",
  "currency": "EUR",
+ "beneficiary_name": "John Twain",
  "meta": [
    {
+     "account_number": "DA091983888373BGH",
+     "routing_number": "BECFDE7HKKX",
+     "swift_code": "BECFDE7HKKX",
+     "bank_name": "LLOYDS BANK",
+     "beneficiary_name": "John Twain",
+     "beneficiary_country": "DE",
+     "postal_code": "80489",
+     "street_number": "31",
+     "street_name": "Handelsbank Elsenheimer Str.",
+     "city": "München"
    }
  ]
}

{
  "amount": 500,
  "narration": "Sample GBP Transfers",
  "currency": "GBP",
+ "beneficiary_name": "John Twain",
  "meta": [
    {
+     "account_number": "DA091983888373BGH",
+     "routing_number": "BECFDE7HKKX",
+     "swift_code": "BECFDE7HKKX",
+     "bank_name": "LLOYDS BANK",
+     "beneficiary_name": "John Twain",
+     "beneficiary_country": "UK",
+     "postal_code": "80489",
+     "street_number": "31",
+     "street_name": "Handelsbank Elsenheimer Str.",
+     "city": "London"
    }
  ]
}

Transfer to African Bank Accounts

{
    "account_bank": "GH280100",
    "account_number": "0031625807099",
    "amount": 500,
    "narration": "Test GHS bank transfers",
    "currency": "GHS",
+   "destination_branch_code": "GH280103",
+   "beneficiary_name": "Kwame Adew"
}

{
    "account_bank": "68",
    "account_number": "0031625807099",
    "amount": 500,
    "narration": "SAMPLE KES TRANSFER",
    "currency": "KES",
    "beneficiary_name": "James Arthur",
    "meta": 
        {
+           "sender": "James Arthur",
+           "sender_country": "NG",
+           "mobile_number": "+23457558595"
        }
}

{
    "account_bank": "97964560",
    "account_number": "1234567840",
    "amount": 100000,
    "narration": "SAMPLE MWK TRANSFER",
    "currency": "MWK",
    "debit_currency": "NGN",
    "beneficiary_name": "NWABALI S.",
    "destination_branch_code": "18120510PC"
}

{
    "account_bank": "SL009000",
    "account_number": "386745674657",
    "beneficiary_name": "NWABALI S.",
+   "currency": "SLL",
    "debit_currency": "USD",
    "amount": 1000,
+   "destination_branch_code": "SL009003"
}

{
    "account_number": "0112728000",
    "account_bank": "11288192",
    "amount": 1000,
    "narration": "Payment for goods",
    "currency": "TZS",
    "debit_currency": "NGN",
    "beneficiary_name": "Isaac Mutombo",
    "reference": "TRF_01025",
    "meta": [
        {
+           "Sender": "Hydra Bella",
+           "SenderCountry": "NG",
+           "SenderAddress": "Block-8 Kivukoni Road"
        }
    ]
}

{
    "account_bank": "GH280100",
    "account_number": "0031625807099",
    "amount": 500,
    "narration": "SAMPLE UGX TRANSFER",
    "currency": "UGX",
+   "destination_branch_code": "GH280103",
+   "beneficiary_name": "NWABALI S."
}

{
    "account_bank": "TD60005",
    "account_number": "2217857532",
    "beneficiary_name": "Taju Afobaje",
    "amount": 100,
    "narration": "Sample XAF Transfer",
    "currency": "XAF",
    "debit_currency": "XAF",
    "destination_branch_code": "TD60005001"
}

{
    "account_bank": "TD60005",
    "account_number": "2217857532",
    "beneficiary_name": "Taju Afobaje",
    "amount": 100,
    "narration": "Sample XOF Transfer",
    "currency": "XOF",
    "debit_currency": "XAF",
    "destination_branch_code": "TD60005001"
}

{
    "account_bank": "FNB",
    "account_number": "0031625807099",
    "amount": 500,
    "narration": "Withdraw Fiat",
    "currency": "ZAR",
    "meta": 
        {
+           "first_name": "James",
+           "last_name": "Arthur",
+           "email": "test@test.com",
+           "mobile_number": "+23457558595",
+           "recipient_address": "Lavington Nairobi"
        }
}

Transfer Response

Depending on the type of transfer you initiate, you will receive a response similar to any of these:

{
  "status": "success",
  "message": "Transfer Queued Successfully",
  "data": {
    "id": 26251,
    "account_number": "1234567840",
    "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": "1234567836",
        "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": "1234567836",
                "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": 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": 222402,
        "account_number": "386745674657",
        "bank_code": "SL009000",
        "full_name": "test account",
        "created_at": "2024-02-06T16:28:47.000Z",
        "currency": "SLL",
        "debit_currency": "USD",
        "amount": 1000,
        "fee": 45,
        "status": "NEW",
        "reference": "8be86bbdd1e06bf1",
        "meta": null,
        "narration": "From Glory Amuah",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}

{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 222400,
        "account_number": "1234567840",
        "bank_code": "97964560",
        "full_name": "Dora Explorer",
        "created_at": "2024-02-06T16:25:27.000Z",
        "currency": "MWK",
        "debit_currency": "NGN",
        "amount": 100000,
        "fee": 2000,
        "status": "NEW",
        "reference": "3d79854fdc856c7c",
        "meta": null,
        "narration": "ecobank mw test",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "First Discount House Limited"
    }
}

{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 222395,
        "account_number": "2217857532",
        "bank_code": "TD60005",
        "full_name": "Taju Afobaje",
        "created_at": "2024-02-06T15:08:07.000Z",
        "currency": "XAF",
        "debit_currency": "XAF",
        "amount": 100,
        "fee": 45,
        "status": "NEW",
        "reference": "3b1a1859b8cee27f",
        "meta": null,
        "narration": "Bank Transfer to Chad",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}

{}

As always, you'll notice that the data.status of the transfer is "NEW". Remember to set up a webhook or call the get transfer endpoint to find out when the transfer is completed. See Transfers: Overview for details.

Loading...