Webhooks send alert and deflection events from Chargeblast to an endpoint on your server as they happen
⚠️ Important: If webhook deliveries fail, your system may not receive alert updates in time to act on them
Common Problems
| Problem | Cause | Fix |
|---|---|---|
| Missing events | Endpoints only receive the events they're subscribed to. New endpoints receive alert.created only | In Chargeblast, go to Settings → Developer → Configure, open your endpoint, and edit Subscribed events. Select the events you need, then save |
externalOrder field is missing | alert.created doesn't include this field | Subscribe to alert.updated. It's sent once an alert is matched to a transaction, so unmatched alerts won't have this field |
| Signature verification fails | The signature is being checked incorrectly | Ask your developer to remove the v1, prefix from the svix-signature header and verify against the raw request body. See the Webhooks developer docs |
| Endpoint was disabled | Deliveries kept failing, so the endpoint was disabled automatically. You'll receive a "Webhook Endpoint Has Been Disabled" email | Resolve the error on your server, then re-enable the endpoint from its actions menu in Settings → Developer → Configure. Resend what was missed using the steps under Testing and resending events |
Available Events
| Alerts | Deflections |
|---|---|
alert.created | deflection.created |
alert.updated | deflection.updated |
alert.refunded | |
alert.matched | |
alert.will_expire | |
alert.within_refund_rules |
Webhooks cover alerts and deflections only. There are no dispute or chargeback events.
Checking webhook status
- All deliveries: In Settings → Developer → Configure, open the Logs tab. Click a message to see its payload, delivery attempts and the response code your server returned
- A single alert: Open the alert, scroll to Webhook deliveries, and expand a row
Note: An alert's
createdAtis when the alert was created, not when the webhook was sent. The Logs tab shows the actual delivery time
Testing and Resending Events
In Chargeblast, go to Settings → Developer → Configure and open your endpoint.
Test your endpoint. Use this to confirm your server can receive events
- Open the Testing tab
- Click Send Event
- Check your server. If the event arrived, your endpoint is working
Resend missed events. Use this to recover events from the last 14 days
- Pick the option that matches the problem:
- Recover Failed Messages: resends deliveries that failed
- Replay Missing Messages: sends events that were never delivered
- Choose a time window
- Confirm. Nothing is sent until you do
Resend a single event. Use this to resend one specific message or alert
To resend an existing message:
- Open the message
- Click Replay
To create a new event for an alert:
- Open the alert
- Go to Actions → Replay Webhook
- Select Emit new
alert.created
Getting Help
Contact support and include:
- The affected alert IDs (for example,
al_…) - The message IDs from your webhook logs (for example,
msg_…)
Tags
Was this article helpful?
Help us improve our documentation
