Currencies and amounts

Every amount sent to or returned by the API is an integer in the currency's minor unit. Never send a decimal or format an amount with floating-point arithmetic.

For example, AED 12.34 is 1234. Utopia currently accepts AED only because the connected Geidea merchant account is provisioned for AED settlement.

Enabled currencies

The API accepts only currencies enabled for the account and mode represented by the key. Retrieve the current list instead of hard-coding it:

curl https://utopia-payments.com/api/v1/account \
  -H "Authorization: Bearer $UTOPIA_API_KEY"

{
  "object": "account",
  "livemode": true,
  "payments_enabled": true,
  "currencies": ["AED"]
}

Creating a checkout in another currency returns CURRENCY_NOT_SUPPORTED. The response message includes the currently enabled currencies.