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

# Negative balances

> How a card can go below zero, how you are told, and how the amount it owes is settled: by you within 3 days, or from your business wallet after that.

A card's balance can go **below zero**. It is rare, but it is real money. The
card network has already paid the merchant, and the shortfall is owed by the card. This page
explains why it happens, how you find out, and how it is settled.

> [!NOTE]
>
> **In short.** You are told the moment a card goes below zero
> ([`card.negative_balance`](https://docs.fyatu.com/v3/webhooks/webhook-events/card-negative-balance)). You have **3 days**
> to fund the card yourself. After that, the card is funded back to **\$0.00 from your business
> wallet**, once a day until it is clear, provided your wallet covers the whole amount.

## Why a card goes below zero

A card cannot *spend* more than it holds: a purchase larger than the balance is declined. A balance
goes negative when money is taken from the card **after** the purchase was approved, or **without**
an approval at all:

| Cause | What happens | Typical size |
| - | - | - |
| **Forced post** — *most common* | A merchant takes a payment the card never approved: a charge posted without asking, or settled after it was declined or after its approval expired. The card network allows it, and the card pays it whatever its balance. | Any amount |
| **Double debit** — *most common* | The same purchase is settled twice: the merchant or its processor presents it a second time. The first settlement used the card's balance; the second takes the card below zero. | The purchase amount |
| **Merchant captures more than it authorised** | Hotels, car rentals, fuel stations and restaurants with tips may settle for more than they asked for at the till. Exchange-rate movement between approval and settlement has the same effect. | Usually small |
| **Cross-border fee** | A cross-border fee settles after the purchase it belongs to, so a card spent down to \$0.00 then owes the fee. | Cents to a few dollars |
| **A refund reversed** | A merchant refund credited to the card is later withdrawn by the merchant, after the money was spent. | Any amount |

The cardholder made the payment on a card issued to your business, so the amount is owed by your
business.

### A double debit is disputed

If the statement shows **the same purchase settled twice**, contact support with the card ID and
both transactions. We raise the duplicate with the issuer. If it is reversed, the amount comes back
to the card and pays off what it owes. A dispute takes time, so fund the card in the meantime if
the cardholder needs to keep using it.

## How you are told

| Event | When |
| - | - |
| [`card.negative_balance`](https://docs.fyatu.com/v3/webhooks/webhook-events/card-negative-balance) | Once, when a card goes from zero or above to below zero. `amount` is what the card owes, as a positive number. |
| [`card.negative_balance_settled`](https://docs.fyatu.com/v3/webhooks/webhook-events/card-negative-balance-settled) | Once, when the same card is back to zero or above. `amountSettled` is what it owed; `balance` is what it holds now. |

The event normally arrives within minutes of the charge that caused it.
[`GET /cards/{cardId}`](https://docs.fyatu.com/v3/api-reference/cards/get) returns a negative `balance` while the card owes
money.

While a card is below zero it has nothing to spend, so new purchases are declined until it is
settled. Settle promptly, or freeze the card
until you do.

## Settling it yourself: fund the card

Fund the card with [`POST /cards/{cardId}/fund`](https://docs.fyatu.com/v3/api-reference/cards/fund). The funding pays off
what the card owes **first**; whatever is left becomes its spendable balance.

**Example: a double debit.** A card holds \$50.00. A hotel settles a \$42.00 purchase, leaving
\$8.00, and then presents the same \$42.00 a second time. The card is now at **−\$34.00**.

**1. The card goes below zero**

```json theme={null}
{
  "event": "card.negative_balance",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "amount": 34.00,
    "currency": "USD"
  }
}
```

**2. You fund the card with \\\$40.00**

Your wallet is charged as for any funding. \$34.00 pays what the card owed and **\$6.00** is
spendable.

**3. The card is back above zero**

You receive `card.funded`, then:

```json theme={null}
{
  "event": "card.negative_balance_settled",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "amountSettled": 34.00,
    "balance": 6.00,
    "currency": "USD"
  }
}
```

**Fund at least \$1.00.** It is the smallest funding a card accepts, even when the card owes less.

## If you do not: automatic settlement from your wallet

A card that is **still below zero 3 days after** `card.negative_balance` is settled for you. Once a
day (at 09:20 UTC):

1. The card's balance is read live. A card you have already brought back to zero is left alone.
2. If your business wallet covers **the whole amount**, the card is funded with exactly what it
   owes, so it ends at **\$0.00**. No funding fee is charged on this funding.
3. You receive `card.funded`, then `card.negative_balance_settled`.

If your wallet does **not** cover the whole amount, nothing is taken. There are no partial
recoveries. The card is checked again the next day, and every day after, until it is settled.

| Example | Taken from your wallet | Card afterwards |
| - | - | - |
| Card owes \$34.00 after a forced post, wallet holds \$100.00 | \$34.00 | \$0.00 |
| Card owes \$0.40, wallet holds \$50.00 | \$1.00 (the smallest funding) | \$0.60, still yours to spend or unload |
| Card owes \$34.00, wallet holds \$20.00 | Nothing | −\$34.00, checked again tomorrow |

## Before you delete a card

A card that owes money cannot be closed. Settle it first: fund it, or let the automatic settlement
run, and wait for `card.negative_balance_settled`. Then delete it with
[`DELETE /cards/{cardId}`](https://docs.fyatu.com/v3/api-reference/cards/delete).

## Checklist for your integration

* Handle `card.negative_balance` and `card.negative_balance_settled`.
* On `card.negative_balance`, fund the card (at least `amount`, and at least \$1.00) or freeze it
  until you can.
* Keep your wallet funded: the automatic settlement takes only the whole amount, never part of it.
* Show the cardholder their real balance, including when it is negative.


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