> ## Documentation Index
> Fetch the complete documentation index at: https://flutterwaveinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Bank Account Transfer
> Learn how to make bank account transfers.
We recommend checking out the [introductory section](/fund-transfer/introduction) 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.
| Currency | Supported Countries |
| -------- | ------------------------------------------------------------------------------------------- |
| EUR | [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html) |
| GBP | UK |
| GHS | Ghana |
| KES | Kenya |
| NGN | Nigeria |
| SLL | Sierra Leone |
| TZS | Tanzania |
| UGX | Uganda |
| USD | Nigeria (domicilliary account). USD |
| XAF | Cameroon, Chad, DR Congo, Gabon |
| XOF | Benin, Côte d'Ivoire, Senegal |
| ZAR | South 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](/api-reference/banks/get-all-banks) 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 get the `bank_branch_code` using the
[bank branches endpoint](/api-reference/banks/get-bank-branches).
* 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](https://flutterwave.com/ng/support/submit-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](/hi@flutterwavego.com) or our [support form](https://flutterwave.com/ng/support/submit-request).
3. [Whitelist](https://flutterwave.com/ng/support/integrations/how-to-whitelist-ip-addresses-on-your-flutterwave-dashboard) your server IP address to prevent security errors.
4. Fund your TZS balance. You can do this by:
* Directly funding via [collections](/payments-embed/introduction), this funding method is limited to a max value equivalent to \$1,000.
* [Indirect funding](/fund-transfer/wallet-to-wallet) 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.
```json Sample Request theme={null}
{
"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
}
]
}
```
2. Fetch the beneficiary's bank code using the [bank](/api-reference/banks/get-all-banks) and [banks branches](/api-reference/banks/get-bank-branches) endpoints.
3. Send your payment request with all the needed transfer information to the [transfers](/api-reference/transfers/initiate-a-transfer) endpoint to create the payout.
```json Sample Request theme={null}
{
"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:
```json 200 OK theme={null}
{
"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"
}
}
```
4. Verify your transfer status; there are many ways to do this:
* You can get the transfer status using the [transfer status endpoint](/api-reference/transfers/fetch-a-bulk-transfer).
* If you have [`webhooks`](/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.
```json Sample Response (Webhook) theme={null}
{
"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
}
}
```
```json Sample Response (Polling) theme={null}
{
"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](/testing-helpers#testing-transfers) 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](https://flutterwave.com/ng/support/integrations/how-to-whitelist-ip-addresses-on-your-flutterwave-dashboard) 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](https://flutterwave.com/ng/support/payments/what-currencies-can-you-transfer-to) 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:
```json cURL theme={null}
{
"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
}
```
2. Fetch the beneficiary's [bank](/api-reference/banks/get-all-banks) code. Send this as the `account_bank` in your request.
3. Include the `debit_currency` parameter in your request to debit from a different currency balance.
4. Initiate your transfer using the required data and the [transfer endpoint](/api-reference/transfers/initiate-a-transfer).
```json cURL theme={null}
{
"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"
}
```
You'll get a response like this:
```json 200 OK theme={null}
{
"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."
}
}
```
5. Verify your transfer status, there are many ways to do this:
* You can get the transfer status using the [transfer status endpoint](/api-reference/transfers/fetch-a-transfer).
* If you have [webhooks](/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.
```json Sample Response (Webhook) theme={null}
{
"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:
```json Sample Response (Polling) theme={null}
{
"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](/testing#testing-transfers) documentation for information on how to test your transfers.
## Examples
Here are some examples to help you with implementation.
### Transfer to NGN Accounts
```json NGN_SAMPLE theme={null}
{
"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).
```json USD_INTL_SAMPLE theme={null}
{
"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"
}
]
}
```
```json USD_DOM_FCMB_SAMPLE theme={null}
{
"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"
}
]
}
```
```json USD_DOM_FIDELITY_BANK_SAMPLE theme={null}
{
"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"
}
]
}
```
```json USD_DOM_PROVIDUS_BANK_SAMPLE theme={null}
{
"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"
}
]
}
```
```json USD_DOM_UNION_BANKS_SAMPLE theme={null}
{
"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"
}
]
}
```
```json USD_DOM_OTHER_BANKS_SAMPLE theme={null}
{
"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
```json EUR_BANK_SAMPLE theme={null}
{
"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"
}
]
}
```
```json GBP_BANK_SAMPLE theme={null}
{
"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
```json GHS_BANK_SAMPLE theme={null}
{
"account_bank": "GH280100",
"account_number": "0031625807099",
"amount": 500,
"narration": "Test GHS bank transfers",
"currency": "GHS",
"destination_branch_code": "GH280103",
"beneficiary_name": "Kwame Adew"
}
```
```json KES_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json MWK_BANK_SAMPLE theme={null}
{
"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"
}
```
```json SLL_BANK_SAMPLE theme={null}
{
"account_bank": "SL009000",
"account_number": "386745674657",
"beneficiary_name": "NWABALI S.",
"currency": "SLL",
"debit_currency": "USD",
"amount": 1000,
"destination_branch_code": "SL009003"
}
```
```json TZS_BANK_SAMPLE theme={null}
{
"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"
}
]
}
```
```json UGX_BANK_SAMPLE theme={null}
{
"account_bank": "GH280100",
"account_number": "0031625807099",
"amount": 500,
"narration": "SAMPLE UGX TRANSFER",
"currency": "UGX",
"destination_branch_code": "GH280103",
"beneficiary_name": "NWABALI S."
}
```
```json XAF_BANK_SAMPLE theme={null}
{
"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"
}
```
```json XOF_BANK_SAMPLE theme={null}
{
"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"
}
```
```json ZAR_BANK_SAMPLE theme={null}
{
"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:
```json 200_OK_NGN_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_USD_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_USD_DOM_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_EUR_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_GBP_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_ZAR_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_GHS_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_SLL_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_MWK_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 200_OK_XAF_BANK_SAMPLE theme={null}
{
"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"
}
}
```
```json 400 Bad Request theme={null}
{}
```
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](/api-reference/transfers/fetch-a-transfer) to find out when the transfer is completed. See Transfers: [Overview](/fund-transfer/introduction) for details.