Webhooks

Webhooks allow you to receive notifications of events that occurred on the platform. These notifications are delivered to an HTTPS endpoint of your choice.

Setup

Multiple webhook URLs per instance are supported. Webhooks can be configured by administrators by heading to Settings -> Manage Integrations -> Webhook subscriptions. For each subscription, it’s possible to listen to the events for all merchant accounts in an instance, or to the events for one merchant account.

Webhook delivery behavior

1. Multiple subscriptions
   If you configure multiple subscriptions pointing to different URLs, each subscription receives its own webhook deliveries.
2. Retries are subscription-specific
   If a webhook delivery fails, it is only retried for the subscription that encountered the failure, even if other subscriptions (pointing to the same or different URLs) succeed.

Supported features

• Multiple webhook subscriptions per merchant account
• Merchant account and instance-level webhook subscriptions
• Detailed payloads for transactions, payment methods, buyers, billing details, and most other transaction related events.
• Over 20 different webhook events.
• Basic authentication credentials (username/password)
• Automatic retries of undelivered events
• Webhook signatures to verify authenticity.

Upcoming features

• Event filtering per subscription
• Event log and replay capabilities

Next steps

• Learn about the structure of webhook messages in Payloads
• Review all supported webhook Events
• Understand delivery guarantees and retry logic in Technical considerations
• Secure your endpoints by verifying Signatures