Recargo
Un recargo es un monto adicional que el negocio cobra para cubrir el costo de la aceptación de pagos con tarjeta. La funcionalidad de recargo del Mastercard Gateway le permite aplicar un recargo a una transacción basado en los siguientes parámetros:
- punto de entrada del motor de pagos, por ejemplo, Hosted Checkout, DirectAPI
- método de pago, por ejemplo, Mastercard, Visa, American Express
- método de financiamiento, por ejemplo, crédito, débito
- moneda
Para permitir que el motor de pagos calcule un recargo para una transacción, debe configurar reglas de recargo en Merchant Administration. También, puede incluir un recargo calculado previamente en el pedido, si está realizando la integración mediante DirectAPI/Batch.
Prerrequisitos
- Debe estar habilitado para recargos en su perfil del negocio con el Mastercard Gateway.
- Debe tener reglas de recargo configuradas en Merchant Administration para permitir que el motor de pagos calcule el recargo.
Integración para usar recargos
El motor de pagos admite recargos en transacciones que utilizan los siguientes métodos de integración:
Integración mediante DirectAPI/Batch
Puede aplicar un recargo en un pedido utilizando una de las siguientes opciones:
- recargo calculado por el motor de pagos
Para permitir que el motor de pagos calcule un recargo, complete el siguiente campo en una solicitud de
Authorize/PayoUpdate Session:order.netAmount: este es el monto que se debe pagar por el pedido antes de que se aplique el recargo.
No complete el campoorder.amounten la solicitud. Consulte las Preguntas frecuentes a continuación.Puede enviar una solicitud de
Retrieve Transaction/Retrieve Orderpara recuperar los siguientes detalles de recargo:order.surchargeAmount: el recargo calculado por el motor de pagos basado en sus reglas de recargo.order.amount: el monto total del pedido, incluido el monto del recargo.
También puede utilizar la operaciónPayment Options Inquirypara solicitar el monto del recargo calculado al completar los campos:session.id,order.netAmount,order.currency,gatewayEntryPointysourceOfFunds.provided.card.prefix. - recargo calculado por el negocio
Complete los siguientes campos en una solicitud
Authorize/Pay/Standalone CaptureoUpdate Session:order.amount: el monto total del pedido, incluido el monto del recargo.order.surchargeAmount: el recargo, si lo hubiera, aplicable a este pedido. Este monto debe incluirse en el monto total del pedido que se especifica en el campoorder.amount.
Al enviar una solicitud de
Retrieve Transaction/Retrieve Order, se devolverán los detalles de recargo tal y como los proporcionó usted en la solicitud de transacción másorder.netAmount(monto neto derivado como monto del pedido menos el monto del recargo).
Payment Options Inquiry para solicitar los detalles de esquema de tarjeta/financiamiento para ayudarle a evaluar y aplicar el recargo correcto para una tarjeta. Para obtener más información, consulte las Preguntas frecuentes a continuación.- recargo calculado por el negocio
order.amount: el monto total del pedido, incluido el monto del recargo.order.merchantCharge.amount: el monto de la tarifa adicional que está cobrando al pagador, actualmente esto se refiere solo al monto del recargo.order.merchantCharge.type: el tipo de la tarifa adicional que está cobrando al pagador, actualmente esto se refiere solo al recargo. El valor de merchantCharge.type es recargo.
- Recargo calculado por el motor de pagos
order.netAmount: este es el monto que se debe pagar por el pedido antes de que se aplique el recargo.order.merchantCharge.type: el tipo de la tarifa adicional que está cobrando al pagador, actualmente esto se refiere solo al recargo. El valor de merchantCharge.type es recargo.
Referencia de API de Authorize [REST][NVP]
Referencia de API de Retrieve Transaction [REST][NVP]
Referencia de API de Payment Options Inquiry [REST][NVP]
Integración mediante Hosted Checkout
El motor de pagos puede calcular el recargo a través de Hosted Checkout.
Para aplicar un recargo a un pago de Hosted Checkout, complete el siguiente campo en la solicitud de Hosted Checkout (función Checkout.configure() u operación Create Checkout Session, dependiendo de su flujo de pago):
order.netAmount: el monto que se debe pagar por el pedido antes de que se aplique el recargo.
order.amount en la solicitud. Consulte las Preguntas frecuentes a continuación.Puede enviar una solicitud de Retrieve Transaction/Retrieve Order para recuperar los detalles de recargo:
order.surchargeAmount: el recargo calculado por el motor de pagos basado en sus reglas de recargo.order.amount: este es el monto neto más el recargo.
El pagador podrá ver el recargo correspondiente a la tarjeta que ingresó y podrá optar por proceder con el nuevo monto total, utilizar una tarjeta diferente o cancelar el pedido. El recibo de pago presentado al pagador mostrará el monto del recargo que se aplicó.
order.netAmount: el monto que se debe pagar por el pedido antes de que se aplique el recargo.order.merchantCharge.type: el tipo de la tarifa adicional que está cobrando al pagador, actualmente esto se refiere solo al recargo. El valor de merchantCharge.type es recargo.
order.amount en la solicitud. Consulte las Preguntas frecuentes a continuación.Puede enviar una solicitud de Retrieve Transaction/Retrieve Order para recuperar los detalles de recargo:
order.merchantCharge.amount: el monto de la tarifa adicional que está cobrando al pagador, actualmente esto se refiere solo al monto del recargo.order.amount: este es el monto neto más el recargo.
El pagador podrá ver el recargo correspondiente a la tarjeta que ingresó y podrá optar por proceder con el nuevo monto total, utilizar una tarjeta diferente o cancelar el pedido. El recibo de pago presentado al pagador mostrará el monto del recargo que se aplicó.
Preguntas frecuentes
¿Calculará el motor de pagos el recargo si completo los campos order.netAmount y order.amount en mi solicitud?
Si se completan los campos order.netAmount y order.amount sin order.surchargeAmount se producirá un error porque el motor de pagos no tiene suficiente información para calcular el recargo. El motor de pagos requiere que complete el campo order.netAmount O el campo order.amountorder.amount.
Si completa los tres campos, el motor de pagos no calculará el recargo, sino que utilizará el monto del recargo que usted haya indicado.
¿Puedo optar por no aplicar recargos a los pagos con tarjeta al enviar una transacción?
Sí, para optar por no recibir recargos:
- Proporcione el campo order.amount en su solicitud de transacción para indicar el monto total del pedido.
Para Direct API desde la versión de WSAPI 50 a 66:
- Cuando el negocio calcule el recargo, no proporcione ningún valor en los campos order.netAmount y order.surchargeAmount.
- Cuando el motor de pagos calcule el recargo, no proporcione ningún valor en el campo order.netAmount.
Para Direct API desde la versión de WSAPI 67 y superior:
- Cuando el negocio calcule el recargo, no proporcione ningún valor en los campos order.netAmount, order.merchantCharge.amount y order.merchantCharge.type como recargo.
- Cuando el motor de pagos calcule el recargo, no proporcione ningún valor en los campos order.netAmount y order.merchantCharge.Type como recargo.
Para Hosted Checkout desde la versión de WSAPI 50 a 70:
- El motor de pagos siempre calcula el recargo; no proporcione ningún valor en el campo order.netAmount.
Para Hosted Checkout desde la versión de WSAPI 71 y superior:
- El motor de pagos siempre calcula el recargo; no proporcione ningún valor en los campos order.netAmount y order.merchantCharge.type como recargo.
Si el pagador solicita un reembolso, ¿se le reembolsará el monto del recargo?
Sí. Debido a que el recargo está incluido en el campo order.amount, y este monto es el que se reembolsa al pagador, el monto del recargo también se reembolsará. En caso de reembolsos parciales, el monto del recargo se reembolsará de forma proporcional.
Si tengo habilitada la conversión dinámica de moneda (DCC), ¿el motor de pagos calculará el recargo tanto en la divisa de facturación del pagador como en mi divisa preferida?
Sí, el motor de pagos incluirá el recargo aplicable en el monto del pedido, que se devolverá como paymentTypes.card.currencyConversion.payerAmount en la divisa de facturación del pagador y como campo order.amount en su divisa preferida (en la respuesta de la operación Payment Options Inquiry).
¿Puedo recuperar los datos de identificación del tipo de tarjeta para ayudar a calcular el recargo de un pedido?
Puede completar el campo sourceOfFunds.provided.card.prefix en la solicitud de Payment Options Inquiry para recuperar los siguientes detalles de esquema/financiamiento sobre la tarjeta utilizada para el pago, lo que puede ayudarle a tomar decisiones sobre los recargos:
paymentTypes.card.scheme: la organización que posee una marca de tarjeta y define las regulaciones de operación para su uso.paymentTypes.card.brand: La marca utilizada para describir la tarjeta reconocida y aceptada globalmente. En muchos de los principales tipos de tarjetas, esto coincidirá con el nombre del esquema. En algunos mercados, una tarjeta también puede ser de marca compartida con una marca local reconocida y aceptada en su país o región de origen (consulte Marca local).paymentTypes.card.localBrand: El nombre de marca utilizado para describir una tarjeta reconocida y aceptada en su país/región de origen. La tarjeta también puede tener una marca compartida con una marca comercial que se reconoce y acepta a nivel mundial.paymentTypes.card.fundingMethod: el método que utiliza el pagador para proporcionar fondos para el pago.
Puede utilizar estos datos para calcular un recargo basado en la tarjeta presentada por el pagador.