International payment

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.

post/international-payments

Request

  • Base URL
    https://oba-auth.revolut.com
  • Auth
    API key in header Authorization and API key in header x-jws-signature

Headers

x-fapi-financial-idstring required

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

x-fapi-customer-last-logged-timestring

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: <nobr>Sun, 10 Sep 2017 19:43:31 UTC</nobr>.

x-fapi-customer-ip-addressstring

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

x-fapi-interaction-idstring

An RFC4122 UUID used as a correlation ID.

Authorizationstring required

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

x-idempotency-keystring required

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

x-jws-signaturestring required

A detached JWS signature of the body of the payload.

x-customer-user-agentstring

The user agent that the PSU is using.

Request body

Example request

{
  "Data": {
    "Initiation": {
      "CreditorAgent": {
        "SchemeName": [
          "UK.OBIE.IBAN"
        ]
      },
      "CreditorAccount": {
        "SchemeName": "UK.OBIE.IBAN"
      },
      "DebtorAccount": {
        "SchemeName": "UK.OBIE.IBAN"
      }
    }
  }
}

Response

International Payments Created

Example response

{
  "Data": {
    "Initiation": {
      "CreditorAgent": {
        "SchemeName": [
          "UK.OBIE.IBAN"
        ]
      },
      "CreditorAccount": {
        "SchemeName": "UK.OBIE.IBAN"
      },
      "DebtorAccount": {
        "SchemeName": "UK.OBIE.IBAN"
      }
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.