RErevolut
Transactions

Retrieve a transaction

Retrieve the details of a specific transaction by the transaction's ID. The details can include, for example, cardholder details for card payments.

:::tip [Retrieve by request_id instead] Alternatively, you can retrieve a transaction by the request ID that was provided for this transaction at the time of its creation, for example, when you created a payment.

To do that, use the GET /transactions endpoint to retrieve a list of transactions and provide the request_id and appropriate from/to values as filters. :::

For more details, see the guides: Retrieve transactions.

get/transaction/{id}

Request

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

Path parameters

idstring required

The unique ID of the transaction.

:::warning [Request ID deprecation] If id_type=request_id is provided, set this field to the request ID from payment creation instead of the transaction ID.

This behavior is deprecated and will be removed in a future release. Use GET /transactions to retrieve transactions by request ID. :::

Query parameters

id_type'request_id'

The type of ID to retrieve the transaction by.

:::warning [Deprecated] This field is now deprecated and will be removed in a future release.

To retrieve transactions by their unique transaction ID, use this endpoint. To retrieve transactions by request ID, use the GET /transactions endpoint instead. :::

Response

The information about a specific transaction

idstring required

The ID of the transaction.

type'atm' | 'card_payment' | 'card_refund' | 'card_chargeback' | 'card_credit' | 'charge' | 'charge_refund' | 'exchange' | 'transfer' | 'loan' | 'fee' | 'refund' | 'topup' | 'topup_return' | 'tax' | 'tax_refund' | 'rev_payment' required

Indicates the transaction type.

request_idstring

The request ID that you provided previously.

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.
reason_codestring

The reason code when the transaction state is declined or failed.

created_atstring date-time required

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

updated_atstring date-time required

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

completed_atstring date-time

The date and time the transaction was completed in ISO 8601 format. This is required when the transaction state is completed.

scheduled_forstring date

The scheduled date of the payment, if applicable. Provided in ISO 8601 format.

related_transaction_idstring uuid

The ID of the original transaction to which this transaction is related. Returned, for example, when this transaction is a refund of the related transaction, or for transactions related to cashback.

referencestring

The payment reference.

auth_codestring

The authorization code from the card network. Returned for card transactions when the authorization code is available.

Example response

{
  "merchant": {
    "name": "Acme Corp.",
    "full_name": "ACME*1234MN1HA2"
  },
  "card": {
    "references": [
      {
        "name": "PNR",
        "value": "RT12345"
      }
    ]
  }
}

Changes

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