How to set up currency in FTW
Flex Template for Web (FTW) uses USD as the default currency. This guide will help you to change currency and edit other configurations related to it.
At the moment FTW uses Stripe as the only payment provider so before changing the currency, make sure it's supported in Stripe. See the Stripe documentation for supported currencies.
REACT_APP_SHARETRIBE_MARKETPLACE_CURRENCY is used
for the currency. For local development you can add the variable in the
.env file in the project root:
You can also change the configuration with the command line tool by running
yarn run config
Remember to restart the application after editing the environment variable!
Note: If you already created listings before changing the currency, listings using old currency will not show the price when a new currency is in use. Currently, FTW doesn't support changing the currency of the listing so the price cannot be edited after the currency used in the application is changed.
config.js file, search for variable
listingMinimumPriceSubUnits and give a minimum price in currency's
subunits (e.g. cents). By default, FTW uses value 0 which means there is
no restriction to the price but we recommend that the listing minimum
price should be at least the same amount as
in the country you are operating. If the listing price is lower, Stripe
will not process the payment and the booking fails.
file and make sure the currency is added to the
Most common currencies are already added to the file. If the currency is
(e.g. JPY) use value 1. Otherwise, the value is usually 100.
All API requests to Stripe expects amounts to be provided in a currency’s smallest unit. It's also better to calculate using integers than floats to avoid rounding errors.
Formatting money is done by using
React Intl. Component
FieldCurrencyInput converts user input to a formatted message and adds
the Money object to price attribute of a listing.
file affects how prices are formatted by determining how the subunits
are converted to the actual unit (e.g. from cents to USD).
If you need to calculate the price on client app side use
Decimal.js library. Currently,
there is one place in FTW where prices are calculated:
BookingDatesForm. See the file
to see how the Decimal.js library is used.
If you just started, you likely have a few demo Saunatime listings in your Console. These listings use EUR as their currency. Configuring a currency different than EUR will result in an error as the FTW cannot convert the currency of existing listings. You can ignore this error by closing these listings in your Console, which will remove them from the search page as well, and creating new listings.