Regions and currencies

Yes, you can sell in more than one currency at the same time: US dollars (USD) to American buyers, euros (EUR) to European ones, shekels (ILS) at home. Regions are how you do it.

A region binds a set of countries to a currency, a tax-display mode, and a list of payment providers. When a buyer arrives, Brainerce matches their country to a region and serves them that region's setup, so an American sees dollars and a German sees euros without you maintaining two stores.

If you sell in one country and one currency, you can ignore this page. If a payment method isn't showing at checkout, this page is almost always the reason.

How a region decides what a buyer sees

Three things follow from the buyer's region:

1. Currency is the currency their prices are shown and charged in.
2. Tax display sets whether prices are shown with tax included or added at checkout.
3. Payment providers decides which of your installed providers they can pay with.

A country belongs to one region only. Buyers whose country maps to no region fall back to your default region.

Everyone still sees my home currency

Setting up regions here is only half the job. Your website has to ask Brainerce which region the visitor is in, and pass that along with every price it looks up. A site that never asks is served your default region every single time, so a German customer sees shekels or dollars at your home prices.

This is the one setting on this page that fails without telling you. The page is not broken, no error appears, the layout is fine, and the prices are simply the wrong ones. Shops have run like this for months.

Check it now. If you have more than one region set up, look at your shop from a customer's point of view. If every visitor sees your home currency wherever they are, the wiring is missing. Your regions are configured correctly and the shop is ignoring them.

A one-region shop is not affected today, and is still worth wiring. The moment you add a second region, an unwired shop quietly serves it the wrong currency on the same afternoon you thought you had opened a new market.

Ask your developer, or your AI builder, for this:

"Detect the visitor's country, look up the matching Brainerce region, and pass the region on every product lookup and when creating the checkout. Add a currency switcher too."

The switcher matters. Guessing a country from someone's internet connection is wrong for travellers, expats and anyone on a VPN, so let people choose.

Pass the region to the checkout as well as the product pages. A shop that passes it to product pages only shows one price and charges a different one, which is worse than not having regions at all.

See a feature you turned on is not showing on your website.

Create a region

1. Go to Settings → Regions.
2. Click Add Region.
3. Give it a Name you'll recognise, such as "European Union", "Israel", or "Rest of world".
4. Pick the Currency: USD, EUR, GBP, ILS, or whichever you price in for those countries.
5. Add the countries that belong to it.
6. Under Payment Providers, enable the installed providers that should serve this region.
7. Choose whether Prices include tax in this region.
8. Save.

Why a provider isn't in the list

The Payment Providers section only offers providers compatible with the countries you selected. If it says "No installed payment providers are compatible with these countries", either you haven't installed a provider that covers them, or the countries in this region aren't served by the ones you have.

This is the thing people get wrong: a gateway being installed doesn't put it at checkout. It has to be enabled for the region the buyer is in.

Setting a price per region

By default, a buyer in another region sees your price converted at the current exchange rate. That is usually fine, but it produces prices like €91.37, and it means a currency swing moves your price without you deciding to.

If no exchange rate has been fetched yet for that currency pair, the buyer sees your store-currency price unchanged rather than a converted one, so a German buyer would see shekels, not euros. Nothing warns you when this happens, so if a newly added region is still showing your home currency, this is usually why. Setting a manual price for the region (below) sidesteps it entirely.

To set the price yourself, open a product and find Prices per Region in the editor. Pick a region and enter a Base price and, optionally, a Sale price for it. That region now charges exactly what you typed: €89.00, not €91.37.

• Your default region always uses the main Base / Sale prices at the top of the product. You only override the others.
• The products table shows Manual or Auto per region, so you can see at a glance which prices you set and which are still being converted.
• The Region filter on the products list narrows the table to one region while you work through a price list.
• A sale price must be lower than the base price for that region, and you cannot set a sale price without a base price.

A manual price only takes effect if the region actually charges in its own currency. That requires a payment provider enabled for the region that can charge that currency natively. If none is enabled, the buyer is charged in your store currency and sees a converted price, and your manual figure is ignored rather than applied. Check the region's Payment Providers list if a price you set isn't showing.

Manual prices replace the whole pair. A region with a manual base price will never show a converted sale price alongside it. You set both, or neither.

The default region

One region is marked Default. It catches every buyer whose country you haven't explicitly placed.

Set it deliberately. If your default is "European Union" and someone orders from Australia, they'll be charged in euros, which may or may not be what you want.

Tax display

Prices include tax shows tax-inclusive prices in that region, the norm in the EU, UK and Israel. Leave it off where tax is added at checkout, as in most of the US.

This is a display and calculation setting for the region; the rates themselves come from Settings → Tax.

Turning a region off

An Inactive region is hidden from storefronts. Use this to prepare a region before you launch it, or to stop selling somewhere without deleting the configuration.

Deleting a region is permanent.

What's next?

• Set up taxes covers the rates that apply within a region.
• Connect payment methods covers installing the providers you then enable here.