Event subscriptions are a feature of our API that you can subscribe to so that we notify you about changes to an account, for example, when we change the status of a processing account.

Note: For a list of the events that you can subscribe to, go to Events list.

How it works

The following diagram shows how to subscribe to an event and how to handle an event.

Subscribe to events

Create an event subscription and send it to our gateway.
Our gateway creates the event subscription.
Our gateway sends you a response to confirm that we have created the subscription.

Handle event notifications

We make a change to an account and trigger an event notification.
Our gateway sends a webhook to your endpoint.
Your server returns a 200 response to confirm that you have received the webhook.

Your integration journey

To add event notifications to your integration, complete the following steps:

Create an event subscription with our API.
Handle the webhook.

Guides

Create an event subscription

Receive notifications when events occur.