Currencies

Accept payments in multiple currencies.

Supported Currencies

Currency availability depends on your payment processor configuration. Not all currencies are enabled by default. Contact Ozura support to confirm which currencies are enabled for your account before accepting payments in a non-USD currency.

Ozura Checkout accepts standard 3-letter currency codes. Common currencies include:

Code	Currency	Symbol
`USD`	US Dollar	$
`CAD`	Canadian Dollar	CA$
`GBP`	British Pound	£
`EUR`	Euro	€
`AUD`	Australian Dollar	A$
`MXN`	Mexican Peso	MX$

Default: If you don’t specify a currency, USD is used.

Usage

Specify the currency when creating a session:

{
  "merchantId": "your_merchant_id",
  "merchantName": "My Store",
  "amount": "25.00",
  "currency": "GBP",
  "successUrl": "https://mysite.com/success",
  "cancelUrl": "https://mysite.com/cancel",
  "errorUrl": "https://mysite.com/error"
}

The checkout page will display prices in the specified currency with the appropriate symbol.

Amount Format

The amount can be sent as a string or number:

Correct	Incorrect
`"25.00"`	`"$25.00"` (no currency symbols)
`25.00` or `25`	— (any valid number is accepted)
`"100.50"`, `"100.5"`, or `100.50`	`"100.500"` (more decimals than currency allows)

Both "25.00" (string) and 25.00 (number) work. Use whichever is more convenient for your code.

Decimal Precision (Important!)

Different currencies have different decimal precision requirements. The API rejects amounts with incorrect decimal places.

Standard Currencies (2 decimals)

Most currencies use 2 decimal places:

Currency	Valid	Invalid
USD, EUR, GBP, CAD, AUD, MXN	`"99.99"`	`"99.999"` ❌

Zero-Decimal Currencies (no decimals)

Some currencies don’t use decimal places at all:

Currency	Name	Valid	Invalid
`JPY`	Japanese Yen	`"1000"`	`"1000.00"` ❌
`KRW`	South Korean Won	`"50000"`	`"50000.50"` ❌
`VND`	Vietnamese Dong	`"100000"`	`"100000.00"` ❌
`BIF`	Burundian Franc	`"5000"`	`"5000.00"` ❌
`CLP`	Chilean Peso	`"10000"`	`"10000.00"` ❌
`GNF`	Guinean Franc	`"5000"`	`"5000.00"` ❌
`ISK`	Icelandic Króna	`"1500"`	`"1500.50"` ❌
`PYG`	Paraguayan Guaraní	`"50000"`	`"50000.00"` ❌
`RWF`	Rwandan Franc	`"5000"`	`"5000.00"` ❌
`UGX`	Ugandan Shilling	`"50000"`	`"50000.00"` ❌
`XAF`	Central African CFA Franc	`"5000"`	`"5000.00"` ❌
`XOF`	West African CFA Franc	`"5000"`	`"5000.00"` ❌

Three-Decimal Currencies (3 decimals)

Some Middle Eastern currencies use 3 decimal places:

Currency	Name	Valid	Invalid
`KWD`	Kuwaiti Dinar	`"5.500"`	`"5.5000"` ❌
`BHD`	Bahraini Dinar	`"10.250"`	`"10.25"` ❌
`OMR`	Omani Rial	`"25.000"`	`"25.0"` ❌
`IQD`	Iraqi Dinar	`"5.500"`	`"5.5"` ❌
`JOD`	Jordanian Dinar	`"5.500"`	`"5.5"` ❌
`LYD`	Libyan Dinar	`"5.500"`	`"5.5"` ❌
`TND`	Tunisian Dinar	`"5.500"`	`"5.5"` ❌

Error Response

If you provide incorrect decimal precision, the API returns:

{
  "success": false,
  "error": "Validation failed",
  "details": ["amount has 2 decimal places but JPY only allows 0"]
}

Best Practice

Always check the currency’s decimal requirements before creating a session:

Most currencies: use 2 decimals
JPY, KRW, VND and other zero-decimal currencies: use 0 decimals (whole numbers only)
KWD, BHD, OMR, IQD, JOD, LYD, TND: use 3 decimals

Currency on Success

When the customer completes payment, the currency is included in the success redirect:

https://mysite.com/success?transactionId=txn_123&amount=25.00&currency=GBP

You can parse this to display the correct currency symbol on your confirmation page.

Multi-Currency Tips

Let customers choose: Detect the customer’s location and default to their local currency
Display clearly: Show the currency code alongside the amount on your checkout button
Match expectations: If your product page shows prices in EUR, create the session in EUR

Getting Started

Vault

Payments

Supported Currencies

Usage

Amount Format

Decimal Precision (Important!)

Standard Currencies (2 decimals)

Zero-Decimal Currencies (no decimals)

Three-Decimal Currencies (3 decimals)

Error Response

Best Practice

Currency on Success

Multi-Currency Tips

​Supported Currencies

​Usage

​Amount Format

​Decimal Precision (Important!)

​Standard Currencies (2 decimals)

​Zero-Decimal Currencies (no decimals)

​Three-Decimal Currencies (3 decimals)

​Error Response

​Best Practice

​Currency on Success

​Multi-Currency Tips

Supported Currencies

Usage

Amount Format

Decimal Precision (Important!)

Standard Currencies (2 decimals)

Zero-Decimal Currencies (no decimals)

Three-Decimal Currencies (3 decimals)

Error Response

Best Practice

Currency on Success

Multi-Currency Tips