# Dynamic Currency Conversion (DCC)

Dynamic Currency Conversion (DCC) is a feature that allows international cardholders to pay in their home currency instead of the merchant's local currency (Euro). The Get Smart API Cloud supports DCC flows, providing specific data fields and receipt printing requirements to ensure compliance with financial regulations.

## How DCC Works
    
When a non-Euro card (e.g., a US Dollar Visa) is used at a terminal, the system may offer the cardholder a choice:

1. Pay in **EUR** (The merchant's currency). The exchange rate is determined later by the cardholder's bank.  
2. Pay in **USD** (The cardholder's currency). The exchange rate is determined immediately by the DCC provider, offering certainty on the final amount charged.

This negotiation happens physically on the terminal. If the customer accepts the DCC offer, the API Cloud returns additional data in the transaction response.

## DCC Data Structure

If a transaction includes DCC, the response payload (`datosRespuesta`) will contain specific fields detailing the currency conversion.

### Core DCC Fields

| Field | Description | Example |
| :---- | :---- | :---- |
| `codigoDivisa` | The numeric ISO code of the foreign currency. | `840` (USD) |
| `importeDivisa` | The final amount charged in the foreign currency. | `71,37` |
| `tasaCambio` | The exchange rate applied to the transaction. | `0.840678` |
| `tasaDivisaSinComision` | The base exchange rate before markup. | `0.870102` |
| `pocentajeComision` | The markup percentage applied for the service. Note the spelling — the field name is missing the `r`. | `2.0` |

### Receipt Requirements (Literales)

Compliance rules require that the receipt printed for the customer clearly states the terms of the conversion. The API simplifies this by returning a Literales object containing the exact text you must print.

You **must** print these lines exactly as received if they are present in the response.

* **Disclaimer:** A text block confirming the user's choice (e.g., *"I accept that I have been offered a choice of currencies..."*).  
* **datosDCC Object:** Contains structured lines for the receipt footer:  
  * `linLitTrans`: Label for transaction currency.  
  * `linLitDivisa`: The amount in foreign currency.  
  * `linCambio`: The exchange rate equation (e.g., `USD 1.00 = 0.840678 EUR`).  
  * `linMarkUp`: Explicit statement of the commission (e.g., `INCLUDES 2.0% MARK-UP`).

> **Printing Logic**: If the `Literales` object is present in the response, your printing logic should iterate through it and append the text to the customer's receipt. See the **Receipt Printing Specifications** for layout examples.

## Next Steps

* [**Receipt Printing Specifications**](/en/get-smart/get-smart-api-cloud/reference/receipt-printing-specifications)**:** detailed examples of DCC receipt layouts.  
* [**Process Single-Step Payments**](/en/get-smart/get-smart-api-cloud/integration-guides/process-single-step-payments)**:** Learn how to handle the standard payment flow where DCC might occur.