Pay for an order

Initiate a payment to pay full amount for an order using a customer's saved payment method.

note

The /orders/{order_id}/confirm endpoint has been deprecated. It will be only supported for already existing implementations.

caution

This endpoint is part of a new API, pay attention to the different endpoint URL.

For more information about how to save and charge payment methods, see: Charge a customer's saved payment method.

The following table shows who can initiate payments on saved payment methods (initiator parameter), depending on if the payment method was saved for the customer or the merchant (savedPaymentMethodFor parameter):

	savePaymentMethodFor: customer	savePaymentMethodFor: merchant
initiator: customer	Allowed	Allowed
initiator: merchant	Not allowed	Allowed

note

Using this endpoint, only merchant initiated payments are supported with Revolut Pay.

For more information about customers' payment methods, see the Retrieve all payment methods of a customer operation.

Request​

Path Parameters

Path Parameters

The ID of the Order object.

Header Parameters

Header Parameters

Example: "Bearer sk_1234567890ABCdefGHIjklMNOpqrSTUvwxYZ_1234567890-Ab_cdeFGHijkLMNopq"

This parameter accepts the Merchant API Secret key to authorise requests coming from the merchant's backend.

It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a Bearer token.

info

For more information, see: Authentication

Request body

Body object

Object containing information about the saved payment method used to pay for the order.

Possible values: [card, revolut_pay]
Example: "card"

Type of saved payment method.

Saved payment method ID.

Possible values: [customer, merchant]
Example: "customer"

Indicates who is allowed to initiate the payment.

note

Using this endpoint, only merchant initiated payments are supported with Revolut Pay.

Environment object, indicating in which environment the payment was made.

caution

Only required if initiator: customer.

note

Only browser is available at the moment.

Possible values: [browser]
Example: "browser"

Type of environment where the payment was made.

Example: 180

Defines the offset to UTC in minutes.

Example: 32

The browser's available colour depth.

Example: 1920

The browser's screen width in pixels.

Example: 1080

The browser's screen height in pixels.

Example: false

Indicates if the browser has Java enabled.

Example: 640

Defines the width of the pop-up window where the authentication challenge appears.

Example: "https://business.revolut.com"

The URL of the page where the payment was initiated.

Response​

Payment initiated

Response body

Body object

The ID of the payment.

Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.

The payment method used to pay for the order.

Possible values: [card, revolut_pay]

The type of payment method used to pay for the order.

Possible values: [revolut_account, card]

Indicates whether the customer used their card or Revolut account via Revolut Pay.

ID of the saved payment method.

note

The id parameter is only returned if the payment method is saved.

Possible values: [pending, authentication_challenge, authentication_verified, authorisation_started, authorisation_passed, authorised, capture_started, captured, refund_validated, refund_started, cancellation_started, declining, completing, cancelling, failing, completed, declined, soft_declined, cancelled, failed]

The status of the payment.

Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: 3D Secure overview.

Only returned if the payment's state is authentication_challenge.

Possible values: [three_ds, three_ds_fingerprint]

Type of the authentication challenge the payment triggers.

The URL of the authentication challenge.