> ## 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 Settled

> Fired when a card that was below zero is back to zero or above.

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

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_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 |

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_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"
  }
}
```

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


## OpenAPI

````yaml v3.20/webhooks.json webhook CARD_NEGATIVE_BALANCE_SETTLED
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.