Conversión dinámica de moneda

El Mastercard Payment Gatewaypuede 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 cambio 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 mediante el Mastercard Payment Gateway

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

  1. 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.
  2. Se desea aplicar DCC si hubiera una oferta sobre la mesa, pero no existe tal oferta.
  3. Se desea aplicar DCC. El proveedor de DCC hizo una oferta. Usted se la ofreció al pagador, que la rechazó.
  4. Se desea aplicar DCC. El proveedor de DCC hizo una oferta. Usted se la ofreció 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/57/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 cambio.
  • currencyConversion.payerExchangeRate: tasa de cambio 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.receiptText: un fragmento de HTML que contiene un formulario de recibo para la oferta de DCC. Este se debe presentar al pagador si aceptó la oferta de DCC.
  • 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 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 al ajustar 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 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.

      Si desea usar el servicio 3-D Secure para autenticar al pagador antes de realizar el pago, también debe pasar estos campos de DCC en la operación Check 3DS Enrollment.
    • 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 Mastercard Payment Gateway, debe proporcionar explícitamente los detalles de DCC devueltos a usted en la solicitud de transacción por parte del proveedor de DCC.

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

Transacciones de DCC de Capture/Refund

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 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 proporcionará 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 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.

Derechos de autor © 2020 Mastercard