*International payments*, which you can use for international SWIFT payments in all currencies that Revolut supports.As a regulated third party provider, you can use the provided endpoints to initiate a payment in the following high-level workflow:- Create a consent.- Get the consent.- Create a payment.- Get the payment.Before you begin, ensure that you've registered your application with the `payments` scope.For more information, see [Tutorials: Initiate your first payment](https://developer.revolut.com/docs/guides/build-banking-apps/tutorials/initiate-your-first-payment).:::tipSee also [International scheduled payments](https://developer.revolut.com/docs/api/open-banking#tag-international-scheduled-payment) and [International standing orders](https://developer.revolut.com/docs/api/open-banking#tag-international-standing-order).:::
Revolut International payment API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include International payment. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
5 operations
across 5 paths,
and defines 38 schemas.
It is described by OpenAPI 3.2.0, at version v3.1.0.
Requests are made against 2 base URLs: https://oba-auth.revolut.com, https://sandbox-oba-auth.revolut.com.
5 operations5 paths38 schemas3 GET2 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.2.0
API Version
v3.1.0
Base URL
https://b2b.revolut.com/api/1.0
Authentication
API Key, API Key
Resource Areas
1
Authentication & Security 2
Revolut International payment API declares
2 security schemes
for authenticating requests.
An API key is passed in the header as Authorization (AccessToken).
An API key is passed in the header as x-jws-signature (JWS).
AccessToken — Each Open Banking API must contain an authorization header in the following format to make a call: Bearer . Before you start, ensure that you've got an access…
JWS — Open Banking API Payment requests additionally require a JSON Web Signature (JWS) which needs to be added to the header of the request. The JWS signature must…
Paths & Operations 5
Across 5 paths, the API surfaces 5 operations — 3 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.
International payment 5
International payments, which you can use for international SWIFT payments in all currencies that Revolut supports. As a regulated third party provider, you can use the provided e…
The contract defines 38 schemas that model the data the API accepts and returns. The most detailed are OBInternationalBase (10 properties), OBPostalAddress6 (9 properties), OBWriteDataInternationalResponse2 (7 properties), OBWriteDataInternationalConsentResponse2 (6 properties). Each schema is shown below with its type and property counts.
OBInternationalBase
object
The initiation payload that the initiating party sends to the [ASPSP](https://developer.revolut.com/docs/guides/build-banking-apps/glossary), which is used to…
10 properties
OBCashAccountDebtorResponse
object
The details to identify the account which was used to approve the payment consent. This information can be used as a refund address.
4 properties2 required
OBWriteInternationalResponse2
object
3 properties3 required
OBTransactionIndividualStatus1Code
string
The status of the payment information group.
OBExternalPaymentContext1Code
string
The payment context.
OBRisk1
object
The Risk section contains the risk indicators that the initiating party sends to the [ASPSP](https://developer.revolut.com/docs/guides/build-banking-apps/gloss…
4 properties
OBWriteInternational2
object
2 properties2 required
OBActiveCurrencyAndAmount_SimpleType
string
The amount of money where the unit of currency is explicit and compliant with [ISO 4217](https://en.wikipedia.org/wiki/ISO4217).
OBError1
object
2 properties2 required
OBWriteDataFundsConfirmationResponse1
object
1 property
OBBranchAndFinancialInstitutionIdentification6
object
The party that manages the account on behalf of the account owner by: - Managing the registration and booking of entries on the account. - Calculating balances…
4 properties
OBChargeBearerType1Code
string
The party or parties bear the charges associated with the processing of the payment transaction.
OBInternational2
object
The initiation payload that the initiating party sends to the [ASPSP](https://developer.revolut.com/docs/guides/build-banking-apps/glossary), which is used to…
OBExternalConsentStatus1Code
string
The status of the consent.
OBWriteDataInternationalConsentResponse2
object
6 properties5 required
OBWriteDataInternationalConsent2
object
1 property1 required
OBFundsAvailableResult1
object
The results of the funds availability check.
2 properties2 required
OBExchangeRate2
object
Further detailed information on the exchange rate that is used in the payment transaction.
5 properties3 required
OBExternalAccountIdentification4Code
string
The name of the identification scheme.
OBWriteInternationalConsent2
object
2 properties2 required
OBExternalMerchantCategoryCode
string
The merchant category code.
OBCashAccountDebtor4
object
The details to identify the account from which the payment consent can be approved. If provided in the consent, the [PSU](https://developer.revolut.com/docs/gu…
4 properties2 required
Meta
object
Meta data relevant to the payload.
1 property
OBExchangeRate1
object
The details on the currency exchange rate and contract.
4 properties2 required
OBWriteFundsConfirmationResponse1
object
3 properties3 required
OBErrorResponse1
object
The detailed information about the error to help troubleshooting.
4 properties3 required
OBExternalFinancialInstitutionIdentification4Code
array
The name of the identification scheme, which is published in an external list.
OBPostalAddress6
object
The postal address of the creditor, as defined by postal services.
9 properties
OBPartyIdentification43
object
The party that an amount of money is due to.
2 properties
OBRemittanceInformation1
object
The information used for matching an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable syste…
2 properties
OBCashAccountCreditor3
object
The details to identify the account.
4 properties3 required
OBExchangeRateType2Code
string
The type used to complete the currency exchange.
OBWriteInternationalConsentResponse2
object
4 properties4 required
OBWriteDataInternational2
object
2 properties2 required
OBExternalMerchantCustomerIdentification
string
The merchant customer identification.
OBInternationalInitiationResponse
object
The initiation payload that the initiating party sends to the [ASPSP](https://developer.revolut.com/docs/guides/build-banking-apps/glossary), which is used to…
Links
object
Links relevant to the payload.
3 properties1 required
OBWriteDataInternationalResponse2
object
7 properties6 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Revolut International payment API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
