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

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

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

See [Negative balances](https://docs.fyatu.com/v3/documentation/concepts/cards/negative-balances.md) 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) |

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

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


## OpenAPI

````yaml v3/openapi.json webhook card.negative_balance_settled
openapi: 3.1.0
info:
  title: FYATU API v3
  description: >-
    FYATU API v3 with JWT authentication for Collections, Payouts, and Card
    Issuing.
  version: 3.0.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers:
  - url: https://api.fyatu.com/api/v3
    description: Production
security: []
tags:
  - name: Authentication
    description: JWT token management endpoints
  - name: Account
    description: Business account, wallet, and address management
  - name: Collections
    description: Accept payments from customers via checkout sessions
  - name: Refunds
    description: Issue refunds for completed collections
  - name: Payouts
    description: Send money to Fyatu account holders
  - name: Cardholders
    description: Cardholder management for card issuing programs
  - name: Cards
    description: Issue, fund, freeze, and manage virtual cards
  - name: Webhooks
    description: Webhook configuration and management
paths: {}

````

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