Multiple Currency Pricing (MCP)

On this page:

Overview

The Nuvei Multiple-currency pricing (MCP) service enhances your customer’s payment experience, by allowing you to convert all the prices displayed on your site into the visitor’s home currency, and accept payment in that currency.  You can sell the same item to British customers in Pounds Sterling, to French and German customers in Euros, and to Japanese customers in Yen.

That’s not all:

  • You get to keep your product catalog in your home currency.
  • Price your goods in multiple customer currencies.
  • Let your customer pay in their home currency.
  • While, receiving your transaction settlements and reporting in your home currency.

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

Follow the steps below to display MCP pricing on your site and begin accepting payments.

For Cashier and Checkout Page

MCP is automatically activated in the Cashier and Checkout Page products, at the end of the MCP registration process, without any further steps.

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 are converted and displayed in the visitor’s home currency.

When the customer clicks the “Pay” button on the payment page, the system automatically initiates a regular payment request, sending the “checkout” amount (in the customer’s home currency) as the transaction amount, and the MCP currency as the transaction currency.

If the MCP payment is successful, then the customer is charged for the converted MCP amount in their home currency. (The MCP amount includes the additional exchange markup and other fees, (which were “built into” the item prices). These fees are not shown as separate values anywhere in the transaction.)

In due course, you (as the merchant) receive the payout for the transaction in your home currency.

For Web SDK and REST API

Integrating MCP into the Web SDK and REST API payment flows is relatively simple, because there are only a few additional steps, as described below.

1. Retrieving the MCP Rates

Nuvei updates all currency exchange rates at scheduled intervals, (currently once per day).

Use the /getMcpRates method to retrieve all the latest MCP currency conversion rates for the currencies that you support, (as specified in your MCP agreement with Nuvei).

The following example retrieves MCP details for only one toCurrency. A more typical scenario would be to list all your MCP currencies in the toCurrency array.

Example /getMcpRates Request 
{
  "sessionToken":"f27fc072-fe6a-4ee8-baa6-78329d815841",
  "merchantId":"<merchantId>",
  "merchantSiteId":"<merchantSiteId>",
  "clientRequestId":"20201109080202",
  "clientUniqueId":"695701003",
  "fromCurrency":"EUR",
  "toCurrency":[
    "USD"
  ],
  "paymentMethods":[
    "cc_card"
  ]
}
Example /getMcpRates Response 
{
  "reason":"",
  "merchantId":"<merchantId>",
  "merchantSiteId":"<merchantSiteId>",
  "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"
}

2. Converting your Site Pricing

Identify the visitor’s home currency, and display all the prices on your site to that visitor in their home currency.

  1. As soon as a visitor enters your site, you 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.
    • You could prompt the visitor to select their preferred currency from a list of your MCP currencies.
  2. If the visitor’s home currency is one of your registered MCP currencies, then retrieve the MCP currency conversion rate from the response to your scheduled /getMcpRates request for that specific currency.
  3. Use the MCP currency conversionrate to convert all the prices displayed on your site into your visitor’s home currency.

    The MCP currency conversion rate has the exchange rate markup and fees built into it.

3. Accepting Payment

When the customer clicks the “Pay” button (or equivalent) on the payment page, send a regular in the /payment request (or for Web SDK /openOrder) request, using:

  • The “checkout” amount (in the customer’s home currency) as the transaction amount.
  • The MCP currency as the transaction currency.
  • Include a currencyConversion block:
    Example currencyConversion Block 
    "currencyConversion": {
    "type": "MCP",
    "originalAmount": "15",
    "originalCurrency": "GBP"
}

The following /payment request example sends an MCP payment in EUR:

Example /payment Request 
{
    "sessionToken": "<received from getSessionToken>",
    "merchantId": "<your merchantId>",
    "merchantSiteId": "<your merchantSiteId>",
    "clientRequestId": "1C6CT7V1L",
    "timeStamp": "20201109064556",
    "checksum": "0cd18d8f9dad22ea33ec23d9fd0be45290685d4b27fe3aed3bfe6ec3ba39d551",
    "amount": "18.551085208425",
    "clientUniqueId": "695701003",
    "currency": "EUR",
    "paymentOption": {
        "alternativePaymentMethod": {
            "paymentMethod": "apmgw_Neteller",
            "nettelerAccount": "453313818311",
            "nettelerSecureId": "173419"
        }
    },
    "currencyConversion": {
        "type": "MCP",
        "originalAmount": "15",
        "originalCurrency": "GBP"
    },
    "billingAddress": {
        "email": "asdsad@asd.com",
        "country": "DE"
    },
    "deviceDetails": {
        "ipAddress": "192.168.2.38"
    },
    "urlDetails": {
        "successUrl": "https://srv-bsf-devppptrunk/ppp/defaultSuccess.do",
        "pendingUrl": "https://srv-bsf-devppptrunk/ppp/defaultPending.do",
        "failureUrl": "https://srv-bsf-devppptrunk/ppp/defaultCancel.do",
        "notificationUrl": "https://srv-bsf-devppptrunk/ppptest/NotifyMerchantTest"
    }
}
  • It is recommended to include a currencyConversion block in the payment request, because the request is processed as a Conversion on “Payment” request. It such a case, all the MCP currency conversions for the transaction are performed at the “time of payment” (when the customer clicks the “Pay” button), using the ruling exchange rate.
  • If for some reason you do not include a currencyConversion block, then the request is processed as a Conversion on “Settlement” request, where two different MCP currency conversions are performed for the transaction:
    • The currency conversion for the customer’s payment is performed at the “time of payment” (when the customer clicks the “Pay” button), using the ruling exchange rate.
    • The currency conversion for the merchant’s settlement payout is performed at the “time of settlement” (when the issuer pays out the merchant), using the ruling exchange rate.

4. Handling the Result

When the Nuvei gateway receives your MCP /payment request (or for Web SDK /openOrder), before processing it, it first validates that the MCP amount that you calculated falls within an acceptable “tolerate”, to accommodate small discrepancies caused by rounding and exchange rate variances.

If the MCP payment is successful, then the customer is charged for the converted MCP amount in their home currency. (The MCP amount includes the additional exchange markup and other fees, (which were “built into” the item prices). These fees are not shown as separate values anywhere in the transaction.)

In due course, you (as the merchant) receive the payout for the transaction in your home currency.