DocumentationRecipesAPI ReferencesSupportBlog
Documentation

Bank Account Transfer

Learn how to make bank account transfers.

Suggest Edits

📘

Getting Started

We recommend checking out the introductory section 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). USD
XAFCameroon, Chad, DR Congo, Gabon
XOFBenin, Côte d'Ivoire, Senegal
ZARSouth Africa

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: Make a request to our banks endpoints to get the appropriate bank codes for the transfer.

📘

Integration Tip

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 get the bank_branch_code using the bank branches endpoint.

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

Tanzania Bank Transfer

ℹ️

Feature Request

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

Prerequisites

  1. Complete your KYC and ensure that your account is approved for transactions.
  2. Request this feature on your account via email or our support form.
  3. Whitelist your server IP address 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

  • Sending: This is 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:

  1. Collect the sender and beneficiary's information. Some important information to collect includes 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
    }
  ]
}
  1. Fetch the beneficiary's bank code using the bank and banks branches endpoints.
  2. 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"
    }
  ]
}

You'll get a response like this:

{
	"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"
	}
}

  1. Verify your transfer status; there are many ways to do this:

    • You can get 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 their 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 helper's documentation on testing for information on how to test your transfers.

Ethiopian Bank Transfer

Send funds to Ethiopian bank accounts.

Prerequisites

  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.

  1. 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
}

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

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

  3. Initiate your transfer using the required data and the transfer 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"
}

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

    • You can get the transfer status using the transfer status endpoint.
    • If you have webhooks enabled on your dashboard, check the transfer webhooks to confirm its 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
  }
}

You'll get a response like this:

{
	"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 you with implementation.

Transfer 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-domiciliary 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": "[email protected]",
			"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": "[email protected]",
			"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": "[email protected]",
			"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": "[email protected]",
      "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": "[email protected]",
			"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 Account


{
"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": "[email protected]",
		"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": "[email protected]",
				"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": "[email protected]",
				"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.

Updated 25 days ago