Use this page to configure event distribution channels in the Ripple Custody beta UI.
Ripple Custody provides three methods for tracking events. Choose the method that best fits your use case:
| Method | Type | Best for | Setup required |
|---|---|---|---|
| Events API | Pull | Reconciliation, historical queries, on-demand event retrieval | None (available out of the box) |
| Webhooks | Push | Real-time notifications, event-driven workflows, immediate response to events | Configure webhook channels (this section) |
| AMQP queue | Push | High-volume event processing, guaranteed delivery, complex event routing | Contact Ripple support |
Best practice: Use webhooks for real-time notifications AND implement a periodic reconciliation process using the Events API. This provides both immediate notifications and a safety net for any delivery failures.
To get started with webhooks in the UI:
- Ensure you have the
eds-managerrole for your domain. - Set up an HTTPS endpoint to receive webhook notifications.
- Access the beta UI - see Register a webhook.
- Configure your webhook channel with the desired event types.
- Test your integration using the Send test event feature.
- Implement a reconciliation process using the Events API.
The Ripple Custody API currently supports Webhooks.
For a complete list of available event types, see Event tracking.
Want to manage events with the API instead? See Manage events with the API.