For the complete documentation index, see llms.txt. This page is also available as Markdown.

Dynamic Currency Conversion

Dynamic Currency Conversion (DCC) is a service that allows international customers to pay the purchase price in the local currency or their home currency. DCC is available for Worldline acceptance contracts with DCC expansion, via the Payment Page or the Transaction Interface flows. For this, the terminal used for making the payment request receives a base currency in which all transactions are settled. Via DCC, international customers are shown the purchase price in the base currency and the current exchange rate in their national currency. The customer can then decide the currency in which the payment is to be made. Saferpay automatically handles this step during the redirect.

Supported Payment Methods

The following payment methods do support DCC:

Example of the DCC Screen

(click to enlarge)

DCC Compliance

While DCC itself is performed automatically, the card schemes require that the merchant shares the DCC information with the payer, if DCC was performed. The merchant must share the following information:

  • The original amount and currency

  • The DCC amount and currency

  • The exchange rate

  • The markup rate

How to gather the DCC information via API

Besides the original transaction amount, which is set by the merchant beforehand, Saferpay does return all the DCC related information inside the DCC container, together with the rest of the transaction data, e.g. via the Payment Page Assert or Transaction Authorize.

Example of a DCC response

Payer notification options

You, the merchant, have different options, when it comes to notifying the payer about DCC:

  1. With the Payment Page, you can use its built-in payer notification system by filling out the Notification.PayerEmail parameter. This will send a notification e-mail to the specified address, containing all necessary data. Please note that this email is always sent, even if no DCC has been performed.

  2. Alternatively to option #1, the parameter Notification.PayerDccReceiptEmail can be used (API Spec version 1.35 or higher is required). In this case, an email is only sent if DCC has been performed, containing only the necessary information for the DCC compliance. If both, Notification.PayerEmail and Notification.PayerDccReceiptEmail are used, Saferpay will use the latter, if DCC has been performed, if not, the former is used.

  3. Alternatively, you can of course send your own email and use the data provided by the API (API Spec version 1.27 or higher is required), using the returned data, as described above.

  4. If #1, #2, and #3 are no options to you, for instance if there were complications, or if you simply want to trigger the Saferpay notification again, you can also trigger the notification from the transaction details inside the Saferpay Backoffice.

Find out if DCC is active

You can access this information on a per terminalId basis, by logging into the Saferpay Backoffice and checking the terminal configuration under Settings => Terminals.

Custom DCC selection screen.

If you want to, you can also build your own DCC selection screen by using our DCC Inquire Interface.

Last updated

Was this helpful?