Create a transfer

Creates a direct transfer using only the recipient and sender IDs. Before calling this endpoint, make sure you have already created both the recipient and the sender via their respective endpoints and obtained their IDs.

POST /transfers

Initiate a Transfer

cURL

curl --request POST \
  --url https://api.flutterwave.com/v3/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_bank": "044",
  "account_number": "0690000040",
  "amount": 500,
  "narration": "Akhlm Pstmn Trnsfr xx007",
  "currency": "NGN",
  "reference": "akhlm-pstmnpyt-rfxx078_PMCKDU_1",
  "callback_url": "https://www.flutterwave.com/ng/",
  "debit_currency": "NGN"
}
'

200

{
  "status": "success",
  "message": "Transfer Queued Successfully",
  "data": {
    "id": 621922,
    "account_number": "0690000040",
    "bank_code": "044",
    "full_name": "Alexis Sanchez",
    "created_at": "2024-03-18T08:58:30.000Z",
    "currency": "NGN",
    "debit_currency": "NGN",
    "amount": 500,
    "fee": 10.75,
    "status": "NEW",
    "reference": "akhlm-pstmnpyt-rfxx078_PMCKDU_1",
    "meta": null,
    "narration": "Akhlm Pstmn Trnsfr xx007",
    "complete_message": "",
    "requires_approval": 0,
    "is_approved": 1,
    "bank_name": "ACCESS BANK NIGERIA"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

account_bank · string · required

account_number · string · required

amount · integer<int32> · required

narration · string · required

currency · string · required

reference · string · required

callback_url · string · required

debit_currency · string · required

Response

200

application/json; charset=utf-8

OK

status · string · required

message · string · required

data · Data30 · object · required

Show child attributes

Example:

{
  "id": 621922,
  "account_number": "0690000040",
  "bank_code": "044",
  "full_name": "Alexis Sanchez",
  "created_at": "2024-03-18T08:58:30.000Z",
  "currency": "NGN",
  "debit_currency": "NGN",
  "amount": 500,
  "fee": 10.75,
  "status": "NEW",
  "reference": "akhlm-pstmnpyt-rfxx078_PMCKDU_1",
  "meta": null,
  "narration": "Akhlm Pstmn Trnsfr xx007",
  "complete_message": "",
  "requires_approval": 0,
  "is_approved": 1,
  "bank_name": "ACCESS BANK NIGERIA"
}