Revolut Payments API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Payments. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
3 operations
across 2 paths,
and defines 54 schemas.
It is described by OpenAPI 3.0.1, at version 1.0.
Requests are made against 2 base URLs: https://b2b.revolut.com/api/1.0, https://sandbox-b2b.revolut.com/api/1.0.
The identity and technical contract details declared by the specification.
Payment-Retrieval
object
9 properties
3 required
Card
object
Object containing details of the card used for the payment.
16 properties
1 required
Sepa-Direct-Debit-Debtor-Name
string
The full name of the debtor as provided in the mandate.
Sepa-Direct-Debit-Debtor-Iban-Last-Four
string
The last four digits of the debtor's IBAN.
Revolut-Pay-Account
object
3 properties
1 required
Sepa-Direct-Debit
object
Object containing details of a SEPA Direct Debit payment. :::info For more information, see: [SEPA Direct Debit server-to-server integration](https://developer…
5 properties
1 required
Payer
object
The person who made the payment. This object is present when an email or phone number is provided during the payment flow. Capturing payer details lets you ide…
2 properties
Network-Transaction-Id
string
The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction. It can be used to trace t…
Currency
string
[ISO 4217](https://en.wikipedia.org/wiki/ISO4217) currency code in upper case. :::info For more information about the supported currencies, see: [Help Center](…
Card-Checks-v2
object
The details of the check for card payment. Only for orders with successful payments.
5 properties
Payment-Updated
string
The date and time the payment was last updated.
Error-v2
object
3 properties
Decline-Reason-v2
string
The reason for a failed or declined payment. A failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://…
Fingerprint
string
A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. Fingerprint gen…
Authentication-Challenge
object
Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution,…
Environment
object
Environment object, indicating in which environment the payment was made. :::warning Only required if initiator: customer. ::: :::note Only browser is availabl…
Three-Ds-Fingerprint
object
Information about the 3DS fingerprint challenge.
3 properties
3 required
Card-For-Payment-Details
object
4 properties
1 required
Payment-Method-Type
string
The type of payment method used to pay for the order. Available values: | Payment method type | Description | | --------------------- | ----------- | | applepa…
Payment-Risk-Level
string
The risk level of the card. If the risk level is high, the payment might be declined.
RPay-Card
object
5 properties
2 required
Payment-Settled-Currency
string
The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO4217) currency code in upper case. :::info For more information about the supp…
Fees
array
The details of the order fee.
Authentication-Challenge-v2
object
Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution,…
Email
string
The email address of the customer.
Payment-Method-v2
object
The details of the payment method used to make the payment.
Apple-Pay
object
Object containing details of a card used via Apple Pay.
16 properties
1 required
Three-Ds
object
Information about the 3DS challenge.
2 properties
2 required
Address-v2
object
Object containing address details.
6 properties
2 required
Revolut-Pay-Card
object
Object containing details of a card used via Revolut Pay.
16 properties
1 required
Payment-Authorised-Amount
integer
The currently authorised amount for this payment (in minor units). For pre-authorised payments with incremental authorization: - Initially equals the amount fi…
Payment-Token
string
Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. The token is only valid for a li…
Payment-Created
string
The date and time the payment was created.
Saved-Payment-Method
object
1 property
1 required
Authorisation-Code
string
The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway. It…
Payment-State-v2
string
The status of the payment.
Payment-Id
string
The ID of the payment.
Order-Id
string
Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.
Sepa-Direct-Debit-Mandate-Reference
string
The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.
Browser-Environment
object
Browser environment
8 properties
6 required
Arn
string
Acquirer Reference Number (ARN) of the payment. :::note Only returned for refund payments made by a card. :::
RPay-Account
object
3 properties
2 required
Capture-Deadline
string
The date and time by which the payment must be captured. After this deadline, the authorised funds may be automatically released by the card issuer.
Payment-Retrieval-v3
object
Represents a payment for an order. For pre-authorised payments, the authorisedamount field tracks the currently authorised amount, which may differ from amount…
19 properties
5 required
Terminal-Hardware-Id
string
The hardware identifier of the Revolut Terminal device used to process the payment. :::note Only present for card-present transactions processed via Revolut Te…
Three-Ds-Fingerprint-v2
object
Information about the 3DS fingerprint challenge.
2 properties
2 required
Payment-Settled-Amount
integer
The amount of the settled payment (minor currency unit). For example, 7034 stands for €70.34.
Authentication-Challenge-Type
string
Type of the authentication challenge the payment triggers.
Google-Pay
object
Object containing details of a card used via Google Pay.
16 properties
1 required
Phone
string
The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).
Payment-Amount
integer
The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state. | Payment type | State | Amount value | |------…
Bank-Message
string
The reason for a failed or declined payment, sent by the financial institution processing the payment.
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Revolut publishes across the network.
