Event catalog
All webhook event types that merchants can subscribe to, grouped by category. Pass the type values in the eventTypes array when registering a webhook destination.
All event names use hyphens (for example subscription-activated, not subscription.activated).
Transactions
| Event type | When it fires |
|---|---|
transaction-processed | A transaction was processed by the gateway — payment captured or refund completed. |
transaction-declined | A transaction was declined by the processor or issuer. |
Subscriptions
| Event type | When it fires |
|---|---|
subscription-activated | The subscription moved to active — first payment succeeded. |
subscription-canceled | The subscription was canceled (immediately or scheduled for end of current period). |
subscription-churned | The subscription reached end of grace period after failed renewals and was permanently ended. |
subscription-downgraded | The subscription was moved to a lower-priced plan. |
subscription-modified | The subscription was modified (changes other than a plan upgrade or downgrade). |
subscription-reactivated | A scheduled cancellation was reversed and the subscription continues. |
subscription-renewed | A billing cycle completed and the renewal charge succeeded. |
subscription-upgraded | The subscription was moved to a higher-priced plan. |
subscription-items-changed | The line items on the subscription changed. |
subscription-trial-changed | The trial configuration on the subscription was updated. |
subscription-trial-ended | The trial period ended. |
subscription-trial-end-reminder | Dispatched ahead of trial end. |
subscription-renewal-reminder | Dispatched 7 days before a scheduled renewal. |
Orders and payments
| Event type | When it fires |
|---|---|
offsite-payment-completed | The customer completed a payment on the offsite hosted form. |
Disputes
| Event type | When it fires |
|---|---|
dispute-created | A new dispute (chargeback or inquiry) was opened on a transaction. |
dispute-updated | An existing dispute was updated (status, evidence, or deadline changed). |
dispute-lost | The dispute was resolved in favor of the customer — funds were debited from your account. |
dispute-comments | A new comment was added to a dispute. |
dispute-won | The dispute was resolved in favor of the merchant. |
Coming soon
| Event type | Notes |
|---|---|
organization-transfer-instrument-added | Currently behind a feature flag — not yet accessible. |