# 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](/home/integration-guide/licences-and-interfaces/payment-page.md) or the [Transaction Interface](/home/integration-guide/licences-and-interfaces/transaction-interface.md) 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:

* [Mastercard](/home/integration-guide/payment-methods/mastercard.md) **(only via Worldline Acquiring)**
* [Maestro](/home/integration-guide/payment-methods/maestro.md) **(only via Worldline Acquiring)**
* [Visa/V PAY](/home/integration-guide/payment-methods/visa-and-vpay.md) **(only via Worldline Acquiring)**

#### Example of the DCC Screen

![(click to enlarge)](/files/fPBDU7DNvcTkxhKHvHVW)

## DCC Compliance

While DCC itself is performed automatically, the card schemes require, that the merchant shares the DCC information to 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](https://saferpay.github.io/jsonapi/#Payment_v1_PaymentPage_Assert), or [Transaction Authorize](https://saferpay.github.io/jsonapi/#Payment_v1_Transaction_Authorize).

#### Example of a DCC response

```json
"Dcc": {
    "PayerAmount": {
      "Value": "352",
      "CurrencyCode": "JPY"
    },
    "Markup": "3%",
    "ExchangeRate": "1.234"
  }
```

### Payer notification options

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

1. With the [Payment Page](/home/integration-guide/licences-and-interfaces/payment-page.md), 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. <mark style="color:$warning;">**Please note, that this E-Mail is always sent, even if no DCC has been performed.**</mark>
2. Alternatively to option #1, the parameter **`Notification.PayerDccReceiptEmail`** can be used (<mark style="color:$warning;">**API Spec version 1.35 or higher is required**</mark>). \
   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 are used **`Notification.PayerDccReceiptEmail`**, 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 (<mark style="color:$warning;">**API Spec version 1.27 or higher is required**</mark>), using the returned data, [as described above](#how-to-gather-the-dcc-information-via-api).
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](/home/interfaces/backoffice/transactions/journal-details.md#notification).

## Find out if DCC is active

You can access this information on a per [terminalId](/home/master/common-saferpay-terms-glossary.md#terminalid) basis, by logging into the Saferpay Backoffice and check the terminal-configuration under [Settings => Terminals](/home/interfaces/backoffice/settings.md#payment-means-terminals).

## Custom DCC selection-screen.

If you want to, you can also build your own DCC selection screen, by [using our DCC Inquire Interface](/home/integration-guide/licences-and-interfaces/inquire-interface.md#dcc-inquire).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.saferpay.com/home/integration-guide/general-information/dynamic-currency-conversion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.