Introduction to Webhooks
Webhooks provide a powerful way for your systems to receive real-time notifications about events in the CleverCards Platform. Rather than requiring you to continuously poll our API for updates, webhooks push information to your systems as events occur.
Our webhook system allows you to subscribe to specific events and receive HTTP POST requests to your designated endpoints whenever those events happen. This enables you to build responsive applications that can immediately react to events as they happen, improving both user experience and access to data for operational efficiency.
How Webhooks Work
You retrieve all webhook events registered for your account by hitting this endpoint
You select which event types you want to receive :
- CARD_TOKEN_DRAFT_CREATED
- CARD_TOKEN_DRAFT_CANCELLED
- CARD_CREATED
- CARD_ACCOUNT_FUNDED
- CARD_ACCOUNT_UNFUNDED
You register a new webhook event for your account by Register a new endpoint
When a relevant event occurs in our system, we send an HTTP POST request to your URL
Your server processes the webhook payload and responds with a 2xx status code to acknowledge receipt
All webhook payloads are signed with a secret key to ensure security, and we include an idempotency key to prevent duplicate processing in case of retries.