Getnet DocsGetnet Docs

Dynamic Currency Conversion (DCC)

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Dynamic Currency Conversion (DCC) es una funcionalidad que permite a los titulares de tarjetas internacionales pagar en su moneda de origen en lugar de en la moneda local del comercio (Euro). Get Smart API Cloud soporta flujos de DCC, proporcionando campos de datos específicos y requisitos de impresión de recibos para garantizar el cumplimiento de las normativas financieras.

Cómo funciona DCC

Cuando se utiliza una tarjeta que no es en euros (p. ej., una Visa en dólares estadounidenses) en un terminal, el sistema puede ofrecer al titular de la tarjeta una opción:

  1. Pagar en EUR (La moneda del comercio). El tipo de cambio es determinado posteriormente por el banco del titular de la tarjeta.
  2. Pagar en USD (La moneda del titular de la tarjeta). El tipo de cambio es determinado de forma inmediata por el proveedor de DCC, ofreciendo certeza sobre el importe final cobrado.

Esta negociación se realiza físicamente en el terminal. Si el cliente acepta la oferta de DCC, API Cloud devuelve datos adicionales en la respuesta de la transacción.

Estructura de datos de DCC

Si una transacción incluye DCC, el payload de la respuesta (datosRespuesta) contendrá campos específicos detallando la conversión de divisa.

Campos principales de DCC

CampoDescripciónEjemplo
codigoDivisaEl código ISO numérico de la divisa extranjera.840 (USD)
importeDivisaEl importe final cobrado en la divisa extranjera.71,37
tasaCambioEl tipo de cambio aplicado a la transacción.0.840678
tasaDivisaSinComisionEl tipo de cambio base antes de la comisión (mark-up).0.870102
pocentajeComisionEl porcentaje de comisión (mark-up) aplicado por el servicio. Ten en cuenta la grafía: al nombre del campo le falta la r.2.0

Requisitos del recibo (Literales)

Las normas de cumplimiento exigen que el recibo impreso para el cliente indique claramente las condiciones de la conversión. La API simplifica esto devolviendo un objeto Literales que contiene el texto exacto que debe imprimir.

Debes imprimir estas líneas exactamente como se reciben si están presentes en la respuesta.

  • Aviso legal: Un bloque de texto confirmando la elección del usuario (p. ej., “I accept that I have been offered a choice of currencies…”).
  • Objeto datosDCC: Contiene líneas estructuradas para el pie del recibo:
    • linLitTrans: Etiqueta para la divisa de la transacción.
    • linLitDivisa: El importe en la divisa extranjera.
    • linCambio: La ecuación del tipo de cambio (p. ej., USD 1.00 = 0.840678 EUR).
    • linMarkUp: Declaración explícita de la comisión (p. ej., INCLUDES 2.0% MARK-UP).

Lógica de impresión: Si el objeto Literales está presente en la respuesta, tu lógica de impresión debe iterar a través de él y añadir el texto al recibo del cliente. Consulta las Especificaciones de impresión de recibos para ver ejemplos de diseño.

Próximos pasos