Currencies

Currency representation as an integer

The Fintoc API returns every amount of a currency in its smallest possible unit, with no decimals (as an integer).

The smallest unit of the Chilean peso is a peso, so Fintoc represents an amount of 1000 CLP as the integer 1000.

The smallest unit of the US dollar is a cent, so Fintoc represents an amount of 10.50 USD as the integer 1050.

The following examples show accounts where currency is CLP or USD. The CLP account has 150980 CLP available, and the USD account has 159.50 USD available.

{
    "id": "acc_nMNejK7BT8oGbvO4",
    "name": "Cuenta Corriente CLP",
    "official_name": "Cuenta Corriente Moneda Peso Chileno",
    "number": "0000000001",
    "holder_id": "111111111",
    "holder_name": "Lannister SpA",
    "type": "checking_account",
    "currency": "CLP",
    "balance": {
        "available": 150980,
        "current": 150980,
        "limit": 150980
    }
}
{
    "id": "acc_8s7Hk2Lp9QwErTy3",
    "name": "Cuenta Corriente USD",
    "official_name": "Cuenta Corriente Moneda Dolar",
    "number": "0000000002",
    "holder_id": "111111111",
    "holder_name": "Lannister SpA",
    "type": "checking_account",
    "currency": "USD",
    "balance": {
        "available": 15950,
        "current": 15950,
        "limit": 15950
    }
}

Fintoc supports accounts in CLP, MXN, USD, and EUR. The following table shows an example amount in each currency and the integer Fintoc returns for it:

CurrencyAmountFintoc representation of the amount
CLP1000 CLP1000
MXN10.29 MXN1029
USD10.50 USD1050
EUR10.00 EUR1000