Currency and precision definitions

When SHOPLINE exchanges data with payment apps, the definitions of currency and precision must comply with the rules in the following table (which adheres to the ISO 4217 international standard).

Note:

The parameter passing rule for the amount is associated with the currency precision. Pass the amount in its smallest currency unit without decimals.
Examples:

For 1 JPY: Given the currency precision of JPY is integer and the amount passing rule is ×1, the value passed to the API is 1.
For 1.23 USD: Given the currency precision of USD is two decimal places and the amount passing rule is ×100, the value passed to the API is 123.
For 1.234 BHD: Given the currency precision of BHD is three decimal places and the amount passing rule is ×1000 (SHOPLINE does not support amount processing with a precision higher than two decimal places), the last digit of the passed value must be 0, and the value passed to the API is 1230.

Country or region	Currency name	Currency code	Precision	Minimum transaction amount	Amount parameter transmission rule
United Arab Emirates	UAE Dirham	AED	2 decimal places	0.1	x100
Afghanistan	Afghan Afghani	AFN	2 decimal places	0.1	x100
Armenia	Armenian Dram	AMD	2 decimal places	0.1	x100
Curaçao and Sint Maarten	Netherlands Antillean Guilder	ANG	2 decimal places	0.1	x100
Angola	Kwanza	AOA	2 decimal places	0.1	x100
Argentina	Argentine Peso	ARS	2 decimal places	0.1	x100
Australia	Australian Dollar	AUD	2 decimal places	0.1	x100
Aruba	Aruban Florin	AWG	2 decimal places	0.1	x100
Azerbaijan	Azerbaijani Manat	AZN	2 decimal places	0.1	x100
Albania	Lek	ALL	2 decimal places	0.1	x100
Bosnia and Herzegovina	Convertible Marks	BAM	2 decimal places	0.1	x100
Barbados	Barbados Dollar	BBD	2 decimal places	0.1	x100
People's Republic of Bangladesh	Taka	BDT	2 decimal places	0.1	x100
Bulgaria	Bulgarian Lev	BGN	2 decimal places	0.1	x100
Bahrain	Bahraini Dinar	BHD	3 decimal places	0.1	Multiply by 1000, and the last digit must be zero.
Burundi	Burundi Franc	BIF	Integer	1	x1
Bermuda	Bermudian Dollar	BMD	2 decimal places	0.1	x100
Brunei	Brunei Dollar	BND	2 decimal places	0.1	x100
Bolivia	Boliviano	BOB	2 decimal places	0.1	x100
Brazil	Brazilian Real	BRL	2 decimal places	0.1	x100
Bahamas	Bahamian Dollar	BSD	2 decimal places	0.1	x100
Kingdom of Bhutan	Ngultrum	BTN	2 decimal places	0.1	x100
Botswana	Pula	BWP	2 decimal places	0.1	x100
Belarus	Belarusian Ruble	BYN	2 decimal places	0.1	x100
Belize	Belize Dollar	BZD	2 decimal places	0.1	x100
Canada	Canadian Dollar	CAD	2 decimal places	0.1	x100
Democratic Republic of the Congo	Congolese Franc	CDF	2 decimal places	0.1	x100
Switzerland and Liechtenstein	Swiss Franc	CHF	2 decimal places	0.1	x100
Chile	Unidad de Fomento	CLF	Integer	1	x1
Chile	Chilean Peso	CLP	2 decimal places	0.1	x100
People's Republic of China	Yuan Renminbi	CNY	2 decimal places	0.1	x100
Colombia	Colombian Peso	COP	2 decimal places	0.1	x100
Costa Rica	Costa Rican Colon	CRC	2 decimal places	0.1	x100
Cuba	Cuban Peso	CUP	2 decimal places	0.1	x100
Cape Verde	Cape Verde Escudo	CVE	2 decimal places	0.1	x100
Czech Republic	Czech Koruna	CZK	2 decimal places	0.1	x100
Djibouti	Djibouti Franc	DJF	Integer	1	x1
Denmark	Danish Krone	DKK	2 decimal places	0.1	x100
Dominican Republic	Dominican Peso	DOP	2 decimal places	0.1	x100
Algeria	Algerian Dinar	DZD	2 decimal places	0.1	x100
Estonia	Kroon	EEK	2 decimal places	0.1	x100
Egypt	Egyptian Pound	EGP	2 decimal places	0.1	x100
Eritrea	Nakfa	ERN	2 decimal places	0.1	x100
Ethiopia	Ethiopian Birr	ETB	2 decimal places	0.1	x100
Eurozone	Euro	EUR	2 decimal places	0.1	x100
Fiji	Fiji Dollar	FJD	2 decimal places	0.1	x100
Falkland Islands	Falkland Islands Pound	FKP	2 decimal places	0.1	x100
United Kingdom, Jersey, Guernsey, the Isle of Man, South Georgia and the South Sandwich Islands, the British Antarctic Territory, Tristan da Cunha	Pound Sterling	GBP	2 decimal places	0.1	x100
Georgia	Lari	GEL	2 decimal places	0.1	x100
Ghana	Cedi	GHS	2 decimal places	0.1	x100
Gibraltar	Gibraltar Pound	GIP	2 decimal places	0.1	x100
Gambia	Dalasi	GMD	2 decimal places	0.1	x100
Guinea	Guinea Franc	GNF	Integer	1	x1
Guatemala	Quetzal	GTQ	2 decimal places	0.1	x100
Guyana	Guyana Dollar	GYD	2 decimal places	0.1	x100
Hong Kong	Hong Kong Dollar	HKD	2 decimal places	0.1	x100
Honduras	Lempira	HNL	2 decimal places	0.1	x100
Croatia	Croatian Kuna	HRK	2 decimal places	0.1	x100
Haiti	Gourde	HTG	2 decimal places	0.1	x100
Hungary	Forint	HUF	2 decimal places	0.1	x100
Indonesia	Rupiah	IDR	2 decimal places	0.1	x100
Israel	New Israeli Sheqel	ILS	2 decimal places	0.1	x100
India	Indian Rupee	INR	2 decimal places	0.1	x100
Iraq	Iraqi Dinar	IQD	3 decimal places	0.1	Multiply by 1000, and the last digit must be zero.
Iran	Iranian Rial	IRR	2 decimal places	0.1	x100
Jamaica	Jamaican Dollar	JMD	2 decimal places	0.1	x100
Jordan	Jordanian Dinar	JOD	3 decimal places	0.1	Multiply by 1000, and the last digit must be zero.
Japan	Yen	JPY	Integer	1	x1
Kenya	Kenyan Shilling	KES	2 decimal places	0.1	x100
Kyrgyz Republic	Som	KGS	2 decimal places	0.1	x100
Cambodia	Riel	KHR	2 decimal places	0.1	x100
Comoros	Comoro Franc	KMF	Integer	1	x1
North Korea	North Korean Won	KPW	2 decimal places	0.1	x100
South Korea	Won	KRW	Integer	1	x1
Kuwait	Kuwaiti Dinar	KWD	3 decimal places	0.1	Multiply by 1000, and the last digit must be zero.
Cayman Islands	Cayman Islands Dollar	KYD	2 decimal places	0.1	x100
Kazakhstan	Tenge	KZT	2 decimal places	0.1	x100
Laos	Kip	LAK	2 decimal places	0.1	x100
Lebanon	Lebanese Pound	LBP	2 decimal places	0.1	x100
Sri Lanka	Sri Lanka Rupee	LKR	2 decimal places	0.1	x100
Liberia	Liberian Dollar	LRD	2 decimal places	0.1	x100
Lesotho	Loti	LSL	2 decimal places	0.1	x100
Lithuania	Lithuanian Litas	LTL	2 decimal places	0.1	x100
Latvia	Latvian Lats	LVL	2 decimal places	0.1	x100
Libya	Libyan Dinar	LYD	3 decimal places	0.1	Multiply by 1000, and the last digit must be zero.
Morocco	Moroccan Dirham	MAD	2 decimal places	0.1	x100
Moldova	Moldovan Leu	MDL	2 decimal places	0.1	x100
Madagascar	Malagasy Ariary	MGA	2 decimal places	0.1	x100
North Macedonia	Denar	MKD	2 decimal places	0.1	x100
Myanmar	Kyat	MMK	2 decimal places	0.1	x100
Mongolia	Tugrik	MNT	2 decimal places	0.1	x100
Macau	Pataca	MOP	2 decimal places	0.1	x100
Mauritania	Ouguiya	MRU	2 decimal places	0.1	x100
Mauritius	Mauritius Rupee	MUR	2 decimal places	0.1	x100
Maldives	Rufiyaa	MVR	2 decimal places	0.1	x100
Malawi	Kwacha	MWK	2 decimal places	0.1	x100
Mexico	Mexican Peso	MXN	2 decimal places	0.1	x100
Mexico	Mexican Unidad de Inversion	MXV	2 decimal places	0.1	x100
Malaysia	Malaysian Ringgit	MYR	2 decimal places	0.1	x100
Mozambique	Metical	MZN	2 decimal places	0.1	x100
Namibia	Namibia Dollar	NAD	2 decimal places	0.1	x100
Nigeria	Naira	NGN	2 decimal places	0.1	x100
Nicaragua	Cordoba Oro	NIO	2 decimal places	0.1	x100
Norway	Norwegian Krone	NOK	2 decimal places	0.1	x100
Nepal	Nepalese Rupee	NPR	2 decimal places	0.1	x100
New Zealand	New Zealand Dollar	NZD	2 decimal places	0.1	x100
Oman	Rial Omani	OMR	3 decimal places	0.1	Multiply by 1000, and the last digit must be zero.
Panama	Balboa	PAB	2 decimal places	0.1	x100
Peru	Nuevo Sol	PEN	2 decimal places	0.1	x100
Papua New Guinea	Kina	PGK	2 decimal places	0.1	x100
Philippines	Philippine Peso	PHP	2 decimal places	0.1	x100
Pakistan	Pakistan Rupee	PKR	2 decimal places	0.1	x100
Poland	Zloty	PLN	2 decimal places	0.1	x100
Paraguay	Guarani	PYG	Integer	1	x1
State of Qatar	Qatari Rial	QAR	2 decimal places	0.1	x100
Romania	New Leu	RON	2 decimal places	0.1	x100
Serbia	New Serbian Dinar	RSD	2 decimal places	0.1	x100
Russia	Russian Ruble	RUB	2 decimal places	0.1	x100
Rwanda	Rwanda Franc	RWF	Integer	1	x1
Saudi Arabia	Saudi Riyal	SAR	2 decimal places	0.1	x100
Solomon Islands	Solomon Islands Dollar	SBD	2 decimal places	0.1	x100
Seychelles	Seychelles Rupee	SCR	2 decimal places	0.1	x100
Republic of the Sudan	New Sudanese Pound	SDG	2 decimal places	0.1	x100
Republic of South Sudan	South Sudanese pound	SSP	2 decimal places	0.1	x100
Sweden	Swedish Krona	SEK	2 decimal places	0.1	x100
Singapore	Singapore Dollar	SGD	2 decimal places	0.1	x100
Saint Helena and Ascension	Saint Helena Pound	SHP	2 decimal places	0.1	x100
Sierra Leone	Leone	SLL	2 decimal places	0.1	x100
Suriname	Surinamese Dollar	SRD	2 decimal places	0.1	x100
São Tomé and Príncipe	Dobra	STN	2 decimal places	0.1	x100
El Salvador	El Salvador Colon	SVC	2 decimal places	0.1	x100
Syria	Syrian Pound	SYP	2 decimal places	0.1	x100
Eswatini	Lilangeni	SZL	2 decimal places	0.1	x100
Thailand	Baht	THB	2 decimal places	0.1	x100
Tajikistan	Somoni	TJS	2 decimal places	0.1	x100
Turkmenistan	Manat	TMT	2 decimal places	0.1	x100
Tunisia	Tunisian Dinar	TND	3 decimal places	0.1	Multiply by 1000, and the last digit must be zero.
Tonga	Paanga	TOP	2 decimal places	0.1	x100
Turkey	Turkish Lira	TRY	2 decimal places	0.1	x100
Trinidad and Tobago	Trinidad and Tobago Dollar	TTD	2 decimal places	0.1	x100
Taiwan, China	New Taiwan Dollar	TWD	2 decimal places	0.1	x100
Tanzania	Tanzanian Shilling	TZS	2 decimal places	0.1	x100
Ukraine	Hryvnia	UAH	2 decimal places	0.1	x100
Uganda	Uganda Shilling	UGX	Integer	1	x1
United States	US Dollar	USD	2 decimal places	0.1	x100
Uruguay	Peso Uruguayo	UYU	2 decimal places	0.1	x100
Uzbekistan	Uzbekistan Sum	UZS	2 decimal places	0.1	x100
Bolivar	Bolivar Fuerte	VES	2 decimal places	0.1	x100
Vietnam	Dong	VND	Integer	1	x1
Vanuatu	Vatu	VUV	Integer	1	x1
Samoa	Tala	WST	2 decimal places	0.1	x100
Cameroon, Central African Republic, Chad, Republic of the Congo, Equatorial Guinea, Gabon	CFA Franc BEAC	XAF	Integer	1	x1
East Caribbean	East Caribbean Dollar	XCD	2 decimal places	0.1	x100
Benin, Burkina Faso, Guinea-Bissau, Ivory Coast, Mali, Niger, Senegal, Togo	CFA Franc BCEAO	XOF	Integer	1	x1
French Polynesia, New Caledonia, Wallis and Futuna	CFP Franc	XPF	Integer	1	x1
Yemen	Yemeni Rial	YER	2 decimal places	0.1	x100
South Africa	Rand	ZAR	2 decimal places	0.1	x100
Zambia	Zambian Kwacha	ZMW	2 decimal places	0.1	x100
Zimbabwe	Zimbabwe Dollar	ZWL	2 decimal places	0.1	x100

Was this article helpful to you?

SHOPLINE

Legal

Currency and precision definitions​

Currency and precision definitions