Open Banking API
Create an international payment
api
post
/international-payments

Create an international payment

Create an international payment.

note

As is defined in the Open Banking Specifications, the /Data/Initiation and the /Data/Risk sections of the request must be an exact match for the related consent passed in ConsentId.

See also Tutorials: Initiate your first payment.

Authorization

Each Open Banking API must contain an authorization header in the following format to make a call: Bearer <yourAccessToken>.

Before you start, ensure that you've got an access token with the correct scope using the /token endpoint. You need to get the authorization code first and exchange it for an access token.

danger

Never share your access_token with anyone, as it can be used to access the banking data that you have access to and initiate transactions.

For more information, see Tutorial: Get account and transaction information and Tutorial: Initiate your first payment as examples.

x-jws-signature

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 be obtained using the full content of the payload.

Request

Default

Header Parameters
Header Parameters

The unique ID of the ASPSP that the request is issued to. The ID of Revolut is 001580000103UAvAAM.

Possible values: Value must match regular expression ^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$

The date and time when the PSU last logged in with the TPP.

All dates in the HTTP headers are represented as RFC 7231 Full Dates. For example: Sun, 10 Sep 2017 19:43:31 UTC.

The IP address of the PSU if the PSU is logged in with the TPP.

An RFC4122 UUID used as a correlation ID.

The access token that you've generated. For more information, see Generate an access token.

Possible values: <= 40 characters, Value must match regular expression ^(?!\s)(.*)(\S)$

Each request is processed only once per x-idempotency-key. The idempotency key is valid for 24 hours.

A detached JWS signature of the body of the payload.

The user agent that the PSU is using.

Request body
Body object

Possible values: non-empty and <= 128 characters

The unique ID that the ASPSP assigns to identify the consent resource.

The initiation payload that the initiating party sends to the ASPSP, which is used to request movement of funds from the debtor account to the creditor for a single international payment.

Possible values: non-empty and <= 35 characters

The unique ID that an instructing party assigns for an instructed party to unambiguously identify the instruction.

This ID is used between the instructing party and the instructed party to refer to the individual instruction. It can be included in the messages related to the instruction.

Possible values: non-empty and <= 35 characters

The unique and immutable ID that the initiating party assigns to unambiguously identify the transaction.

This ID is used for reconciliation or to link tasks related to the transaction. It can be included in the messages related to the transaction.

note

Faster Payments Scheme can access only 31 characters for the EndToEndIdentification field.

Possible values: [BorneByDebtor, FollowingServiceLevel]

The party or parties bear the charges associated with the processing of the payment transaction.

Possible values: Value must match regular expression ^[A-Z]{3,3}$

The currency of the money to be transferred, which is different from the currency of the debtor's account.

The amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency that the initiating party instructs.

This amount has to be transported unchanged through the transaction chain.

Possible values: Value must match regular expression ^\d{1,13}\.\d{1,5}$

The amount of money.

Possible values: Value must match regular expression ^[A-Z]{3,3}$

The details on the currency exchange rate and contract.

Possible values: Value must match regular expression ^[A-Z]{3,3}$

The currency that the exchange rate is expressed in. For example, for 1 GBP = xxx EUR, the UnitCurrency value is GBP.

The exchange rate used to convert an amount from one currency into another. This reflects the price that one currency was bought at with another currency.

Possible values: [Actual, Agreed, Indicative]

The type used to complete the currency exchange.

Possible values: non-empty and <= 256 characters

The unique reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.

The details to identify the account.

Possible values: [UK.OBIE.IBAN, UK.OBIE.SortCodeAccountNumber, US.RoutingNumberAccountNumber, US.BranchCodeAccountNumber]

The name of the identification scheme.

Possible values: non-empty and <= 256 characters

The account ID that an institution assigns to identify the account, which is known by the account owner.

Possible values: non-empty and <= 70 characters

The account name that the account servicing institution assigns.

The account name is the name or names of the account owner(s) represented at an account level.

The account name is not the product name or the nickname of the account.

Possible values: non-empty and <= 34 characters

The secondary account ID that the account servicing institution assigns.

Building societies can use this ID to identify accounts with a roll number in addition to a sort code and account number combination.

The party that an amount of money is due to.

Possible values: non-empty and <= 140 characters

The name of a known party used to identify the party.

The postal address of the creditor, as defined by postal services.

Possible values: non-empty and <= 70 characters

The name of the department.

Possible values: non-empty and <= 70 characters

The name of the sub-department.

Possible values: non-empty and <= 70 characters

The name of the street.

Possible values: non-empty and <= 16 characters

The number of the building.

Possible values: non-empty and <= 16 characters

The post code of the address.

Possible values: non-empty and <= 35 characters

The name of the town.

Possible values: non-empty and <= 35 characters

The subdivision of the country, such as state, region, or county.

Possible values: Value must match regular expression ^[A-Z]{2,2}$

The name of the country.

Possible values: <= 7

The information that locates and identifies the address of the creditor, presented in free format text.

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 on the account.
  • Providing information about the account.

This is the servicer of the beneficiary account.

The name of the identification scheme, which is published in an external list.

Possible values: non-empty and <= 35 characters

The unique ID of the servicing institution.

Possible values: non-empty and <= 140 characters

The name of a known agent used to identify the agent.

The postal address of the creditor, as defined by postal services.

Possible values: non-empty and <= 70 characters

The name of the department.

Possible values: non-empty and <= 70 characters

The name of the sub-department.

Possible values: non-empty and <= 70 characters

The name of the street.

Possible values: non-empty and <= 16 characters

The number of the building.

Possible values: non-empty and <= 16 characters

The post code of the address.

Possible values: non-empty and <= 35 characters

The name of the town.

Possible values: non-empty and <= 35 characters

The subdivision of the country, such as state, region, or county.

Possible values: Value must match regular expression ^[A-Z]{2,2}$

The name of the country.

Possible values: <= 7

The information that locates and identifies the address of the creditor, presented in free format text.

The details to identify the account.

Possible values: [UK.OBIE.IBAN, UK.OBIE.SortCodeAccountNumber, US.RoutingNumberAccountNumber, US.BranchCodeAccountNumber]

The name of the identification scheme.

Possible values: non-empty and <= 256 characters

The account ID that the institution assigns to identify an account, which is known by the account owner.

Possible values: non-empty and <= 70 characters

The account name that the account servicing institution assigns.

The account name is the name or names of the account owner(s) represented at an account level.

The account name is not the product name or the nickname of the account.

note

ASPSPs might optionally validate this name to confirm the payee.

Possible values: non-empty and <= 34 characters

The secondary account ID that the account servicing institution assigns.

Building societies can use this ID to identify accounts with a roll number in addition to a sort code and account number combination.

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

Possible values: non-empty and <= 140 characters

The information used for matching/reconciliation of an entry with the items that the payment is intended to settle, such as commercial invoices in an accounts' receivable system, in an unstructured form.

Possible values: non-empty and <= 35 characters

The unique reference that the creditor assigns to unambiguously identify the payment transaction.

If available, the initiating party should provide this reference in the structured remittance information to enable reconciliation by the creditor upon receipt of the amount of money.

If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.

note

Faster Payments Scheme can accept only 18 characters for the Reference field.

caution

Only one reference should be provided, if both Reference and Unstructured parameters are provided, then the Unstructured parameter will be ignored.

The Risk section contains the risk indicators that the initiating party sends to the ASPSP, which can be used to specify additional details for risk scoring for account information.

Possible values: [BillPayment, EcommerceGoods, EcommerceServices, Other, PartyToParty]

The payment context.

The merchant category code.

The merchant customer identification.

The information that locates and identifies the delivery address, as defined by postal services or in free format text.

Possible values: <= 2

The information that locates and identifies the delivery address, as defined by postal services, that is presented in free format text.

Possible values: non-empty and <= 70 characters

The name of the street.

Possible values: non-empty and <= 16 characters

The number of the building.

Possible values: non-empty and <= 16 characters

The post code of the delivery address.

Possible values: non-empty and <= 35 characters

The name of the town.

Possible values: <= 2

The subdivision of the country, for example, state, region or county.

Possible values: Value must match regular expression ^[A-Z]{2,2}$

The name of the country.

Response

International Payments Created

HTTP Headers
HTTP Headers

Header containing a detached JWS signature of the body of the payload.

An RFC4122 UUID used as a correlation ID.

Response body
Body object

Possible values: non-empty and <= 40 characters

The unique ID that the ASPSP assigns to identify the international payment resource.

Possible values: non-empty and <= 128 characters

The unique ID that the ASPSP assigns to identify the consent resource.

The date and time when the message was created.

All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone.

For example: 2017-04-05T10:43:07+00:00.

Possible values: [AcceptedSettlementCompleted, AcceptedSettlementInProcess, Pending, Rejected]

The status of the payment information group.

The date and time when the resource status was updated.

All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone.

For example: 2017-04-05T10:43:07+00:00.

Further detailed information on the exchange rate that is used in the payment transaction.

Possible values: Value must match regular expression ^[A-Z]{3,3}$

The currency that the exchange rate is expressed in. For example, for 1 GBP = xxx EUR, the UnitCurrency value is GBP.

Possible values: Value must match regular expression ^[0-9]+\.[0-9]+$

The exchange rate used to convert an amount from one currency into another. This reflects the price that one currency was bought at with another currency.

Possible values: [Actual, Agreed, Indicative]

The type used to complete the currency exchange.

Possible values: non-empty and <= 256 characters

The unique reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.

The date and time when the exchange rate agreement expires.

All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone.

For example: 2017-04-05T10:43:07+00:00.

The initiation payload that the initiating party sends to the ASPSP, which is used to request movement of funds from the debtor account to the creditor for a single international payment.

Possible values: non-empty and <= 35 characters

The unique ID that an instructing party assigns for an instructed party to unambiguously identify the instruction.

This ID is used between the instructing party and the instructed party to refer to the individual instruction. It can be included in the messages related to the instruction.

Possible values: non-empty and <= 35 characters

The unique and immutable ID that the initiating party assigns to unambiguously identify the transaction.

This ID is used for reconciliation or to link tasks related to the transaction. It can be included in the messages related to the transaction.

note

Faster Payments Scheme can access only 31 characters for the EndToEndIdentification field.

Possible values: [BorneByDebtor, FollowingServiceLevel]

The party or parties bear the charges associated with the processing of the payment transaction.

Possible values: Value must match regular expression ^[A-Z]{3,3}$

The currency of the money to be transferred, which is different from the currency of the debtor's account.

The amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency that the initiating party instructs.

This amount has to be transported unchanged through the transaction chain.

Possible values: Value must match regular expression ^\d{1,13}\.\d{1,5}$

The amount of money.

Possible values: Value must match regular expression ^[A-Z]{3,3}$

The details on the currency exchange rate and contract.

Possible values: Value must match regular expression ^[A-Z]{3,3}$

The currency that the exchange rate is expressed in. For example, for 1 GBP = xxx EUR, the UnitCurrency value is GBP.

The exchange rate used to convert an amount from one currency into another. This reflects the price that one currency was bought at with another currency.

Possible values: [Actual, Agreed, Indicative]

The type used to complete the currency exchange.

Possible values: non-empty and <= 256 characters

The unique reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.

The details to identify the account.

Possible values: [UK.OBIE.IBAN, UK.OBIE.SortCodeAccountNumber, US.RoutingNumberAccountNumber, US.BranchCodeAccountNumber]

The name of the identification scheme.

Possible values: non-empty and <= 256 characters

The account ID that an institution assigns to identify the account, which is known by the account owner.

Possible values: non-empty and <= 70 characters

The account name that the account servicing institution assigns.

The account name is the name or names of the account owner(s) represented at an account level.

The account name is not the product name or the nickname of the account.

Possible values: non-empty and <= 34 characters

The secondary account ID that the account servicing institution assigns.

Building societies can use this ID to identify accounts with a roll number in addition to a sort code and account number combination.

The party that an amount of money is due to.

Possible values: non-empty and <= 140 characters

The name of a known party used to identify the party.

The postal address of the creditor, as defined by postal services.

Possible values: non-empty and <= 70 characters

The name of the department.

Possible values: non-empty and <= 70 characters

The name of the sub-department.

Possible values: non-empty and <= 70 characters

The name of the street.

Possible values: non-empty and <= 16 characters

The number of the building.

Possible values: non-empty and <= 16 characters

The post code of the address.

Possible values: non-empty and <= 35 characters

The name of the town.

Possible values: non-empty and <= 35 characters

The subdivision of the country, such as state, region, or county.

Possible values: Value must match regular expression ^[A-Z]{2,2}$

The name of the country.

Possible values: <= 7

The information that locates and identifies the address of the creditor, presented in free format text.

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 on the account.
  • Providing information about the account.

This is the servicer of the beneficiary account.

The name of the identification scheme, which is published in an external list.

Possible values: non-empty and <= 35 characters

The unique ID of the servicing institution.

Possible values: non-empty and <= 140 characters

The name of a known agent used to identify the agent.

The postal address of the creditor, as defined by postal services.

Possible values: non-empty and <= 70 characters

The name of the department.

Possible values: non-empty and <= 70 characters

The name of the sub-department.

Possible values: non-empty and <= 70 characters

The name of the street.

Possible values: non-empty and <= 16 characters

The number of the building.

Possible values: non-empty and <= 16 characters

The post code of the address.

Possible values: non-empty and <= 35 characters

The name of the town.

Possible values: non-empty and <= 35 characters

The subdivision of the country, such as state, region, or county.

Possible values: Value must match regular expression ^[A-Z]{2,2}$

The name of the country.

Possible values: <= 7

The information that locates and identifies the address of the creditor, presented in free format text.

The details to identify the account.

Possible values: [UK.OBIE.IBAN, UK.OBIE.SortCodeAccountNumber, US.RoutingNumberAccountNumber, US.BranchCodeAccountNumber]

The name of the identification scheme.

Possible values: non-empty and <= 256 characters

The account ID that the institution assigns to identify an account, which is known by the account owner.

Possible values: non-empty and <= 70 characters

The account name that the account servicing institution assigns.

The account name is the name or names of the account owner(s) represented at an account level.

The account name is not the product name or the nickname of the account.

note

ASPSPs might optionally validate this name to confirm the payee.

Possible values: non-empty and <= 34 characters

The secondary account ID that the account servicing institution assigns.

Building societies can use this ID to identify accounts with a roll number in addition to a sort code and account number combination.

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

Possible values: non-empty and <= 140 characters

The information used for matching/reconciliation of an entry with the items that the payment is intended to settle, such as commercial invoices in an accounts' receivable system, in an unstructured form.

Possible values: non-empty and <= 35 characters

The unique reference that the creditor assigns to unambiguously identify the payment transaction.

If available, the initiating party should provide this reference in the structured remittance information to enable reconciliation by the creditor upon receipt of the amount of money.

If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.

note

Faster Payments Scheme can accept only 18 characters for the Reference field.

caution

Only one reference should be provided, if both Reference and Unstructured parameters are provided, then the Unstructured parameter will be ignored.

Links relevant to the payload.

The absolute URI to the resource.

The absolute URI to the next pagination resource.

The absolute URI to the previous pagination resource.

Meta data relevant to the payload.

Used for pagination. Indicates how many pages of results are available.

Was this page helpful?
Loading...