Minor Units Format
Amount Format
Acme maintains a consistent format for amount values across all Acme APIs.
All amount values provided in the API must be represented in their smallest currency unit as an integer.
Examples
| Currency | Example Amount | Smallest Unit (ISO 4217 standard) | API Value |
|---|---|---|---|
| SGD | $10.00 | cents | 1000 |
| USD | $10.00 | cents | 1000 |
| EUR | €10.00 | cents | 1000 |
| JPY | ¥10 | yen | 10 |
| VND | ₫10 | dong | 10 |
Important
- You must convert major currency units to the smallest unit before sending to Acme (e.g. send
1050for SGD $10.50). - All amounts will be returned in the smallest unit. Your system must convert these back to major units if needed for display.
- Amounts must not include decimal points. Submissions with decimal points (e.g.
10.50) will be rejected.
{
"amount": 1050,
"currency": "SGD"
}