Conversión dinámica de moneda

El Mastercard Payment Gateway puede proporcionarle una cotización de tasa en tiempo real de un proveedor de DCC en bienes y servicios en la moneda de su preferencia. Usted puede ofrecer esta tasa de intercambio al pagador, el que luego puede optar por pagar en la moneda que usted prefiera o en la moneda de la tarjeta. El beneficio de este servicio para los titulares de tarjetas es que saben, en el momento de la transacción, el monto exacto que se les cobrará en su propia moneda.

Beneficios clave

Los pagadores pueden pagar por bienes o servicios en su moneda de facturación en el punto de venta.
Usted recibe una parte de la tarifa de la conversión de la moneda.
El pedido se procesa en su moneda para el pedido.
Los pagadores ven el monto del pedido en su moneda en la cuenta de la tarjeta.
Los pagadores no ven un cargo por conversión de moneda en la cuenta de la tarjeta (ya que esto se incluye en la cotización de tasa proporcionada).

Prerrequisitos para las cotizaciones de tasa

Debe estar registrado con el proveedor de DCC que desee utilizar.
El Mastercard Payment Gateway actualmente admite:
- FEXCO

Administración de cotizaciones de tasa a través del motor de pagos

Existen cuatro escenarios básicos y excluyentes para la aplicación de DCC a una transacción:

No se recomienda aplicar DCC en la transacción; por ejemplo, cuando la moneda de la tarjeta del pagador coincide con la moneda de su preferencia.
Desea aplicar DCC si hubiera una oferta sobre la mesa, pero no existe tal oferta.
Desea aplicar DCC. El proveedor de DCC hizo una oferta. Usted se la hizo llegar al pagador, que la rechazó.
Desea aplicar DCC. El proveedor de DCC hizo una oferta. Usted se la hizo llegar al pagador, que la aceptó.

Solicitar una cotización de tasa

Puede solicitar una cotización de tasa al proporcionar datos para los campos siguientes en la solicitud Payment Options Inquiry (apiOperation=PAYMENT_OPTIONS_INQUIRY):

order.amount.
order.currency.
paymentType. Si se proporciona, debe estar configurado en CREDIT.

DCC solo es compatible en transacciones que usan Visa, Mastercard o tipos de tarjeta Maestro. La solicitud de DCC para cualquier otro tipo de tarjeta devolverá currencyConversion.gatewayCode=UNSUPPORTED_CARD_BRAND.

Cuando llame a la operación Payment Options Inquiry utilizando el protocolo REST, asegúrese de que los parámetros de la solicitud estén incluidos en la URI (como parámetros de consulta) y no en un cuerpo JSON. A continuación se encuentra una solicitud REST de muestra en curl para una cotización de tasa de DCC.

curl --user merchant.TESTMERCHANT-DCC:<PASSWORD>"https://evopaymentsmexico.gateway.mastercard.com/api/rest/version/72/merchant/TESTMERCHANT-DCC/paymentOptionsInquiry?order.amount=123.34&order.currency=USD&sourceOfFunds.provided.card.prefix=531335999"

Respuestas de estado de cotización de tasa

El Mastercard Payment Gateway devuelve la siguiente información sobre la oferta de DCC. Parte de esta se incluirá en la información que muestre al pagador en su página de pago o terminal PED, acorde con los requisitos legislativos y de esquema.

currencyConversion.gatewayCode:
- QUOTE_PROVIDED: cotización proporcionada.
- NOT_ELIGIBLE: DCC no disponible para esta tarjeta y/o moneda.
- UNSUPPORTED_CARD_BRAND: marca de la tarjeta no compatible.
- INSUFFICIENT_INFORMATION: faltan campos obligatorios en la solicitud.
- ERROR: el proveedor de DCC no puede procesar esta operación.
currencyConversion.provider: nombre del proveedor de cotización de DCC.
currencyConversion.providerCode: generado por el proveedor de DCC, resume el éxito o error de la solicitud de cotización de DCC.
currencyConversion.providerReceipt: referencia única del proveedor de DCC para la cotización de tasa. (No siempre se proporciona).
currencyConversion.exchangeRateSource: agencia de datos financieros utilizada como fuente para la tasa de intercambio.
currencyConversion.payerExchangeRate: tasa de intercambio usada para convertir el monto de la transacción en la moneda del pagador. Esto incluye currencyConversion.marginPercentage.
currencyConversion.payerAmount: el monto total de la transacción en la moneda del pagador.
currencyConversion.payerCurrency: la moneda de la cotización de tasa de DCC proporcionada por el proveedor de DCC.
currencyConversion.marginPercentage: marca de cambio aplicada como porcentaje al monto de transacción para proporcionar el servicio de conversión.
currencyConversion.exchangeRateTime: marca de tiempo de entrada en vigencia de la tasa de conversión.
currencyConversion.quoteExpiry: la marca de tiempo que indica cuándo caduca la oferta de cotización de DCC. (No siempre se proporciona).
currencyConversion.offerText: un fragmento de HTML que contiene un formulario de ingreso para la oferta de DCC. Este se debe presentar al pagador para recopilar su opción.
currencyConversion.requestId: el identificador único para la solicitud de cotización de DCC como se devolvió en la respuesta de PAYMENT_OPTIONS_INQUIRY.

Referencia de API de Payment Options Inquiry[REST][NVP]

Uso de la cotización de tasa para una transacción

Si obtiene una cotización de tasa del proveedor de DCC (currencyConversion.gatewayCode=QUOTE_PROVIDED), puede hacer una oferta de conversión de moneda al pagador.

Ofertas de cotización de tasa
Texto de oferta

Visa y Mastercard tienen requisitos específicos para mostrar la información de DCC a los pagadores a fin de garantizar que al pagador se le entregue la información requerida para hacer una elección informada. Esto incluye detalles de las tarifas y los cargos tanto en la oferta de DCC, así como el recibo de la transacción (si el pagador acepta la oferta).

Principios fundamentales de las regulaciones de DCC:
- El titular de la tarjeta tiene la opción de pagar en la moneda del negocio o su moneda local con total transparencia de los detalles de la transacción.
- El titular de la tarjeta tiene la opción de aceptar o rechazar la oferta de DCC.
- Los términos y las condiciones asociados con DCC se divulgan por completo al titular de la tarjeta.
Presentación de ofertas

Usted recibirá el texto de oferta en paymentTypes.card.currencyConversion.offerText. Puede especificar la configuración regional para el texto de la oferta mediante el ajuste de locale=<Valid language identifier or IETF language tag of payer's locale> (por ejemplo, en para inglés, pt-BR para portugués de Brasil, es-MX para español de México).

Un texto de oferta de DCC en formato HTML específico para una configuración regional se devuelve en paymentTypes.card.currencyConversion.offerText para las siguientes configuraciones regionales admitidas:
- Francés (fr_FR)
- Alemán (de_DE)
- Español de México (es_MX)
- Chino:
  - Chino simplificado (zh_CN)
  - Chino de Hong Kong (zh_HK)
- Portugués de Brasil (pt_BR)
- Japonés (ja_JP)
- Indonesio (id_ID)
- Inglés:
  - Estados Unidos (en_US)
  - Reino Unido (en_UK)
  - Australia (en_AU)
Si la configuración regional no se admite, el Mastercard Payment Gateway proporcionará un texto de oferta acorde con el siguiente esquema:
- El código de idioma se asocia con la configuración regional admitida más similar, si está disponible.
- Si no define interaction.locale o si la configuración regional proporcionada y el idioma base no se admiten, el Mastercard Payment Gateway intentará usar su configuración regional predeterminada. Si esa configuración regional y el idioma base no se admiten, la oferta se presentará en en_US.
Luego, el pagador puede elegir una de estas opciones:
- Aceptar la oferta de DCC y pagar en la moneda de la tarjeta.
  
  En este caso, inicie una solicitud de transacción con los siguientes parámetros:
  - currencyConversion.requestId como se devuelve en la respuesta del Mastercard Payment Gateway.
  - currencyConversion.uptake=ACCEPTED.
  Suministre al pagador el texto de recibo proporcionado en paymentTypes.card.currencyConversion.receiptText en la respuesta de RETRIEVE_TRANSACTION. Esta usa la misma configuración regional que el texto de oferta.
- Rechazar la oferta de DCC y pagar en la moneda del pedido (currencyConversion.uptake=DECLINED).
  
  En este caso, inicie una solicitud de transacción con los siguientes parámetros:
  - currencyConversion.requestId como se devuelve en la respuesta del Mastercard Payment Gateway.
  - currencyConversion.uptake=DECLINED.
Si recibe una de las siguientes opciones en la respuesta de Payment Options Inquiry:
- currencyConversion.gatewayCode=UNSUPPORTED_CARD_BRAND
- currencyConversion.gatewayCode=NOT_ELIGIBLE
- currencyConversion.gatewayCode=ERROR
Debe configurar currencyConversion.uptake=NOT_AVAILABLE en su solicitud de transacción y proporcionar el currencyConversion.requestId correcto.

Esto permite que el proveedor de DCC use los datos para fines de análisis y reportes.

Si recibió una cotización de tasa fuera del motor de pagos, debe proporcionar explícitamente los detalles de DCC devueltos a usted en la solicitud de transacción por parte del proveedor de DCC.

Si desea utilizar la API de autenticación para autenticar al pagador antes de realizar el pago, debe pasar los campos de DCC como se describe en la operación Initiate Authentication. Una vez que se completa la autenticación del pagador, puede continuar con el pago en el mismo pedido con una operación Authorize o Pay y proporcionar la authentication.transactionId que facilitó en las operaciones Initiate Authentication y Authenticate Payer. No es necesario que vuelva a pasar los campos de DCC en su transacción financiera porque se transfieren de la transacción de autenticación del pagador a la que se hace referencia.

Referencia de API de Entrada de conversión de moneda [REST][NVP]

Transacciones de DCC de captura/reembolso

Capturas

Se deben proporcionar los detalles de DCC en la solicitud de transacción Authorize. Los detalles de DCC se aplican a las capturas en el pedido.

Para una captura completa, se usarán los detalles de DCC de la solicitud Authorize.

Para capturas parciales o excesivas, el Mastercard Payment Gateway calcula el monto como un porcentaje proporcional.

Referencia de API de Conversión de moneda para capturas [REST][NVP]

Reembolsos

Si está configurado por su MSO para DCC en el Mastercard Payment Gateway, esta configuración se aplica a los reembolsos posteriores.

Opciones de configuración:

CURRENT: se solicita una nueva cotización de tasa para proporcionar la tasa real en la fecha de transacción del reembolso.
HISTORICAL: la tasa utilizada cuando se creó el pedido se aplicará al reembolso.

Si currencyConversion.uptake=ACCEPTED para la transacción inicial:

La configuración es CURRENT:
- Se solicitará una cotización de tasa por el monto específico del reembolso. Esto generará un nuevo currencyConversion.requestId. La nueva cotización de tasa se aplicará al reembolso.
- La respuesta de la transacción devuelve currencyConversion.uptake=ACCEPTED.
La configuración es HISTORICAL:
- Los detalles de DCC proporcionados en la transacción de inicio en el pedido se utilizarán para calcular el currencyConversion.payerAmount para el reembolso.
- Para los reembolsos parciales o los montos de reembolso excesivos, el currencyConversion.payerAmount de la transacción inicial se ofrecerá de manera proporcional como un porcentaje del monto del negocio. Cuando se aplique el método proporcional, se usará el redondeo estándar.
- Si utiliza reembolsos parciales para reembolsar por completo un monto capturado, el último reembolso parcial incluirá el monto del pagador capturado pendiente. Esto se realiza para representar cualquier redondeo en montos parciales. Cuando el monto del reembolso total no es igual al monto total capturado, no habrá ninguna validación en montos de pagador (por ejemplo, sobre reembolsos excesivos).
- La respuesta de la transacción devuelve currencyConversion.uptake=ACCEPTED.

Si currencyConversion.uptake=DECLINED o NOT_AVAILABLE o NOT_REQUIRED para la transacción inicial:

Si la autorización inicial y la captura se procesan correctamente como transacciones no DCC y usted envía una solicitud de reembolso posterior, entonces, independientemente de su configuración de negocio:

No se solicitará una cotización de tasa.
No se devolverán campos de currencyConversion en la respuesta de la transacción de reembolso ni en la operación Retrieve Transaction.

Prueba de su integración de DCC

Puede probar su integración de DCC mediante su perfil de pruebas del negocio.