Create a transfer

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

This will show you how to initiate a transfer

time	status	user agent
Retrieving recent requests…

Loading…

Body Params

account_bank

string

required

Defaults to 044

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

account_number

string

required

Defaults to 0690000040

This is the recipient account number.

amount

int32

required

Defaults to 5500

This is the amount to transfer to the recipient.

currency

string

required

Defaults to NGN

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

debit_subaccount

string

Defaults to PSA******07974

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.

beneficiary

int32

Defaults to 3768

The beneficiary's id. This allows you to make a transfer to an existing beneficiary.

beneficiary_name

string

Defaults to Yemi Desola

The full name of a transfer beneficiary.

reference

string

Defaults to newFLWXTransfer123

This is a merchant's unique reference for the transfer, it can be used to query for the status of the transfer.

debit_currency

string

Defaults to USD

Pass this to set a different currency balance as the source of transfer funds. if unspecified, your default balance is debited for the transfer.

destination_branch_code

string

Defaults to GH280103

A code used to identify different bank branches. This is required for Bank transfers to Benin, Cameroon, Chad, Côte d’Ivoire, DR Congo, Gabon, Ghana, Malawi, Rwanda, Senegal, Sierra Leone, Tanzania, and Uganda.

callback_url

string

Defaults to https://webhook.site/5f9a659a-11a2-4925-89cf-8a59ea6a019a

The URL for transfer response callbacks.

narration

string

Defaults to Payment for goods purchased

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

meta

object

Add custom payment details to your transfer.

Headers

Authorization

string

required

Defaults to Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X

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

Responses

Language


xxxxxxxxxx
21
1
curl --request POST \
2
     --url https://api.flutterwave.com/v3/transfers \
3
     --header 'Authorization: Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X' \
4
     --header 'Content-Type: application/json' \
5
     --header 'accept: application/json' \
6
     --data '
7
{
8
  "account_bank": "044",
9
  "account_number": "0690000040",
10
  "amount": 5500,
11
  "currency": "NGN",
12
  "debit_subaccount": "PSA******07974",
13
  "beneficiary": 3768,
14
  "beneficiary_name": "Yemi Desola",
15
  "reference": "newFLWXTransfer123",
16
  "debit_currency": "USD",
17
  "destination_branch_code": "GH280103",
18
  "callback_url": "https://webhook.site/5f9a659a-11a2-4925-89cf-8a59ea6a019a",
19
  "narration": "Payment for goods purchased"
20
}
21
'


xxxxxxxxxx
23
}
1
{
2
  "status": "success",
3
  "message": "Transfer Queued Successfully",
4
  "data": {
5
    "id": 26251,
6
    "account_number": "1234567840",
7
    "bank_code": "044",
8
    "full_name": "Flutterwave Developers",
9
    "created_at": "2020-01-20T16:09:34.000Z",
10
    "currency": "NGN",
11
    "debit_currency": "NGN",
12
    "amount": 5500,
13
    "fee": 45,
14
    "status": "NEW",
15
    "reference": "akhlm-pstmnpyt-rfxx007_PMCKDU_1",
16
    "meta": null,
17
    "narration": "Akhlm Pstmn Trnsfr xx007",
18
    "complete_message": "",
19
    "requires_approval": 0,
20
    "is_approved": 1,
21
    "bank_name": "ACCESS BANK NIGERIA"
22
  }

200200

400400