*International standing orders*, 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 payments](https://developer.revolut.com/docs/api/open-banking#tag-international-payment) and [International scheduled payments](https://developer.revolut.com/docs/api/open-banking#tag-international-scheduled-payment).:::
Revolut International standing order 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 standing order. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
4 operations
across 4 paths,
and defines 32 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.
4 operations4 paths32 schemas2 GET2 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://b2b.revolut.com/api/1.0
Authentication
HTTP Bearer
Resource Areas
1
Authentication & Security 1
Revolut International standing order API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (AccessToken).
AccessToken — Each Business API request must contain an authorization header in the following format to make a call: Bearer . The access token will be obtained the first tim…
Paths & Operations 4
Across 4 paths, the API surfaces 4 operations — 2 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.
International standing order 4
International standing orders, which you can use for international SWIFT payments in all currencies that Revolut supports. As a regulated third party provider, you can use the pro…
The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are OBInternationalStandingOrderBase (11 properties), OBPostalAddress6 (9 properties), OBWriteDataInternationalStandingOrderResponse2 (7 properties), OBWriteDataInternationalStandingOrderConsentResponse2 (6 properties). Each schema is shown below with its type and property counts.
OBExternalConsentStatus1Code
string
The status of the consent.
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
OBWriteInternationalStandingOrder2
object
2 properties2 required
Meta
object
Meta data relevant to the payload.
1 property
OBExternalAccountIdentification4Code
string
The name of the identification scheme.
OBExternalMerchantCategoryCode
string
The merchant category code.
OBChargeBearerType1Code
string
The party or parties bear the charges associated with the processing of the payment transaction.
OBPartyIdentification43
object
The party that an amount of money is due to.
2 properties
OBWriteInternationalStandingOrderConsent2
object
2 properties2 required
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
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).
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
OBWriteInternationalStandingOrderConsentResponse2
object
4 properties4 required
OBExternalFinancialInstitutionIdentification4Code
array
The name of the identification scheme, which is published in an external list.
OBExternalPermissions2Code
string
The Open Banking service request type.
OBExternalStatus1Code
string
The status of the payment.
OBInternationalStandingOrderBase
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…
11 properties
OBWriteDataInternationalStandingOrderConsent2
object
2 properties2 required
OBErrorResponse1
object
The detailed information about the error to help troubleshooting.
4 properties3 required
OBWriteDataInternationalStandingOrderResponse2
object
7 properties6 required
Links
object
Links relevant to the payload.
3 properties1 required
OBWriteInternationalStandingOrderResponse2
object
3 properties3 required
OBInternationalStandingOrder2
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…
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…
OBWriteDataInternationalStandingOrder2
object
2 properties2 required
OBError1
object
2 properties2 required
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
OBPostalAddress6
object
The postal address of the creditor, as defined by postal services.
9 properties
OBCashAccountCreditor3
object
The details to identify the account.
4 properties3 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
