RErevolut
Transfers

Move money between your accounts

Move money between the Revolut accounts of the business in the same currency.

The resulting transaction has the type transfer.

For more information, see the guides: Send money.

post/transfer

Request

  • Base URL
    https://b2b.revolut.com/api/1.0
  • Auth
    HTTP bearer

Request body

request_idstring required

The ID of the request, provided by you. It helps you identify the transaction in your system.

:::warning To ensure that a transfer is not processed multiple times if there are network or system errors, the same request_id should be used for requests related to the same transfer. :::

source_account_idstring uuid required

The ID of the source account that you transfer the funds from.

target_account_idstring uuid required

The ID of the target account that you transfer the funds to.

amountnumber double required

The amount of the funds to be transferred.

currencystring required

ISO 4217 currency code in upper case.

referencestring

The reference for the funds transfer.

Response

The information about the transfer created

idstring required

The ID of the transaction created.

state'created' | 'pending' | 'completed' | 'declined' | 'failed' | 'reverted' required

Indicates the transaction state. Possible values:

ValueDescription
createdThe transaction has been created and is either processed asynchronously or scheduled for a later time.
pendingThe transaction is pending until it's being processed. If the transfer is made between Revolut accounts, this state is skipped and the transaction is executed instantly.
completedThe transaction was successful.
declinedThe transaction was unsuccessful. This can happen for a variety of reasons, for example, insufficient account balance, wrong receiver information, etc.
failedThe transaction was unsuccessful. This can happen for a variety of reasons, for example, invalid API calls, blocked payments, etc.
revertedThe transaction was reverted. This can happen for a variety of reasons, for example, the receiver being inaccessible.
created_atstring date-time required

The date and time the transaction was created in ISO 8601 format.

completed_atstring date-time

The date and time the transaction was completed in ISO 8601 format.

Changes

No recorded changes to this operation across all 1 revision of this API.