Integration Types
Otras características
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
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:
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 API/Batch.
El motor de pagos admite recargos en transacciones que utilizan los siguientes métodos de integración:
Puede aplicar un recargo en un pedido utilizando una de las siguientes opciones:
Para permitir que el motor de pagos calcule un recargo, complete el siguiente campo en una solicitud de Authorize
/Pay
o Update Session
:
order.netAmount
: este es 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 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. Payment Options Inquiry
para solicitar el monto del recargo calculado al completar los campos: session.id
, order.netAmount
, order.currency
, gatewayEntryPoint
y sourceOfFunds.provided.card.prefix
.Complete los siguientes campos en una solicitud Authorize
/Pay
/Standalone Capture
o Update 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 campo order.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ás order.netAmount
(monto neto derivado como monto del pedido menos el monto del recargo).
Payment Options Inquiry
para solicitar los detalles de esquema de tarjeta/financiación 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.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.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]
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ó.
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.
Sí, para optar por no recibir recargos:
Para Direct API desde la versión de WSAPI 50 a 66:
Para Direct API desde la versión de WSAPI 67 y superior:
Para Hosted Checkout desde la versión de WSAPI 50 a 70:
Para Hosted Checkout desde la versión de WSAPI 71 y superior:
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.
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
).
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 comercial que se utiliza para describir la tarjeta que se reconoce y acepta a nivel mundial. 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
: la marca comercial que se utiliza para describir la tarjeta se reconoce y acepta dentro de 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.