Multi-currency Mijireh gateway is designed to work together with the Currency Switcher plugin and extends the existing WooCommerce Mijireh gateway by adding support for multiple currencies. The plugin works by adding multiple Mijireh gateways to WooCommerce (one for each of the enabled currencies).
Why adding multiple Mijireh gateways to WooCommerce?
Mijireh remote gateway works by configuring one currency for each store. Even though the underlying payment processor (e.g. Stripe, Paymill, etc) can support multiple currencies, the Mijireh portal asks to choose one currency to be sent to it. Subsequently, every order received by that store will be assumed to be in the configured currency. That is, if a Mijireh store is set to use USD, then any amount sent to it will be interpreted as USD.
The solution to this is fairly simple: create multiple Mijireh stores (one for each of the currency you would like to accept through Mijireh) and get an Access Key for each one. Use the Access Keys to configure the Multi-currency gateway in WooCommerce, and you are ready to go. You can find more details below.
How to install and configure the Multi-currency Mijireh gateway
In the following example, we show how to install and configure the Multi-currency Mijireh plugin. We assume that our website will accept US Dollars (USD) and Euro (EUR) and that both of them should be accepted through Mijireh.
1. Install and activate the plugin
Upload the Multi-currency Mijireh plugin to your site and enabled it like you would do with any other. Ensure that the plugin is activated correctly.
2. Review available payment gateways
Open the Admin section of your site and go to WooCommerce > Settings, then click on Payment Gateways (WooCommerce 2.0.x) or Checkout (WooCommerce 2.1.x and later). You should now see multiple Mijireh gateways available, with each one indicating for which currency it will be used, as in the following screenshot.
3. Create a Mijireh store for each currency and save its Access Key in WooCommerce
Open your Mijireh account and go to the dashboard. You should see your main store (called USD store in the screenshot below):
We will use this store to accept payments in USD, then enter the Access Key (highlighted) in the Mijireh (USD) gateway in WooCommerce. Mijireh will now be set to accept payments in USD through this gateway. Important: ensure that you have selected a payment processor for the store (refer to Mijireh documentation to see the available ones).
We will now configure a new store to accept Euro. We click on the Store link at the top left of the page:
Then, in the next page, on the +Store button.
In the field that will appear, we will type "EUR Store", to highlight the fact that the store will accept payments in Euro:
We will then choose a payment gateway (in our example, Stripe) and set it to EUR. This will make the store accept payments in Euro:
The store now show EUR as the store currency:
We will now enter the EUR Store Access Key in the settings for Mijireh EUR gateway in WooCommerce.
4. (Optional) Configure more currencies
Following the instructions on step 3, add as many Mijireh stores as you need and configure each specific Mijireh gateway with the Access Key from the corresponding store.
5. Ensure that the Currency Switcher is configured to display the Multi-currency Mijireh gateway
The Currency Switcher filters the gateways by currency, to ensure that only the supported payment methods are available for each currency. To make sure that each Mijireh gateway is displayed correctly on checkout, go to WooCommerce > Currency Switcher Options and ensure that each gateway appears next to the currency:
Installation and configuration is now completed
To test it, place some products in the basket and go to the checkout page. You should now see the Mijireh gateway you configured appearing amongst the available payment options (screenshot below displays the Mijireh gateway to be used for payments in Euro):
6. (Optional) Slurp checkout pages for each Mijireh store
You can find the instructions to perform the page slurp in the related article: How to perform the page slurp for the additional Mijireh stores.