Specify currencies using their ISO 4217 three-letter code. Read on to learn how to use currencies.
For most API operations, specify amounts in the smallest unit (usually the subunit) for a given currency.
Since the smallest unit of Thai Baht is 1/100 of a baht, specify
12300 to indicate ฿123.
curl https://api.omise.co/charges \ -u $OMISE_SECRET_KEY: \ -d "amount=12300" \ -d "currency=THB" \ -d "card=$TOKEN_ID_FOR_THB_CHARGE" \ -d "return_uri=http://example.com/orders/345678/complete"
Since Japanese Yen is a zero-decimal currency (the Yen is itself the smallest unit), specify
123 to indicate ¥123.
Yen is the only zero-decimal currency currently supported.
curl https://api.omise.co/charges \ -u $OMISE_SECRET_KEY: \ -d "amount=123" \ -d "currency=JPY" \ -d "card=$TOKEN_ID_FOR_JPY_CHARGE" \ -d "return_uri=http://example.com/orders/345678/complete"
Note: When searching records using the Search API, specify amounts in the main unit (that is, not the smallest unit). Specify
20to search for records containing an amount of ฿20.
Omise supports creating credit and debit card charges in several currencies.
Supported currencies depend on the country in which your account is registered. See Supported Currencies by registered country.
Minimum and maximum charge amounts are based on the country in which your account is registered and your specific account settings.
Stricter minimum and maximum amounts for charges may be enforced for specific payment methods. See the relevant payment method documentation for details.
|Country||Minimum Charge||Maximum Charge|
When creating a charge in a currency other than the account funding currency (see multi-currency), the effective minimum and maximum charge is measured in the equivalent amount after exchange to the settlement currency.
Settlement and Transfers
Charges are always settled in your account funding currency. Your account funding currency depends on the country in which your account is registered.
Funds can only be transferred to a bank account in your account funding currency. The bank account must be located in the country where the account was registered.
Minimum and maximum transfer amounts are based on the country in which your account is registered.
|Country||Minimum Transfer||Maximum Transfer|