{
"event": "card.negative_balance_settled",
"version": "3.0",
"eventId": "c5d6e7f8-a9b0-1234-8901-cdef01234567",
"sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
"data": {
"cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
"cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
"amountSettled": 3.50,
"balance": 16.50,
"currency": "USD",
"message": "Card negative balance settled",
"appId": "A1B2C3D4E5F6G7H8",
"timestamp": "2026-05-11T09:15:00Z"
}
}
{}
Cards
Card Negative Balance Settled
Sent when a card that was below zero is back to zero or above.
WEBHOOK
card.negative_balance_settled
{
"event": "card.negative_balance_settled",
"version": "3.0",
"eventId": "c5d6e7f8-a9b0-1234-8901-cdef01234567",
"sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
"data": {
"cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
"cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
"amountSettled": 3.50,
"balance": 16.50,
"currency": "USD",
"message": "Card negative balance settled",
"appId": "A1B2C3D4E5F6G7H8",
"timestamp": "2026-05-11T09:15:00Z"
}
}
{}
Sent once each time a card that was below zero returns to zero or above — when you fund it,
when it is refunded, or when we fund it back to $0 from your business wallet after the grace period
(see
card.negative_balance). It follows a
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.
| 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 |
message | string | Human-readable summary |
appId | string | Your application ID |
timestamp | string | When the event was sent (ISO 8601) |
{
"event": "card.negative_balance_settled",
"version": "3.0",
"eventId": "c5d6e7f8-a9b0-1234-8901-cdef01234567",
"sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
"data": {
"cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
"cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
"amountSettled": 3.50,
"balance": 16.50,
"currency": "USD",
"message": "Card negative balance settled",
"appId": "A1B2C3D4E5F6G7H8",
"timestamp": "2026-05-11T09:15:00Z"
}
}
{}
Body
application/json
Response
200
Acknowledge receipt of the event

