Zoey and X-Payments: Multi-Currency Configuration

From X-Payments Help
Jump to: navigation, search

A Zoey store working with X-Payments can be configured to accept payments in multiple currencies. For example, your store in the United States sells goods to the U.S. and Canada, and you want to be able to charge your American customers in United States dollars (USD) and your Canadian customers in Canadian dollars (CAD). You can achieve that by implementing the following configuration:

  1. In the Payment configurations section of X-Payments, set up two identical payment configurations for the two currencies you want to use. The payment configurations will need to have different names. For convenience, you may want to specify the currency names in the payment configuration titles so you will be able to see which payment configuration you are dealing with in each case without having to open the configuration details. (For example, " "Authorize.Net - USD" and " "Authorize.Net - CAD").
    XP paymentconfs list.png
  2. After having configured your Zoey store details in the Online Stores section, get your connection bundle (copy it to clipboard):
    Zoey connection bundle.png
  3. In your Zoey store Control Panel, navigate to Set-up > Payments.
    Zoey setup payment.png
    Choose to configure X-Payments.
    Zoey xpayments configure.png
  4. Click the "Configure X-Payments connector" button:
    Zoey configure xp connector.png
  5. Use the Configuration bundle from X-Payments to deploy the connection to X-Payments in your Zoey store Control Panel.
    Zoey connection1.png
  6. Make sure the deployment of the Configuration bundle has resulted in the import into your Zoey store of two payment methods based on the payment configurations you had configured in X-Payments. You should be able to see them on the list of Payment methods in your X-Payments Connector settings:
    Zoey 2paymentconfigurations imported.png
  7. After the import, both the payment methods are disabled. To enable them for your customers, you will need to activate them.
    Zoey enable confs.png
    Also make sure the 'Save card' option is set for both the methods the way you want it.
  8. For both the imported payment methods, specify the countries in which they should be available. Use the Payment from applicable countries setting:
    Zoey cad applicable countries.png
  9. Navigate to Setup -> Localization and choose to manage languages (Click Manage in the Manage Languages section).
    Zoey manage languages.png
  10. You probably already have English set as your store's default language for your U.S. customers who pay in USD. Now you need to add a second language for the customers who will buy goods using your other currency (CAD). Choose to Add New Language:
    Zoey manage languages1.png
    Select 'English (Canada)', provide a name and a code for it, and don't forget to enable it for your Zoey store.
    Zoey manage languages2.png
    The language will be added to the list:
    Zoey manage languages3.png
  11. Navigate to Setup -> Localization and choose to manage your store's currency settings (Click Manage in the Currency Settings section).
    Zoey manage currency.png
  12. Use the store switch in the top right-hand corner of the screen and set the following values:
    • Default config: enable CAD и USD in Allowed Currencies.
    • USA store: enable USD currency; the rest of the allowed currencies can be left as is, or you can keep just USD.
    • Canadian store: enable CAD currency, the rest of the allowed currencies can be left as is, or you can keep just CAD.
      Zoey manage currency1.png
  13. Navigate to Setup -> Localization and choose to manage your store's Rates (Click Manage in the Rates section).
    Zoey manage rates.png
  14. Click Import.
    Zoey manage rates1.png
  15. Click to save currency rates:
    Zoey manage rates2.png