Skip to main content
How currency works

Learn how to display prices and process payments in the currency of your choice.

Thomas Rocca avatar
Written by Thomas Rocca
Updated over a month ago

You can choose the currency used in your marketplace. The chosen currency symbol displays in your marketplace wherever prices are shown or referenced. If you are using the built-in Stripe payment integration, your marketplace currency is the currency in which payments are processed.

Important: If you change your marketplace currency, old listings retain the old currency and must be closed or updated. Read more in this section below.

How to configure the marketplace currency

You can set your marketplace currency in Console > Build > General > Localization.

Supported currencies

With online payments

You can can select any of the following currencies and use it for transactions with online payments:

  • AUD, Australian dollar

  • BGN, Bulgarian lev

  • CAD, Canadian dollar

  • CHF, Swiss franc

  • CZK, Czech koruna

  • DKK, Danish krone

  • EUR, Euro

  • GBP, British pound

  • HKD, Hong Kong dollar

  • JPY, Japanese yen

  • MXN, Mexican peso

  • NOK, Norwegian krone

  • NZD, New Zealand dollar

  • PLN, Polish złoty

  • RON, Romanian leu

  • SEK, Swedish krona

  • SGD, Singapore dollar

  • USD, United States dollar

Without online payments

If you are not processing online payments on your marketplace (and instead rely on free messaging), you can use any of the following currencies:

  • AED, United Arab Emirates dirham

  • AFN, Afghan afghani

  • ALL, Albanian lek

  • AMD, Armenian dram

  • ANG, Netherlands Antillean guilder

  • AOA, Angolan kwanza

  • ARS, Argentine peso

  • AWG, Aruban florin

  • AZN, Azerbaijani manat

  • BAM, Bosnia and Herzegovina convertible mark

  • BBD, Barbadian dollar

  • BDT, Bangladeshi taka

  • BIF, Burundian franc

  • BMD, Bermudian dollar

  • BND, Brunei dollar

  • BOB, Bolivian boliviano

  • BRL, Brazilian real

  • BSD, Bahamian dollar

  • BTN, Bhutanese ngultrum

  • BWP, Botswana pula

  • BYN, Belarusian ruble

  • BZD, Belize dollar

  • CDF, Congolese franc

  • CLP, Chilean peso

  • CNY, Renminbi

  • COP, Colombian peso

  • CRC, Costa Rican colón

  • CUP, Cuban peso

  • CVE, Cape Verdean escudo

  • DJF, Djiboutian franc

  • DOP, Dominican peso

  • DZD, Algerian dinar

  • EGP, Egyptian pound

  • ERN, Eritrean nakfa

  • ETB, Ethiopian birr

  • FJD, Fijian dollar

  • FKP, Falkland Islands pound

  • GEL, Georgian lari

  • GHS, Ghanaian cedi

  • GIP, Gibraltar pound

  • GMD, Gambian dalasi

  • GNF, Guinean franc

  • GTQ, Guatemalan quetzal

  • GYD, Guyanese dollar

  • HNL, Honduran lempira

  • HTG, Haitian gourde

  • HUF, Hungarian forint

  • IDR, Indonesian rupiah

  • ILS, Israeli new shekel

  • INR, Indian rupee

  • IRR, Iranian rial

  • ISK, Icelandic króna

  • JMD, Jamaican dollar

  • JOD, Jordanian dinar

  • KES, Kenyan shilling

  • KGS, Kyrgyz som

  • KHR, Cambodian riel

  • KMF, Comorian franc

  • KPW, North Korean won

  • KRW, South Korean won

  • KYD, Cayman Islands dollar

  • KZT, Kazakhstani tenge

  • LAK, Lao kip

  • LBP, Lebanese pound

  • LKR, Sri Lankan rupee

  • LRD, Liberian dollar

  • LSL, Lesotho loti

  • MAD, Moroccan dirham

  • MDL, Moldovan leu

  • MKD, Macedonian denar

  • MMK, Burmese kyat

  • MNT, Mongolian tögrög

  • MOP, Macanese pataca

  • MUR, Mauritian rupee

  • MVR, Maldivian rufiyaa

  • MWK, Malawian kwacha

  • MYR, Malaysian ringgit

  • MZN, Mozambican metical

  • NAD, Namibian dollar

  • NGN, Nigerian naira

  • NIO, Nicaraguan córdoba

  • NPR, Nepalese rupee

  • PAB, Panamanian balboa

  • PEN, Peruvian sol

  • PGK, Papua New Guinean kina

  • PHP, Philippine peso

  • PKR, Pakistani rupee

  • PYG, Paraguayan guaraní

  • QAR, Qatari riyal

  • RSD, Serbian dinar

  • RUB, Russian ruble

  • RWF, Rwandan franc

  • SAR, Saudi riyal

  • SBD, Solomon Islands dollar

  • SCR, Seychellois rupee

  • SDG, Sudanese pound

  • SHP, Saint Helena pound

  • SLE, Sierra Leonean leone

  • SOS, Somali shilling

  • SRD, Surinamese dollar

  • SSP, South Sudanese pound

  • STN, São Tomé and Príncipe dobra

  • SYP, Syrian pound

  • SZL, Swazi lilangeni

  • THB, Thai baht

  • TJS, Tajikistani somoni

  • TMT, Turkmenistani manat

  • TOP, Tongan paʻanga

  • TRY, Turkish lira

  • TTD, Trinidad and Tobago dollar

  • TWD, New Taiwan dollar

  • TZS, Tanzanian shilling

  • UAH, Ukrainian hryvnia

  • UGX, Ugandan shilling

  • UYU, Uruguayan peso

  • UZS, Uzbekistani sum

  • VED, Venezuelan digital bolívar

  • VES, Venezuelan sovereign bolívar

  • VND, Vietnamese đồng

  • VUV, Vanuatu vatu

  • WST, Samoan tālā

  • XAF, Central African CFA franc

  • XCD, Eastern Caribbean dollar

  • XOF, West African CFA franc

  • XPF, CFP franc

  • YER, Yemeni rial

  • ZAR, South African rand

  • ZMW, Zambian kwacha

How currency works, in detail

Your selected currency is assigned to prices on your marketplace. This shows to your users as the currency symbol displayed with the price.

Under the hood, currency is assigned to a listing is created. This means that currency is stored as a listing data attribute in much the same way price or the title is stored as a listing attribute. The currency attribute of the listing is then referenced whenever listing price is used, such as during search.

During a paid transaction using the built-in Stripe payment system, Stripe uses the currency attribute stored to the listing (typically the marketplace currency) to create the charge. If the charge currency differs from the customer’s credit card currency, the customer may be charged a foreign exchange fee by their credit card company.

When funds are paid out from your Stripe account, they are paid out in the currency of the receiving bank account. The receiving bank account will either be your bank account connected to your Stripe admin account or the provider's bank account that they added with their payout details. If the receiving account uses a different currency then the marketplace currency, Stripe will convert funds held in your Stripe account before paying them out to the receiving bank account.

Any associated fees from currency conversions during payouts are paid for by your admin Stripe account. The fees are deducted from your earnings. Therefore, it is a good idea to make your marketplace currency match the predominant currency of your providers.

You can learn more about how the Stripe payment system works for payment, payouts, and holding funds starting from this article.

Steps to change the marketplace currency and adjust existing listings

Changing your marketplace currency requires several steps. The first step is changing your currency in Console. The second is updating any listings created before the change to the new currency.

Changing your currency in Console means that any subsequent listing created in your marketplace will be assigned the new currency. Listings created after the currency change will therefore take the new currency symbol. Purchases made through Stripe will use the new currency during payment processing.

Changing your currency in Console does not change the currency of listings that already exist in your marketplace. These listings, which now have an outdated currency, can no longer be purchased because their currency attribute does not match your marketplace currency. Payments will not work on these listings.

Therefore, listings with an outdated currency should be closed by the provider or by the marketplace operator. Providers (or operators logged in as the provider) should re-create these listings through the marketplace website in order to assign the new listing attribute.

If you are changing your currency in your Live environment and your marketplace has many listings that would need to be re-created, then please contact our support team to discuss possible solutions. You can reach us any time using the chat widget in the bottom right corner of your Console.

How to create a marketplace with multiple currencies

Your marketplace supports payments in any currency that Stripe supports, which is over 100 currencies. However, you can only display prices in the currencies listed above. Moreover, you can only use a single currency symbol in your marketplace at any one time.

If you would like to use a different currency symbol or if you would like to display multiple currencies in your marketplace, then you will need to customize your marketplace with code. Custom development enables features like letting customers choose what currency they see and converting prices across different currencies.

Did this answer your question?