Currencies and countries

When working with the Qualy API you soon will need to specify currencies and country codes. In this article we explain how Qualy deals with currencies and countries across its API.

Currencies

In any API call where a currency must be specified, the currency code must be a valid ISO 4217 currency code. To see the list of all currencies in the ISO 4217 standard, check this page.

Currency unit

API requests require amounts to be specified in the smallest unit of the currency. For instance, if you want to charge 10 AUD, you should provide an amount value of 1000 (equivalent to 1000 cents), we arrived at this value by multiplying 10 AUD times 100.

Countries

In any API call where a country must be specified, the country code must be a valid ISO 3166-1 alpha-2 code. To see the list of all country codes in the ISO 3166-1 alpha-2 standard, check this page.

We may support some countries that are not officially suppored by the ISO 3166-1 alpha-2 standard. Countries such as Kosovo, Montenegro and others are examples of this exception to the rule.

Percentages

In any API call where a percentage must be specified, use a value from 0 to 1. Example: a 10% percentage rate would be 0.1.