If you are using Kustom Checkout for WooCommerce and want to sell to more countries than where your store is based and offer more currencies than your own, there are a few steps you need to take before you start to sell globally with Kustom Checkout. You should also be aware that additional agreements incur additional costs.
The example scenario
You’re running a webshop and you want to sell to different countries. In this example we say that the store is based in Sweden (which is within the EU), and you have the base currency set to SEK.
You know you want to target a few specific countries, some within the EU and some outside the EU, but also be able to accept orders from other countries than those you are specifically marketing yourself towards.
You want your customers to be able to pay in their own currency to the greatest extent possible.
What you need to do
Core countries
First of all you need to have an agreement with Kustom for the Core countries you wish to sell to.
Kustom Checkout is available in 229 countries, with over 10 considered Kustom core countries. A core country supports Kustom Credit, local non-risk payment methods, and card options.
A core country is only considered a core country if the currency is local for that market as well.
The current offered core countries in combination with their local currencies.
Kustom Checkout Global
The second thing you need to do is to have Kustom Checkout Global, or KCO Global, activated in your Kustom account. Otherwise customers from other countries than the store base country will see the bad value: currency error message instead of the Kustom Checkout iframe in the checkout. To completely avoid the risk of this error you need to have KCO Global activated for each country/currency for which you have an agreement with Kustom.
However, for KCO Global to work you need to look into how your SEK (or your currency) payouts from Kustom are made. If they are made through regular domestic bank transfers you may not be able to use Global Checkout for SEK (or your currency). For more details on payout requirements, contact Kustom directly – requirements may vary depending on your agreement.
Please note that there are additional fees when you have a Global Checkout agreement with Kustom and there might be additional fees connected to using IBAN as well. What these fees are you’ll find out by talking to Kustom and your bank.
Now, with KCO Global activated and the agreement in place for the Core countries you wish to sell to, you can now offer Kustom payment methods such as the popular “Buy now, pay later” to these countries. Customers from countries not included in the agreement, from non-core countries, or core countries combined with a non-local currency can make card payments.
In short; customers from your identified markets will have more payment options, but anyone can make a purchase.
For any questions you may have regarding your agreement with Kustom, you can visit the Kustom Merchant Support website.
Currency examples
A merchant has an agreement for SEK/Sweden and has KCO Global activated.
- A customer from Sweden will see all available payment methods in the checkout (invoice, part payment, card payment etc).
- A customer from Norway will only see card payment as the available payment option.
A merchant has an agreement for SEK/Sweden but does not have KCO Global activated.
- A customer from Sweden will see all available payment methods in the checkout (invoice, part payment, card payment etc).
- A customer from Norway will see an error message mentioning
bad value: currency.
A merchant has an agreement for SEK/Sweden with KCO Global activated AND Norway/NOK without KCO Global activated.
- A customer from Sweden (with SEK as the selected currency) will see all available payment methods in the checkout (invoice, part payment, card payment etc).
- A customer from Norway (with NOK as the selected currency) will see all available payment methods in the checkout (invoice, part payment, card payment etc).
- A customer from Norway (with SEK as the selected currency) will see card payment as the available payment option.
- A customer from Sweden (with NOK as the selected currency) will see an error message mentioning
bad value: currency.
Additional steps
Multi currency switcher
Earlier we also mentioned that you in this example want your customers to be able to pay in their own currency. For this you will need a multi currency switcher plugin and we recommend the Aelia Currency Switcher for WooCommerce.
Geolocate
Since you are selling worldwide you want your prices to be displayed with or without tax, depending on where the customer is located. In this example you are based within the EU and so other EU residents should see the price including tax and those outside of the EU without tax.
In the WooCommerce Settings > General options you can set which countries you want to sell and ship to. You also have the option to set the Default Customer Address where you can choose the location WooCommerce assume site visitors are in, before they enter it, to calculate tax and shipping.
If you want to sell to multiple countries you need to either use Geolocate or Geolocate (with page caching support).
Geolocate verifies the current location of the customer and calculate taxes accordingly.
Geolocate (with page caching support) is the same as above, but does the geolocation via Ajax. You may notice your website URLs have a ?v=xxxxx appended to them. This is normal to prevent static caching of prices.
After geolocation is enabled, you need to create a MaxMind account and finish configuring the MaxMind Geolocation in the Integration tab in the WooCommerce settings.
- Create a MaxMind Geolocation account
- Create a MaxMind License Key
- Add MaxMind Geolocation License Key to WooCommerce settings
- Go to: WooCommerce > Settings > Integration > MaxMind Geolocation
- Paste the license key
- Select “Save changes”
There is a more extensive step-by-step guide at the official WooCommerce documentation.
Now that WooCommerce can identify the country where the customer is located and will adjust the currency and price accordingly, this will help avoid the Kustom Checkout error message bad value: currency we mentioned earlier.
Using the plugin without KCO Global
In some cases, merchants only sell to one country and therefore have no need for a global agreement. For a step-by-step guide on how to configure WooCommerce to use Kustom Checkout without a global agreement, see the KCO Global documentation.
Using the plugin without KCO Global on a specific currency
In some cases you might have KCO Global activated for your store’s main currency, but not for the additional currencies. See the KCO Global documentation for a code example on how to handle this.
Why do I get the error?
We’ve already touched upon this and if you’ve read this far you should have a basic understanding of how to avoid the bad value: currency error message.
But to sum it up, the reason you get this error is because your account with Kustom is not set up to handle different currencies and countries and/or you do not have Kustom Checkout Global activated. The result of this being that Kustom Checkout does not recognize the purchase currency, hence the error.
If you have done these things and you still get the error, you need to look into how your WooCommerce store Geolocates your customers.


