Fast checkout

With Fast checkout you can offer your customers a seamless, one-click checkout experience by automatically collecting their shipping address and delivery method during the checkout process.

This way, your application can skip the shipping flow, which requires users to manually enter their shipping details during checkout and the customer can use existing shipping details stored by Revolut Pay.

How to implement Fast checkout

Complete the following steps to integrate the Fast checkout flow in your Revolut Pay implementation:

• Step 1. Set up webhook for address validation
• Step 2. Set up your backend to respond to address validation requests
• Step 3. Initialize Revolut Pay widget with Fast checkout

Manage multiple stores with Fast checkout​

Optionally, you can register multiple storefronts to use with Fast checkout. The Locations API allows you to manage multiple online stores. Registering locations lets you differentiate and group your orders from different stores. You can also introduce custom processes for your orders on each location.

For example, you can run different address validations or have different shipping price applied on each location.

How to set up multiple stores​

To set up multiple stores with Fast checkout, follow and repeat these steps for each location:

1. Register an online location using the Create a location endpoint.

2. Register address validation endpoint with the location_id parameter pointing to the registered location.

   info

   For more information about this step, see: Set up webhook for address validation

3. Configure your custom processes on your backend for each registered location (e.g., address validation, custom pricing, etc.).

   info

   For more information about address validation for Fast checkout, see: Set up your backend to respond to address validation requests

4. Send the location_id parameter in the request body during order creation to assign the order to a specific location.

Step 1. Set up webhook for address validation​

Revolut Pay manages the user's shipping address(es) and during checkout the user's preferred shipping address will be sent to your backend for validation.

To set up your endpoint to receive addresses, you must use the /synchronous-webhooks endpoint.

Send a request with the following body to the /synchronous-webhooks endpoint:

{
  "event_type": "fast_checkout.validate_address",
  "url": "<yourEndpointUrl>"
}

Where url is a valid URL pointing to an endpoint on your backend that will handle incoming HTTPS POST requests from Revolut Pay.

This call registers the endpoint you provided that will receive shipping addresses for validation.

Example response​

The following JSON object is returned after registering your endpoint:

{
  "id": "5c08dcc1-cd60-4b7d-a255-e42d24d7365c",
  "signing_key": "swsk_VsuFcq6FIpa9gOWUu0n2WxiCbsDHIJlN",
  "url": "<yourEndpointUrl>",
  "event_type": "fast_checkout.validate_address"
}

The signing key will be used by Revolut to compute a Hash-based Message Authentication Code (HMAC) payload signature whenever the registered URL is called. The calculated HMAC code is sent in the header (Revolut-Pay-Payload-Signature) of address validation requests, which should be verified by your backend. For more information, see: Merchant API: Payload Signature.

Step 2. Set up your backend to respond to address validation requests​

After you registered your address validation URL successfully, you have to handle address validation requests on your backend. To do this follow these steps.

(Optional) Step 2.1. Validate the signing key​

When Revolut sends you a shipping address for validation, the request payload is signed and the Revolut-Pay-Payload-Signature HTTP header contains the HMAC calculated using the signing_key. You can validate the payload by computing the HMAC using the signing_key and comparing your HMAC to the received. For more information, see: Merchant API: Payload Signature.

Step 2.2. Validate the address and get delivery methods​

When you receive an address from Revolut, it is important to make sure the address meets the following criteria:

• Address is valid and can be stored in your database
• You (or your shipping partner) can deliver to the address

Once you know the address is valid, you can either fetch available delivery methods from your database, or retrieve them from you shipping partner.

The body of address validation requests has the following JSON structure:

{
  order_id: String,
  shipping_address: {
    street_line_1: String,
    street_line_2: String,
    region: String,
    city: String,
    country_code: String,
    postcode: String
  },
  metadata: Object
}

Address validation object:

Shipping address object:

Step 2.3. Respond to the synchronous webhook call​

After running the validation on the retrieved shipping address, your backend should respond with a JSON object containing the result of validation, using the following structure:

{
  valid: Boolean,
  delivery_methods: [
    {
      ref: String,
      amount: Number,
      label: String,
      description: String
    }
  ]
}

{
  valid: false,
  delivery_methods: []
}

More details on the validation object:

Delivery methods object:

Displaying delivery methods on the widget​

This is how available delivery methods are displayed on the Revolut Pay widget:

The above example has the following JSON structure:

"delivery_methods": [
  {
    "ref": "free_standard",
    "amount": 0,
    "label": "Free standard delivery",
    "description": "3-6 business days",
  },
  {
    "ref": "eco",
    "amount": 500,
    "label": "Eco delivery",
    "description": "5-8 business days. Lowest carbon emission",
  },
  {
    "ref": "express",
    "amount": 2500,
    "label": "Express delivery",
    "description": "Same day delivery for orders placed before 10am",
  },
]

In order to avoid malformed delivery methods to be displayed on the Revolut Pay widget, we advise to follow some best practices when adding delivery method objects to your backend:

• Make the label and description easy to understand and short.
• Use descriptive ref values to make delivery methods easier to identify.
• Don't use special characters in label and description.
• Don't include the delivery price in label and description.
• Don't use the same ref for multiple delivery methods.
• Don't include the ref in other fields.

See the following example of a badly formatted delivery method JSON object:

"delivery_methods": [
  {
    "ref": "89219",
    "label": "89219Shipping_method_dhl_next_day 2EUR",
    "amount": 200
  },
]

Performance requirements​

Performance is critical since integrating your system with Revolut generates shared liability on the Revolut Pay Fast checkout user experience. To keep the risks to a minimum, here are some SLAs we expect from such address validation endpoints:

Step 3. Initialize Revolut Pay widget with Fast checkout​

After successfully setting up the validation webhook (Step 1. and Step 2.), you can initialize the Revolut Pay widget with Fast checkout by passing a specific option (Web and Android: requestShipping, iOS: shouldRequestShipping) in the widget configuration.

To do this on mobile platforms (iOS and Android), you can follow the standard integration process from the following steps:

• Revolut Pay - iOS: 4. Create Revolut Pay button
• Revolut Pay - Android: 2. Configure Android SDK

Enable Fast checkout on Web​

Pass the requestShipping: true parameter in your paymentOptions object:

const paymentOptions = {
  currency: 'USD', // 3-letter currency code
  totalAmount: number, // in lowest denomination e.g., cents
  requestShipping: true,

  createOrder: async () => {
    // Call your backend here to create an order
    const order = await () => {
      
      // For more information, see: https://developer.revolut.com/docs/merchant/create-order

      return yourServerSideCall()
    }
    return { publicId: order.token }
  },
  // You can put other optional parameters here
}