Developers

Multiple Currency Pricing (MCP)

Contents

Overview

Multiple-currency pricing (MCP) is a Nuvei service which allows you to display your site pricing (or product catalog) to customers in multiple customer currencies.

MCP allows you to sell the same item to British customers in Pounds Sterling, to French and German customers in Euros, and to Japanese customers in Yen.

With MCP, you can maintain your product catalog in your home currency, display your site pricing (or product catalog) in multiple customer currencies, allow your customer to check out using their home currency, while you continue receiving your transaction settlement and reporting in your home currency.

Sign up for the Nuvei MCP Service

Register for this optional service by contacting the Nuvei Integration Team. Registration includes selecting a set of MCP display currencies that your site will support, and setting the exchange rate markup and other fees for those currencies. These will be used in MCP currency conversion calculations.

Integrating the MCP Service

Follow the integration steps for the relevant Nuvei payment product:

Integrating MCP into the Nuvei Cashier or Checkout Page Products

If you use our Cashier or Checkout Page products, MCP is activated automatically at the end of the MCP registration process, without any further steps.

Switching Site Pricing using MCP Conversion Rates

As soon as a visitor enters your Cashier or Checkout Page, the system runs processes to identify their home currency. If it is one of your registered MCP currencies, then all the prices on the page will be converted and displayed in the visitor’s home currency.

Accepting Payment for a Sale using MCP Values

Follow this link for details of Accepting Payment for a Sale using MCP Values.

Integrating MCP into Nuvei Web SDK and REST API Workflows

MCP integration is relatively simple, because there are only a few additions to the existing payment workflows, as described below.

Switching Site Pricing using MCP Conversion Rates

In order to enhance your customer’s experience, you can switch the prices displayed on your site to match their home currency.

  1. As soon as a visitor enters your site, you will need to run processes to identify their home currency, based on some criteria, which is entirely up to you.
    For example:
    • You can identify their location based on their IP address, and then lookup the local currency.
    • If the visitor is a returning customer, you can use the /getCardDetails method.
    • You could prompt the visitor to select their preferred currency from a list of your MCP currencies.
  2. Next, use the /getMcpRates method to check if their home currency is one of your registered MCP currencies and retrieve the MCP currency conversion rate.

    Example /getMcpRates Request 
    {
    "sessionToken": "f27fc072-fe6a-4ee8-baa6-78329d815841",
    "merchantId": "479748173730597238",
    "merchantSiteId": "180083",
    "clientRequestId": "20201109080202",
    "timeStamp": "20201109080202",
    "checksum": "064921b6d6c9d9d8dcd8a7c141a1076c76269cf8a3758d6c9f2d979ebe4d9b71",
    "currency": "EUR",
    "clientUniqueId": "695701003",
    "fromCurrency": "EUR",
    "toCurrency": [
        "USD"
    ],
    "paymentMethods": [
        "cc_card"
    ]
}

    Example Response

    {
    "reason": "",
    "merchantId": "2502136204546424962",
    "clientUniqueId": "695701003",
    "errCode": 0,
    "clientRequestId": "YWSWQUTBV",
    "rates": [
        {
            "ratesByCurrencies": [
                {
                    "rate": "1.195345",
                    "currency": "USD"
                }
            ],
            "paymentMethod": "cc_card"
        }
    ],
    "sessionToken": "616beb03-df6a-43d6-abef-fbc081c93e08",
    "internalRequestId": 14776101,
    "mcpTimestamp": "Mon Oct 26 14:53:30 EET 2020",
    "version": "1.0",
    "status": "SUCCESS",
    "merchantSiteId": "126006"
}
  3. Use the  MCP currency conversionrate to convert all the prices displayed on your site into the visitor’s home currency.
    Note: The MCP currency conversion rate has the exchange rate markup and fees built in to it.
Accepting Payment for a Sale using MCP Values

Follow this link for details of Accepting Payment for a Sale using MCP Values.

Back