Transacciones
Las transacciones son acciones que se realizan sobre el pedido. Podrían estar autenticando al pagador o la tarjeta, reservando fondos del pagador o moviendo dinero entre usted y el pagador. Usted inicia una transacción en su sistema enviando una solicitud de API al Mastercard Gateway, que a su vez procesa la solicitud y la envía a un proveedor o adquirente de método de pago relevante. Para realizar cualquier operación de API, como iniciar una transacción, debe tener el privilegio requerido establecido en su perfil del negocio con el motor de pagos. Para comprobar qué transacciones puede iniciar, comuníquese con your payment service provider. Los pagos no realizados con tarjeta o las redes de tarjetas de débito pueden tener un conjunto limitado de operaciones API en comparación con las tarjetas de crédito.
Las siguientes secciones describen los casos de uso para transacciones con tarjetas individuales. Se incluyen ejemplos de solicitudes simples con los campos obligatorios únicamente, utilizando un método de pago con tarjeta de crédito, donde los detalles almacenados de la tarjeta de crédito se proporcionan como un token. Para obtener más ejemplos de solicitudes y respuestas, consulte la colección de Postman.
Transacciones iniciales, independientes y posteriores
Las transacciones admitidas en el Mastercard Gateway se pueden dividir en cuatro grupos, según cómo se pueden utilizar:
- Inicial
Las transacciones iniciales crean un nuevo pedido e inician el flujo de pago para la instancia de venta. Estas transacciones necesitan un ID de pedido único que defina el nuevo pedido. Los siguientes tipos de transacciones se pueden utilizar como transacciones iniciales:
- independiente
Las transacciones independientes son un tipo especial de transacción inicial, que se utiliza en una situación en la que la transacción inicial de un pedido se realiza fuera del motor de pagos o simplemente no desea asociar la transacción con un pedido existente. Estas transacciones también se conocen en la industria como: Transacciones sin referencia, no coincidentes o no vinculadas y no están habilitadas de forma predeterminada debido al riesgo de fraude.
Los siguientes tipos de transacciones se pueden utilizar como transacciones independientes:
- Subsecuente
Las transacciones posteriores están relacionadas con un pedido existente, ya que modifican o progresan ese pedido de alguna manera. Estas transacciones deben vincularse a una transacción inicial utilizando su ID del pedido.
Los siguientes tipos de transacciones se pueden utilizar como transacciones posteriores:
- Informativo
Las transacciones informativas son creadas por el procesador de pagos o el adquirente para proporcionar información adicional sobre el pedido.
Para obtener más información sobre Autorizar, consulte Authorize.
Authorize
La transacción AUTHORIZE verifica los detalles de la tarjeta del pagador, revisa que el pagador tenga suficientes fondos disponibles en su línea de crédito e intenta reservar los fondos solicitados. El límite de crédito del pagador se reduce de acuerdo con el monto autorizado y los fondos se reservan por un período de tiempo (en la mayoría de los casos de 5 a 8 días), según lo que determinen el esquema de la tarjeta y las reglas de emisión de la tarjeta del pagador. Para una autorización con éxito, el motor de pagos devuelve result = SUCCESS en la respuesta de transacción.
La autorización no debita fondos desde la cuenta del pagador, sino que reserva el monto total del pedido, lista para que la transacción CAPTURE debite la tarjeta y transfiera los fondos a su cuenta. Las transacciones AUTHORIZE no aparecen en el estado de cuenta del pagador, a diferencia de las transacciones CAPTURE.
Muchos sistemas bancarios en línea ahora brindan notificación de la actividad de autorización.
Una transacción AUTHORIZE puede ser una transacción inicial (sin transacciones relacionadas anteriores) o una transacción posterior después de VERIFY o AUTHENTICATE_PAYER. En este último caso, los datos de la tarjeta en las solicitudes VERIFY o AUTHENTICATE_PAYER deben coincidir con AUTHORIZE.
Si necesita capturar una cantidad mayor a la que ha autorizado, o si necesita capturar una autorización que ha realizado fuera del motor de pagos, consulte Uso de capturas excesivas y Captura independiente, respectivamente.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "100.00",
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
}
}
Establecimiento de la certeza del pedido
Puede indicar un nivel de certeza sobre el monto de autorización que se capturará proporcionando el campo order.certainty en la solicitud AUTHORIZE. Para hacerlo, your payment service provider debe habilitar el privilegio Cambiar certeza de pedido en su perfil del negocio. Puede configurar el campo en cualquiera de los siguientes valores:
- Final
Se espera capturar el monto autorizado completo con una o más capturas dentro del tiempo establecido (normalmente 7 días). El pedido solo se cancelará en circunstancias excepcionales (por ejemplo, el pagador canceló su compra). Proporcionar este valor en su transacción puede calificar la transacción para tarifas de procesamiento más bajas.
- Estimado
El monto autorizado es una estimación del monto que se capturará dentro del plazo establecido (normalmente entre 30 y 31 días). Es posible que el monto capturado sea menor o no se capture en absoluto, o se pueda cancelar la autorización. Proporcionar este valor en su transacción puede costarle tarifas de procesamiento más altas.
La solicitud se rechaza si usted no tiene el privilegio para cambiar la certeza del pedido y el valor que ingresa en este campo no coincide con el valor predeterminado de certeza del pedido configurado en su perfil del negocio.
Revertir autorizaciones
El motor de pagos puede revertir los montos de autorización pendientes para autorizaciones no capturadas, capturadas parcialmente o vencidas, cuando el adquirente lo admita. Esto permite cumplir con los requisitos del esquema de tarjeta para revocaciones totales y parciales.
- Autorizaciones no capturadas
Si no desea capturar el monto autorizado después de enviar una solicitud AUTHORIZE, debe anular su autorización enviando una solicitud VOID. Proporcione el ID de transacción para la autorización que se debe anular en el campo
transaction.targetTransactionId. - Autorizaciones capturadas parcialmente
Al enviar una solicitud de CAPTURE para un pedido, puede proporcionar un monto de CAPTURE inferior al monto autorizado para el pedido
(order.AuthorizedAmount)definido en su solicitud AUTHORIZE. Si no tiene intención de capturar el monto autorizado restante, puede anular el monto autorizado pendiente, cuando lo admita el adquirente. - Envíe una solicitud VOID con el ID de transacción para que la transacción AUTHORIZE se anule en el campo
transaction.targetTransactionId. - Proporcione el número previsto de transacciones CAPTURE para el pedido en el campo
order.expectedNumberOfCapturesen la solicitud de CAPTURE o mediante la IU de Merchant Administration. En caso de que el número total de operaciones CAPTURE para el pedido (incluida la operación CAPTURE actual) sea superior o igual al número total previsto de solicitudes de CAPTURE, el motor de pagos activará automáticamente una operación VOID del monto autorizado pendiente, cuando el adquirente lo admita. Para permitir el activador automático, your payment service provider debe habilitar el privilegio Revertir automáticamente los montos de autorización pendientes en su perfil del negocio. - Autorizaciones vencidas
- Intentará anular automáticamente la autorización y liberará los fondos para el pagador (cuando el adquirente lo admita). Para permitirlo, your payment service provider debe habilitar el privilegio Revertir automáticamente las autorizaciones vencidas en su perfil del negocio.
Si el pedido está capturado parcialmente y si su adquirente admite la anulación de autorizaciones para capturas parciales, el motor de pagos intentará anular/revertir el monto de autorización pendiente.
- Rechaza cualquier solicitud Capture contra el pedido.
- Actualización de autorizaciones
- Aplazar autorizaciones
- Si su negocio acepta pagos con tarjeta presente en una terminal POS donde el sistema de autorización de POS está fuera de línea.
- Si el suyo es un negocio minorista que acepta pagos mediante pedidos telefónicos donde el sistema de autorización de POS está fuera de línea.
Puede intentar anular (revertir) el monto de autorización pendiente de dos maneras:
Por ejemplo, si proporciona order.expectedNumberOfCaptures = 2 en la primera solicitud de CAPTURE, el motor de pagos invierte automáticamente el monto autorizado restante al procesar la segunda solicitud de CAPTURE.
Si reduce el número esperado de capturas en las solicitudes CAPTURE posteriores (por ejemplo, actualiza order.expectedNumberOfCaptures = 1 en la segunda solicitud CAPTURE), el motor de pagos invierte automáticamente el monto autorizado restante al procesar la segunda solicitud CAPTURE. Esto se debe a que 2 (el número total de transacciones CAPTURE para el pedido, incluida la transacción CAPTURE actual) supera 1 (el número esperado de transacciones CAPTURE). Sin embargo, si aumenta el número esperado de transacciones CAPTURE en las solicitudes de CAPTURE posteriores (por ejemplo, actualiza order.expectedNumberOfCaptures = 3 en la segunda solicitud de CAPTURE), el motor de pagos no revertirá el monto pendiente hasta que reciba la tercera solicitud de CAPTURE.
Las autorizaciones tienen un período de validez después del cual vencen. El período de validez de autorización se puede configurar en el motor de pagos para una combinación de adquirente, tipo de tarjeta y certeza del pedido.
Cuando envía una solicitud Authorize al motor de pagos, este determina la fecha y hora de vencimiento de la autorización, sobre la base del período configurado de validez de la autorización (utilizando la combinación tipo de tarjeta, adquirente, certeza de pedido). Cuando el adquirente lo admita, el vencimiento de la autorización se devuelve en el campo authorizationResponse.autoExpiry en la respuesta de la operación Retrieve Transaction. Este campo contiene la fecha y la hora en que el motor de pagos hará que la autorización venza automáticamente.
Cuando el período de validez de la autorización venza, el motor de pagos hará lo siguiente:
El motor de pagos le permite ampliar el período de autorización y, opcionalmente, aumentar o disminuir el monto de autorización para autorizaciones válidas si el adquirente lo admite. Para hacerlo, your payment service provider debe habilitar el privilegio Update Authorization en su perfil del negocio. Para obtener más información, consulte Update Authorization.
Puede aplazar una autorización si no puede enviar una transacción AUTHORIZE o PAY en el momento en que se completó con el pagador. La falla puede deberse a problemas de conectividad o del sistema, u otras limitaciones que requieran que usted envíe la autorización posteriormente cuando el sistema vuelva a estar en línea. La identificación de las autorizaciones diferidas es obligatoria para cumplir con los requisitos del esquema de Visa.
A continuación se indican algunos casos en los que debe indicar la autorización como una autorización diferida para pagos con tarjeta Visa:
Para diferir una autorización, proporcione el campo transaction.deferredAuthorization en la solicitud AUTHORIZE, PAY o STANDALONE CAPTURE y establezca su valor en TRUE. Si no proporciona este campo, el valor predeterminado es FALSE.
Capture
La transacción Capture (también conocida como "factura" o "completa") utiliza la autorización obtenida después de la operación AUTHORIZE inicial para transferir fondos de la cuenta del pagador a su cuenta. Una transacción CAPTURE siempre debe ir precedida de una autorización exitosa. La moneda usada al capturar un monto debe coincidir con la moneda usada en la transacción de autorización.
Normalmente el motor de pagos o el host del adquirente agrupa por lote las operaciones Capture, por lo que los fondos no se transfieren efectivamente hasta que se cierra el lote y se produce la liquidación.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "100.00",
"currency": "EUR"
}
}
Para capturar una operación Authorization realizada fuera del motor de pagos, consulte Standalone Capture.
Uso de capturas excesivas
El monto total que usted capture puede sobrepasar el monto autorizado original si se habilita el privilegio Realizar capturas excesivas en el perfil del negocio.
La captura excesiva es una variación de la transacción CAPTURE en la que se realiza una captura por un monto mayor al autorizado. El exceso permitido se especifica como un porcentaje del monto autorizado original y your payment service provider lo determina.
Cuando se envíe una solicitud de CAPTURE excesiva, el motor de pagos intentará actualizar automáticamente el monto de autorización al monto que se desee capturar. Si el adquirente permite la actualización de autorizaciones, el motor de pagos envía la solicitud UPDATE AUTHORIZATION al adquirente. Si no, el motor de pagos aprueba automáticamente una actualización de autorización (hasta el límite de captura excesiva configurado para el perfil del negocio).
Si no desea que el motor de pagos intente actualizar la autorización antes de enviar la captura al adquirente, establezca el campo transaction.authorizationAjustmentAction en NO_ACTION en la solicitud.
Chargeback
Se produce una transacción CHARGEBACK cuando un pagador disputa un pago realizado a usted. Por ejemplo, los bienes no se recibieron o el pagador no le autorizó el pago. Your payment service provider puede importar los detalles de las transacciones CHARGEBACK en el motor de pagos para que estén disponibles con fines de búsqueda y reportería. Your payment service provider puede registrar cada transacción CHARGEBACK contra el pedido original o crear un nuevo pedido con una transacción CHARGEBACK independiente.
- Si comparte su Número SE o ID bancario del negocio (el identificador que su banco adquirente le asigna) en múltiples perfiles de negocio, se crea una transacción de contracargo independiente para cada perfil.
- El motor de pagos registra las transacciones de contracargo solo con fines informativos; la transacción no se envía para el procesamiento posterior al adquirente.
El motor de pagos puede crear múltiples transacciones de contracargo para un solo pedido. Puede realizar transacciones posteriores en un pedido que contenga una transacción de contracargo, por ejemplo, anulaciones o reembolsos.
Una transacción CHARGEBACK registrada correctamente devuelve los siguientes campos en las respuestas de transacción RETRIEVE TRANSACTION y RETRIEVE ORDER:
- order.status
Cuando se crea una transacción de contracargo, el estado del pedido correspondiente se actualiza para representar que existe una disputa que ha planteado un pagador.
- order.status
DISPUTED indica que se plantea una disputa pero aún no se han movido fondos.
- order.status
CHARGEBACK_PROCESSED indica que se procesó una reclamación de contracargo y que los fondos se moverán desde o hacia la cuenta del negocio.
- order.status
- order.chargeback.amount: monto del contracargo.
- order.chargeback.currency: moneda del contracargo.
- transaction.dispute object: información sobre la disputa de contracargo, por ejemplo, evento y fecha de la disputa.
- transaction.type: CHARGEBACK
- transaction.source: SERVICE_PROVIDER
- gatewayEntryPoint: SERVICE_PROVIDER_API
Disbursement
Con la transacción DISBURSEMENT, puede enviar fondos a la cuenta de la tarjeta de un pagador, por ejemplo, para ganancias de juegos o apuestas o al pagar la factura de la tarjeta de crédito de un pagador.
En una solicitud de DISBURSEMENT, no se requieren los detalles de facturación y envío del pagador y la validación del código de seguridad de tarjeta (CSC) no es aplicable.
Una transacción DISBURSEMENT puede ser una transacción inicial (sin transacciones relacionadas anteriores) o una transacción posterior después de una transacción VERIFY utilizada para verificar los detalles de la cuenta del pagador.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "DISBURSEMENT",
"disbursementType": "GAMING_WINNINGS",
"order": {
"amount": "100.00",
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
}
}
Pay
La transacción PAY (también conocida como "compra" o "venta") combina AUTHORIZE y CAPTURE en un solo mensaje. Una sola transacción autoriza el pago y transfiere fondos de la cuenta de su pagador a su cuenta de una sola vez. Puede proporcionar un indicador en la solicitud PAY para aplazar la autorización. Para obtener más información, consulte Aplazamiento de autorizaciones.
Una operación PAY puede ser una transacción inicial (sin transacciones relacionadas anteriores) o una transacción posterior después de una transacción VERIFY utilizada para verificar los detalles de la cuenta del pagador. En este último caso, los datos de la tarjeta en las solicitudes VERIFY y PAY deben coincidir.
El nivel de certeza de pedido para una transacción PAY se define en FINAL. Para obtener más información, consulte Establecimiento de la certeza del pedido.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "PAY",
"order": {
"amount": "100.00",
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
}
}
Usando la captura automática
La captura automática es una variante de la transacción PAY que permite a un negocio realizar una transacción PAY con un adquirente que solo admite transacciones AUTHORIZE y CAPTURE. Cuando el motor de pagos recibe una solicitud PAY y determina que el adquirente no la admite, el motor de pagos transforma automáticamente la solicitud PAY en una solicitud AUTHORIZE, seguida de una transacción CAPTURE activada automáticamente.
Para esto, your payment service provider debe habilitar el privilegio PAY en su perfil del negocio. El identificador de transacción para las solicitudes AUTHORIZE y CAPTURE será el identificador de transacción proporcionado por usted en la solicitud PAY original. En la respuesta de PAY, el campo transaction.type indica la última transacción que se intentó cumplir con la solicitud (AUTHORIZE o CAPTURE).
Puede utilizar la operación RETRIEVE TRANSACTION para recuperar los resultados de una captura automática. Se devuelve el resultado de la última transacción intentada para cumplir con la solicitud.
Puede anular una transacción PAY capturada automáticamente utilizando la transacción VOID. Cuando envía una solicitud VOID para una captura automática, el motor de pagos:
- Intenta una operación VOID para la transacción CAPTURE.
- Si esa primera operación VOID se realiza correctamente, se intenta una segunda operación VOID para la transacción AUTHORIZATION. Si la primera operación VOID no tiene éxito, la respuesta indica que la operación VOID falló y no se intenta una segunda operación VOID.
Referral
La transacción REFERRAL es necesaria cuando una transacción AUTHORIZE o PAY falla con una respuesta del adquirente "Consultar al emisor" (proporcionada en el campo respuesta.gatewaycode de la respuesta).
Es posible que se requiera que el pagador proporcione información adicional para que el emisor apruebe la transacción y proporcione un código de autorización o ID de autorización manual.
Utilice la transacción REFERRAL para volver a enviar la transacción inicial referida como una nueva transacción AUTHORIZE o PAY con un código de autorización obtenido del emisor.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "REFERRAL",
"transaction": {
"authorizationCode": "123456"
}
}
Refund
Con la transacción REFUND, puede acreditar fondos de un pedido existente a la cuenta del pagador si, por ejemplo, devuelve productos no deseados, incorrectos o defectuosos. Los reembolsos solo se pueden realizar cuando una transferencia de fondos se completa mediante una transacción PAY, CAPTURE o STANDALONE CAPTURE.
Puede realizar cualquier cantidad de transacciones REFUND en la transacción original, pero no puede reembolsar más que el monto total obtenido a través de las transacciones PAY o CAPTURE asociadas con el pedido.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "REFUND",
"transaction": {
"amount": "100.00",
"currency": "EUR"
}
}
Usando la autorización de reembolso
Antes de enviar su solicitud de reembolso al adquirente para su compensación y liquidación, de forma predeterminada, el motor de pagos intenta automáticamente autorizar su reembolso con el emisor (cuando lo admite el adquirente). Esto permite a los emisores verificar los detalles de la tarjeta proporcionados en la solicitud de reembolso para garantizar que el reembolso se realice correctamente.
La autorización de reembolso se realiza online y devuelve una respuesta en tiempo real. Esto tiene muchos beneficios:
- Recibirá una notificación inmediata de los emisores de tarjetas si no se puede realizar el reembolso y podrá tomar las medidas adecuadas. Por ejemplo, si la tarjeta utilizada para la transacción REFUND ya no es válida, el emisor rechaza la autorización de reembolso. Puede ponerse en contacto con el pagador para concertar un reembolso a través de un instrumento de pago diferente.
- El emisor de la tarjeta recibe una notificación inmediata de la solicitud de reembolso, lo que permite que los emisores muestren instantáneamente información sobre el reembolso al pagador. También les permite administrar consultas/quejas de los pagadores de forma eficaz.
Si no desea que el motor de pagos envíe solicitudes de autorización para sus transacciones REFUND, comuníquese con your payment service provider para habilitar el privilegio Habilitar reembolsos sin autorizaciones. Incluso cuando tenga este privilegio habilitado, puede solicitar autorización para un reembolso específico configurando el campo action.refundAuthorization en true en la solicitud de REFUND.
Si la autorización de reembolso tiene éxito, el motor de pagos procede con el reembolso. El resultado de la transacción REFUND se devuelve en la respuesta. Puede ver el código de autorización recibido del emisor en Merchant Administration.
Reembolsar una captura específica
Si se realizan múltiples capturas para un solo pedido, debe identificar qué capturas reembolsar cuando se reembolse todo o parte del pedido:
- Para reembolsar una captura específica en Merchant Administration, seleccione la captura específica en la sección Refund e ingrese el monto del reembolso. Si el pedido tiene varias capturas, se muestra una nueva ventana de interfaz de usuario que le permite seleccionar qué captura reembolsar.
- Para reembolsar una captura específica con una solicitud de API, incluya el campo transaction.targetTransactionld en la solicitud para identificar la captura específica que se reembolsará y configúrelo en el ID de transacción de la solicitud CAPTURE aplicable.
Usar reembolsos excesivos
El monto total reembolsado de un pedido puede exceder el monto capturado correctamente, si el privilegio Realizar reembolsos excesivos está habilitado en su perfil del negocio.
El exceso permitido sobre el monto capturado para transacciones API se puede configurar en función de cada moneda, en la página Admin > Ajustes de integración en Merchant Administration. Si no establece un límite de reembolso excesivo para una moneda, se rechazarán los reembolsos excesivos para pedidos en esa moneda.
Cuando se envía un reembolso, el monto total reembolsado para el pedido (incluso el reembolso intentado) no debe superar el monto total capturado para ese pedido por sobre el exceso máximo permitido. Por ejemplo, si envía un reembolso excesivo a través de API para un pedido donde el monto total capturado es 100 USD y ha establecido el límite de reembolso excesivo para transacciones API como 20 USD, puede reembolsar hasta 120 USD.
Standalone Capture
Una transacción STANDALONE CAPTURE es una transacción CAPTURE donde la autorización se realizó fuera del motor de pagos. Al enviar una solicitud STANDALONE CAPTURE al motor de pagos, debe proporcionar el código de autorización generado externamente en el campo transaction.authorizationCode. También debe proporcionar todos los detalles de la tarjeta que normalmente proporcionaría como campos obligatorios en una transacción AUTHORIZATION, ya que el motor de pagos aún no tiene esa información debido a la autorización externa.
Puede enviar transacciones STANDALONE CAPTURE si tiene habilitado el privilegio Realizar capturas independientes en su perfil del negocio.
Si necesita capturar un monto mayor al que ha autorizado, consulte Uso de capturas excesivas.
Puede proporcionar un indicador en la solicitud STANDALONE CAPTURE para indicar que la autorización externa es una autorización diferida, cuando sea necesario. Para obtener más información, consulte Aplazamiento de autorizaciones.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "CAPTURE",
"order": {
"amount": "100.00",
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
},
"transaction": {
"authorizationCode": "123456",
"amount": "100.00",
"currency": "EUR"
},
}
Standalone Refund
Una transacción STANDALONE REFUND es una transacción REFUND que le permite transferir fondos desde su cuenta de vuelta al pagador, sin una compra previa. Puede utilizar una operación STANDALONE REFUND cuando desee acreditar la cuenta del pagador sin asociar ese crédito a una transacción anterior.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "REFUND",
"sourceOfFunds": {
"token": "<token>"
},
"transaction": {
"amount": "100.00",
"currency": "EUR"
}
}
Update authorization
La transacción UPDATE AUTHORIZATION le permite:
- Ampliar el período de validez de una autorización existente.
- Aumentar o disminuir opcionalmente el monto de la autorización.
Si solo desea extender el período de autorización, no envíe el campo transaction.amount en la solicitud. La fecha y hora de vencimiento de la autorización actualizada se devuelven en el campo authorizationResponse.autoExpiry en la respuesta de RETRIEVE TRANSACTION.
Si proporciona un monto de la transacción superior al monto de la autorización existente, se actualiza el monto de autorización con el monto nuevo. Por ejemplo, si el monto de autorización existente es de 100 USD y se indica 120 USD como monto de la transacción en la solicitud de UPDATE AUTHORIZATION, entonces el nuevo monto de autorización disponible para la captura será de 120 USD.
Si proporciona un monto de la transacción inferior al monto de la autorización existente, se actualiza el monto de autorización con el monto nuevo. Por ejemplo, si el monto de autorización existente es de 100 USD y se indica 80 USD como monto de la transacción en la solicitud de UPDATE AUTHORIZATION, entonces el nuevo monto de autorización disponible para la captura será de 80 USD. El motor de pagos procesa automáticamente una solicitud de reverso por el monto de autorización restante de 20 USD (cuando se admita para el adquirente).
El motor de pagos solo puede actualizar una autorización existente si se cumplen las siguientes condiciones:
- your payment service provider debe habilitar su perfil del negocio en el motor de pagos para el privilegio Actualizar autorización.
- La moneda del pedido debe coincidir con la moneda utilizada en la autorización existente.
- La autorización existente debe ser válida, correcta y debe estar totalmente aprobada.
- Para las transacciones con tarjeta Mastercard, al aumentar el monto de autorización se amplía automáticamente el período de validez de la autorización. Para otras marcas de tarjetas, las reglas del sistema determinan el efecto sobre el período de validez.
- La operación UPDATE AUTHORIZATION no es totalmente compatible con los adquirentes de S2I de ninguna marca de tarjeta. Solo pueden disminuir el monto de la autorización usando esta operación.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "UPDATE_AUTHORIZATION"
}
Gestión de totales de pedidos
Tras una solicitud UPDATE AUTHORIZATION correcta (para una tarjeta o para PayPal), el monto del pedido (order.amount) y el monto total autorizado (order.totalAuthorizedAmount) se actualizan con el monto de la transacción (transaction.amount) de UPDATE AUTHORIZATION. Esto se aplica independientemente de si la transacción UPDATE AUTHORIZATION se envió al adquirente o de si el motor de pagos la aprobó automáticamente (response.gatewayCode = APPROVED_AUTO).
Si elige ignorar la actualización de la autorización por una solicitud CAPTURE excesiva (enviando transaction.authorizationAdjustmentActions = NO_ACTION, consulte Uso de capturas excesivas) y el motor de pagos envía una transacción CAPTURE excesiva al adquirente, los totales del pedido no se actualizan.
Gestionar subtotales de pedidos
Puede proporcionar los siguientes montos subtotales en la solicitud UPDATE AUTHORIZATION para pagos con tarjeta o PayPal:
- order.itemAmount
- order.shippingAndHandlingAmount
- order.taxAmount
- order.discount.amount (solo pagos con tarjeta)
- order.gratuityAmount (solo pagos con tarjeta)
No se puede proporcionar order.cashbackAmount en la solicitud UPDATE AUTHORIZATION.
El motor de pagos no valida si los montos subtotales se suman al monto transaction.amount (order.amount).
Recargo
Puede actualizar un monto de recargo en la solicitud UPDATE AUTHORIZATION utilizando cualquiera de los siguientes campos:
- order.merchantCharge.amount: utilice este campo si proporciona un monto de recargo calculado previamente.
- order.merchantCharge.type: establezca este campo en SURCHARGE para indicar que el tipo de cargo es un recargo.
- order.netAmount: utilice este campo si el motor de pagos calcula el monto del recargo (según sus reglas de recargo). El monto neto es el monto a pagar por el pedido antes de que se aplique el recargo.
Verify
La transacción VERIFY le permite verificar los detalles de la cuenta del pagador antes de realizar una transacción PAY o AUTHORIZE. También verifica los detalles de pago mediante un método de verificación reconocido por el adquirente. Por ejemplo, si el motor de pagos determina que el adquirente admite el Servicio de verificación de dirección (AVS), el motor de pagos envía al adquirente una transacción de solo AVS con un monto de transacción de cero y los detalles de la dirección del pagador para obtener el resultado de la verificación.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "VERIFY",
"order": {
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
}
}
Void
La transacción VOID intenta eliminar o revertir inmediatamente una solicitud de transacción anterior.
Puede anular las transacciones AUTHORIZE, CAPTURE, PAY, REFUND, STANDALONE CAPTURE, STANDALONE REFUND y UPDATE AUTHORIZATION.
Para una transacción AUTHORIZE, una transacción VOID libera inmediatamente los fondos reservados. Para todos los demás tipos de transacciones, una transacción VOID evita que se realice la transferencia de fondos.
Para anular otras transacciones, no se envían al adquirente para su procesamiento al final del día. Una vez que el adquirente envía una transacción para su procesamiento, la operación VOID API fallará; en su lugar, deberá realizar una transacción REFUND.
| URL | https://mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Método HTTP | PUT |
{
"apiOperation": "VOID",
"transaction": {
"targetTransactionId": "<ID_of_transaction_to_be_voided>"
}
}