> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Card Negative Balance

> Fired when a card's balance drops below zero. amount is what the card owes.

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 [`CARD_NEGATIVE_BALANCE_SETTLED`](https://docs.fyatu.com/v3.20/webhooks/events/card-negative-balance-settled).

See [Negative balances](https://docs.fyatu.com/v3.20/documentation/concepts/negative-balances.md) for why a card goes below zero and how the amount is settled, with examples.

## Payload

```json theme={null}
{
  "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 |

For the full event group documentation see [Card Events](https://docs.fyatu.com/v3.20/api-reference/webhooks/events).

```json Webhook Payload theme={null}
{
  "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"
  }
}
```

```json 200 theme={null}
{}
```


## OpenAPI

````yaml v3.20/webhooks.json webhook CARD_NEGATIVE_BALANCE
openapi: 3.1.0
info:
  title: FYATU CaaS API v3.20 — Webhook events
  description: >-
    The events FYATU sends to your webhook endpoints. Kept apart from the API
    spec because webhooks are delivered to your server, so they have no base URL
    of ours.
  version: 3.20.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.