{
"event": "CARD_NEGATIVE_BALANCE_SETTLED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"amountSettled": 3.50,
"balance": 16.50,
"currency": "USD"
}
}
{}
Card Events
Card Negative Balance Settled
Fired when a card that was below zero is back to zero or above.
WEBHOOK
CARD_NEGATIVE_BALANCE_SETTLED
{
"event": "CARD_NEGATIVE_BALANCE_SETTLED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"amountSettled": 3.50,
"balance": 16.50,
"currency": "USD"
}
}
{}
Fires once each time a card that was below zero returns to zero or above — when it is funded, refunded or otherwise brought back. It follows a
For the full event group documentation see Card Events.
CARD_NEGATIVE_BALANCE for the same card.
See Negative balances for why a card goes below zero and how the amount is settled, with examples.
Payload
{
"event": "CARD_NEGATIVE_BALANCE_SETTLED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"amountSettled": 3.50,
"balance": 16.50,
"currency": "USD"
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardId | string | The card whose negative balance was cleared |
cardholderId | string | The cardholder the card belongs to |
amountSettled | number | The amount the card owed that has now been cleared |
balance | number | The card’s balance now (zero or above) |
currency | string | ISO 4217 currency code |
{
"event": "CARD_NEGATIVE_BALANCE_SETTLED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"amountSettled": 3.50,
"balance": 16.50,
"currency": "USD"
}
}
{}

