Amount Format

August 04, 2026

Aprende a construir el campo amount en unidades mínimas según la moneda de tu país y evita cobros con el monto equivocado

Every Kushki ONE Connect endpoint that involves money shares the same amount object. Before you build your first request, you need one rule: amounts are sent as integers, in the currency’s smallest unit.

Never send periods, commas, spaces or any other separator.

Your currency and its decimals

In Mexico you operate in Mexican pesos (MXN), which use two decimals.

The conversion rule

The last two digits of the integer are always the fractional part. When the amount has no fraction, add the two zeros anyway.

How the amount adds up

The amount charged is the sum of every field in the amount object.

Full example

A 1,000.00 MXN sale with 16% VAT.

{
  "amount": {
    "iva": 16000,
    "subtotal_iva": 100000,
    "subtotal_iva0": 0,
    "extra_taxes": { "airport_tax": 0, "iac": 0, "ice": 0, "travel_agency": 0 }
  },
  "client_transaction_id": "3c4d5e6f-1111-4000-8000-aabbccddeeff"
}

Sale with no tax breakdown

When you do not itemize taxes, put the whole amount in subtotal_iva0:

{
  "amount": {
    "iva": 0,
    "subtotal_iva": 0,
    "subtotal_iva0": 11800,
    "extra_taxes": { "airport_tax": 0, "iac": 0, "ice": 0, "travel_agency": 0 }
  },
  "client_transaction_id": "1a2b3c4d-3333-4000-8000-112233445566"
}

Convert without losing cents

Pass the value as a string, not as a decimal number: Decimal(12.44) inherits the same binary error you are trying to avoid.

const DECIMALS = { COP: 2, MXN: 2, PEN: 2, CLP: 0 };

function toMinorUnits(value, currency) {
  const [whole, frac = ""] = String(value).split(".");
  const exp = DECIMALS[currency];
  return Number(whole + frac.padEnd(exp, "0").slice(0, exp));
}

toMinorUnits("12.44", "COP"); // 1244
toMinorUnits("1244", "CLP");  // 1244

from decimal import Decimal

DECIMALS = {"COP": 2, "MXN": 2, "PEN": 2, "CLP": 0}

def to_minor_units(value: str, currency: str) -> int:
    exp = DECIMALS[currency]
    return int(Decimal(value).scaleb(exp).to_integral_value())

to_minor_units("12.44", "COP")  # 1244
to_minor_units("1244", "CLP")   # 1244

Common mistakes

If you operate in several markets

This section applies only if your POS system serves merchants in more than one country.