Merchant API
Register address validation endpoint for Fast checkout
api
post
/api/synchronous-webhooks

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:

  1. Register an URL to handle address validation
  2. Validate the shipping address sent to your backend
  3. 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:

note

To set up a webhook for tracking order completion, failure, error, etc. events, use the Webhooks endpoints.

Request​

Header Parameters
Header Parameters
Request body
Body object 

Response​

OK

Response body
Body object 
Was this page helpful?
POST
/api . /synchronous-webhooks . 
Parameters
curl -L -X POST 'https://merchant.revolut.com/api/synchronous-webhooks' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <yourSecretApiKey>' \
--data-raw '{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}'
Request body samples
{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}
Response body samples
{
  "id": "f6abc4df-eb48-417c-8e75-f7c6d7ad394f",
  "signing_key": "swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1",
  "url": "https://backend.example.com/webhooks/validate-address",
  "event_type": "fast_checkout.validate_address"
}