Overview
Alerts notify you when a cardholder contacts their bank to dispute a transaction. By actioning alerts quickly (typically within 48 hours), you can issue a refund and prevent the dispute from escalating into a chargeback. Chargeblast supports two alert networks:- Ethoca (Mastercard) — Best coverage, front-runs other alert types
- CDRN (Visa) — Issuer-based Visa product
For information on RDR (Visa’s acquirer-side product), see the RDR Endpoint documentation. RDR is handled automatically at the acquirer level and requires a separate implementation.
Choose Your Integration Path
- Push Data (Recommended)
- Pull Data
How It Works
-
Connect your transaction data via one of two methods:
- Supported payment processor (Stripe, Braintree, etc.)
- Upload Orders endpoint
- Chargeblast matches alerts to your transactions automatically using card details, amounts, and dates.
-
Receive webhooks with matched
externalOrderIDs:alert.created— New alert receivedalert.updated— Alert status changed (includesexternalOrder)alert.refunded— Alert triggered a refund
- Action alerts by calling the Update Alert endpoint with the appropriate reason code.
Implementation Steps
Connect Transaction Data
Either connect a supported PSP or implement the Upload Orders endpoint to push transaction data.
Set Up Webhooks
Configure your webhook URL in the Chargeblast dashboard to receive alert notifications.
Process Refunds & Update Alerts
When you receive an
alert.created or alert.updated webhook with a matched externalOrder, process the refund in your payment system and then call the Update Alert endpoint:Strongly recommended: Use the Update Alert endpoint to action alerts. The Refund Endpoint approach (where Chargeblast calls your server) is largely deprecated.
With push data integration, alert webhooks include matched order IDs, making it easy to identify which transaction to refund.
API Reference
| Endpoint | Description |
|---|---|
| Upload Orders | Push transaction data for matching |
| Fetch Alerts | Poll for alerts |
| Fetch Alert | Get a specific alert |
| Update Alert | Action an alert with a reason code |
| Webhooks | Receive real-time alert notifications |
| Reason Codes | Full list of reason codes |
Related
- Reason Codes Reference — Full list of codes and when to use them
- RDR Endpoint — Visa’s acquirer-side dispute resolution
- Refund Endpoint — Legacy automated refund processing (deprecated)