Create a bank transfer

Creates a transfer to an approved beneficiary. The amount must be a whole number and at least 1,000 in the beneficiary's currency.

A 201 response means the transfer was created for processing; it does not mean the recipient has received the funds. Some accounts require approval first and receive a 202 response instead. Use List or retrieve bank transfers to monitor the final status.

If your account requires transfer approvals, send a stable Idempotency-Key for each approval request. Reuse the same key only when retrying that unchanged approval request. This header does not provide general duplicate protection for transfers that execute without approval.

Body Params

Transfer to create.

uuid
required

Approved beneficiary ID.

integer
required
≥ 1000

Whole-number transfer amount in the beneficiary's currency.

string
Defaults to N/A

Transfer narration.

string

Optional customer reference for this transaction. It must be unique for your account.

Headers
string
length ≤ 200

Stable key used to prevent duplicate approval requests when transfer approval is required.

Responses

409

The approval request conflicts with an active request, or the idempotency key was reused with different details.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json