Webhooks

Use webhooks to receive event notifications from Vitesse when activity occurs in your account. Webhooks enable your system to respond automatically to asynchronous changes, such as payment status updates, without polling the API.

When an event occurs, Vitesse sends a secure POST request to a specified endpoint with a JSON payload containing the event details.

Receive webhook events

• Configure a publicly accessible HTTPS endpoint that accepts POST requests with application/json payloads
• Configure your system to handle the payload when it is delivered to your endpoint
• Subscribe to the webhook events you want to receive

Environments

Webhook notifications are sent from different Vitesse environments depending on the region and service you are using.

Vitesse maintains separate production environments for:

• UK Hub — customers holding funds in the United Kingdom and select other countries
• US Hub — customers holding funds in the United States
• Staging — shared non-production environment for testing and integration validation

When configuring your infrastructure, ensure you allowlist the outbound webhook IP addresses for the relevant environment.

📘

Webhook notifications are sent from Vitesse infrastructure to your configured HTTPS endpoint. If your systems restrict inbound traffic, you may need to allowlist the relevant Vitesse IP addresses. Contact Support for more information.