{
"event": "CARD_NEGATIVE_BALANCE",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"amount": 3.50,
"currency": "USD"
}
}
{}
Card Events
Card Negative Balance
Fired when a card’s balance drops below zero. amount is what the card owes.
WEBHOOK
CARD_NEGATIVE_BALANCE
{
"event": "CARD_NEGATIVE_BALANCE",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"amount": 3.50,
"currency": "USD"
}
}
{}
Fires once each time a card’s balance goes from zero or above to below zero — typically when a charge, fee or reversal settles for more than the card held. When the card is back to zero or above you receive
For the full event group documentation see Card Events.
CARD_NEGATIVE_BALANCE_SETTLED.
See Negative balances for why a card goes below zero and how the amount is settled, with examples.
Payload
{
"event": "CARD_NEGATIVE_BALANCE",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"amount": 3.50,
"currency": "USD"
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardId | string | The card that went below zero |
cardholderId | string | The cardholder the card belongs to |
amount | number | What the card owes, positive (a balance of −3.50 is sent as 3.50) |
currency | string | ISO 4217 currency code |
{
"event": "CARD_NEGATIVE_BALANCE",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"amount": 3.50,
"currency": "USD"
}
}
{}

