Register address validation endpoint for Fast checkout

Use this endpoint to register a URL where Revolut can send shipping address(es) from a Revolut Pay customer for validation during the Fast checkout process.

Revolut Pay can support Fast checkout for delivering goods. Once your customer selects a shipping address, Revolut needs to validate if the merchant (or their shipping partner) delivers to the address provided. This is done by contacting the merchant's backend and asking for such validation and information.

In order for your backend to support Fast checkout, you need to:

Register an URL to handle address validation
Validate the shipping address sent to your backend
Respond with a JSON object containing the result of the validation

Additionally, Revolut Pay can support multiple webhooks if you have multiple stores. For more information, see:

Request

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.

Request body

Body object

Possible values: [fast_checkout.validate_address]

Type of event this synchronous webhook is configured for.

The valid URL of the endpoint, that uses the HTTPS URL schema. Revolut sends the shipping address of the customer to this URL for validation.

Unique ID representing the location where merchants sells products.

Response

Response body

Body object

The ID of the synchronous webhook object.

Pattern: Value must match regular expression ^swsk_[a-zA-Z0-9]{32}$

A randomly generated signing key, which can be used by merchants to authenticate requests from Revolut by verifying the signature. For more information, see: Payload Signature.