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

# Cards

> How disposable and virtual cards work, what each costs, and how a card moves between active, blocked, deactivated and deleted.

A card spends from an entity account. You issue it through the API and manage it with a small set of lifecycle actions. Card details such as the number and CVV are read through [Get card details](https://docs.nuvion.co/api-reference/cards.md#get-card-details), so treat that response as sensitive.

## Choose a card type

| Type | Behavior | Use it for |
| - | - | - |
| `disposable` | Single use. After its first transaction the card is `deactivated`. | One purchase, or a payment you want to limit to one charge. |
| `virtual` | Reusable. It stays `active` after transactions. | Recurring spend, subscriptions, or a team card. |

See [Card issuing](https://docs.nuvion.co/guides/card-issuing.md) for a request for each type.

## Lifecycle

| Status | Meaning |
| - | - |
| `active` | The card accepts authorizations. |
| `blocked` | The card is frozen and every authorization is declined. |
| `deactivated` | A disposable card that has been used. |
| `fraud` | The card is flagged as fraud. |

| Action | Effect |
| - | - |
| Freeze | Sets the card to `blocked`. History is kept. |
| Unfreeze | Returns a frozen card to `active`. |
| Reassign | Moves the card to another account of the same entity. The card keeps its status. |
| Delete | Soft-deletes the card. It is blocked and no longer returned by the API. |

## Rules that affect your integration

* **A fee applies to each card.** Creating a card debits a creation fee from the funding account, in the card's currency. If the account can't cover it, the request fails with `400 error_card_creation_fee_required`. Check the fee first with `GET /card-creation-fee/{account_id}`.
* **Creation is not idempotent.** Sending the same create request twice issues two cards and charges two fees. Don't retry a request that may have succeeded; list the account's cards first.
* **The funding account must match the card currency.** A card in a different currency returns `400 error_operation_invalid_for_state`.
* **Spending uses the account balance.** The card's amount field is a placeholder, not a limit. What the card can spend is the available balance on its account.
* **Reassigning across currencies works.** FX conversion is applied at the prevailing rate as the card is used, so no extra step is needed.

## Next steps

* [Card issuing guide](https://docs.nuvion.co/guides/card-issuing.md)
* [Cards API reference](https://docs.nuvion.co/api-reference/cards.md)


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