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

# BINs

> Every card is issued on a BIN: it decides the network, the country of issue and what the card supports. Your account holds the balance that funds every card.

## Your account

Your account holds your **balance**. Every card funding is drawn from it, and every unload and
termination refund comes back to it.

* Read it with [`GET /balance`](https://docs.fyatu.com/v3.20/api-reference/account/balance).
* Top it up from the CaaS portal; [`GET /deposit-address`](https://docs.fyatu.com/v3.20/api-reference/account/deposit-address)
  returns your deposit addresses.
* When it falls below your low-balance threshold, you receive
  [`ACCOUNT_LOW_BALANCE`](https://docs.fyatu.com/v3.20/webhooks/events/account-low-balance).

## BINs

A **BIN** is the range a card number starts with, and it decides what the card is: Visa or
Mastercard, the country it is issued in, and what it supports (Apple Pay, Google Pay, 3D Secure).
Those capabilities belong to the BIN and cannot be switched on per card.

Each BIN has a **BIN ID** such as `SGVISAV01`. [`GET /bins`](https://docs.fyatu.com/v3.20/api-reference/bins/list) lists
the BINs on your account with their IDs, capabilities and settings, and `issuable` tells you whether
cards can be issued on each one right now. A BIN ID is letters and digits only, with no
separators. It is what you send to issue a card:

```json theme={null}
POST /cards
{
  "cardholderId": "chl_01HXYZ1234ABCDEF5678",
  "binId": "SGVISAV01",
  "amount": 100.00
}
```

In the sandbox, cards are issued on two test BINs: `TESTVISAV` and `TESTMCV`.

## What a BIN decides for its cards

Each BIN on your account carries the settings every card issued on it follows. You see them in
[`GET /bins`](https://docs.fyatu.com/v3.20/api-reference/bins/list) and on the BIN's page in your dashboard; your account
manager sets them up with you.

| Setting | Effect |
| - | - |
| Reloadable | Whether a card can be funded again after issuance (`422 CARD_NOT_RELOADABLE` if not) |
| Spending limits | The limits every card starts with; adjust one card with [`POST /cards/{id}/limits`](https://docs.fyatu.com/v3.20/api-reference/cards/limits) |
| Cards per cardholder | How many active cards one cardholder may hold (`409 CARDHOLDER_CARD_LIMIT_EXCEEDED` beyond it) |
| Validity | How long its cards stay valid |

Every card is issued with an opening `amount`, its first load (`400 CARD_AMOUNT_REQUIRED` without
one).

> [!NOTE]
>
> Integrations written before BINs issue cards with a `productId`. That still works: the card is
> issued on that product's BIN. New integrations should send `binId`.

## Amounts

Amounts you send, and the amounts on cards, transactions and your balance, are **dollars** as a
number: `50.00` is fifty dollars.


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