Cuando se rechaza una transacción, los Códigos de Aviso al Comerciante (MAC) proporcionan una guía clara sobre si es apropiado reintentar y cuándo. Para promover la transparencia y una toma de decisiones informada, las API públicas de Yuno incluyen códigos de respuesta normalizados y sin procesar. Al comprender los MAC, los comerciantes pueden identificar rápidamente el motivo de un rechazo y determinar las mejores acciones a tomar, como actualizar la ruta o la información del cliente antes de intentar un reintento.
Lista de MAC
Esta tabla muestra los códigos de asesoramiento comercial normalizados de Yuno (merchant_advice_code y merchant_advice_code_message) a sus equivalentes de Mastercard, Visa y Elo. Úselo como referencia para interpretar los motivos de rechazo, establecer reglas de reintento y aplicar estrategias de enrutamiento consistentes en todas las redes.
merchant_advice_code | merchant_advice_code_message | Tarjeta MasterCard | Visa | Elo |
|---|---|---|---|---|
| ACTUALIZAR_INFORMACIÓN | Se necesita información actualizada/adicional | 01 – Información de cuenta actualizada disponible | – | – |
| TRY_AGAIN_LATER | Vuelva a intentarlo dentro de 30 días | 02 – Inténtalo de nuevo más tarde | 3,19,3951,52,5359,60,6162,65,7578,86,9193,96,N3N4,Z5,5C9G | 51,59,0406,38,6162,65,7578,91 |
| DO_NOT_TRY_AGAIN | No lo intentes de nuevo | 03 – No lo intentes de nuevo | 4,7,1214,15,4143,46,57R0,R1,R3 | 57,14,5646,FM,1912,30,1323,41,4364,83,7677 |
| REQUISITOS_NO_CUMPLIDOS | Requisitos de token no cumplidos | 04 – No se cumplen los requisitos del token | – | – |
| NO_RETRY_LIFE_CYCLE | Sin ciclo de vida de reintento | 21 – Plan recurrente cancelado | – | – |
| RETRY_AFTER_1_H | Inténtalo de nuevo después de 1 hora | 24 – Vuelva a intentarlo después de 1 hora (fondos insuficientes) | – | – |
| REINTENTO_DESPUÉS_24_H | Inténtalo de nuevo después de 24 horas | 25 – Vuelva a intentarlo después de 24 horas (fondos insuficientes) | – | – |
| REINTENTAR_DESPUÉS_2_D | Inténtalo de nuevo después de 2 días | 26 – Vuelva a intentarlo después de 2 días (fondos insuficientes) | – | – |
| REINTENTAR_DESPUÉS_4_D | Inténtalo de nuevo después de 4 días | 27 – Vuelva a intentarlo después de 4 días (fondos insuficientes) | – | – |
| REINTENTO_DESPUÉS_6_D | Inténtalo de nuevo después de 6 días | 28 – Vuelva a intentarlo después de 6 días (fondos insuficientes) | – | – |
| RETRY_AFTER_8_D | Inténtalo de nuevo después de 8 días | 29 – Vuelva a intentarlo después de 8 días (fondos insuficientes) | – | – |
| RETRY_AFTER_10_D | Inténtalo de nuevo después de 10 días | 30 – Vuelva a intentarlo después de 10 días (fondos insuficientes) | – | – |
| NO_RETRY_POLICY | Política de no reintento | 40 – Tarjeta prepago no recargable | – | – |
| NO_RETRY_SECURITY | Sin seguridad de reintento | 42 – Puntuación de sanción excedida | – | – |
| TARJETA_USO_MÚLTIPLE | Tarjeta virtual de usos múltiples | 43 – Tarjeta virtual de usos múltiples | – | – |
| DATOS_INVÁLIDOS | Información de pago incorrecta; el comerciante debe revalidar antes de volver a intentarlo | – | 54,55,82N7,1A,706P | 54,55,8263 |
Campos MAC en las transacciones
La API pública de Yuno incluye campos dedicados para facilitar el uso de códigos de asesoramiento comercial.
MAC normalizadas
Yuno ofrece un conjunto estandarizado de Códigos de Asesoramiento Comercial que simplifican las respuestas de los proveedores. Estos códigos permiten crear lógica de reintento y reglas de enrutamiento sin necesidad de gestionar las variaciones únicas de cada proveedor.
transactions.merchant_advice_code: Un MAC normalizado por Yuno que se devuelve cuando se rechaza una transacción. Este código le ayuda a comprender el motivo del rechazo, si es posible reintentar el pago y qué acciones tomar antes de reintentarlo.transactions.merchant_advice_code_message: Este campo complementa elmerchant_advice_codeComo se muestra arriba, se proporciona una explicación del código en términos legibles. Este mensaje le permitirá actuar según la información sin tener que memorizar el significado de cada código.
MACs sin procesar
Además de los valores normalizados, Yuno también expone los códigos y mensajes originales devueltos por los proveedores. Estos campos sin procesar garantizan una transparencia total y permiten solucionar problemas o seguir las instrucciones específicas del proveedor cuando sea necesario.
transactions.provider_data.merchant_advice_codeEl código de aviso comercial original, devuelto directamente por el proveedor de pagos. Este campo le da acceso al código sin procesar para una total transparencia y resolución de problemas.transactions.provider_data.merchant_advice_code_messageUn mensaje legible del proveedor que explica el significado de la MAC sin procesar. Úselo para comprender las instrucciones específicas del proveedor sin necesidad de interpretar los valores del código.
Tenga en cuenta que estos campos se encuentran dentro del
transactionsobjeto en las respuestas de la API.
Acerca de los reintentos
Cuando se rechaza una compra con tarjeta, cualquier intento posterior de completarla con la misma tarjeta se considera un reintento. Las comisiones y los límites de reintento están definidos por cada red de tarjetas. El número de reintentos permitidos antes de que se apliquen las comisiones varía según la marca. A los comercios que no cumplan con esta normativa se les podrían cobrar comisiones por transacciones superadas.
La industria de pagos, junto con ABECS, estandarizó los códigos de respuesta para el rechazo de transacciones con tarjeta. Estos intentos se clasifican en dos tipos:
- Reversible: Una denegación potencialmente temporal que puede cambiar con el tiempo. El emisor puede denegar la transacción debido a fondos insuficientes, problemas del sistema o demasiados intentos fallidos de PIN.
- Irreversible: Cualquier autorización tras un rechazo irreversible que no cambie los campos del mensaje fallará. Esto podría significar que la tarjeta ha sido cancelada o que se ha confirmado un fraude.
Visa, Mastercard y Elo actualizaron sus políticas para limitar los reintentos de autorización tras un rechazo y cobran comisiones por los intentos que superen esos límites. Consulta las normas de cada marca a continuación.
Tarjeta MasterCard
Mastercard gestiona las MAC como parte de su programa de Excelencia en el Procesamiento de Transacciones (TPE), que tiene dos componentes principales:
Intentos de autorización excesivos
El TPE de Mastercard tiene como objetivo monitorear constantemente la utilización de la red para detectar y prevenir el exceso de solicitudes de autorización. Mastercard también monitorea las transacciones aprobadas por montos muy pequeños (menos de una unidad monetaria) que posteriormente se reembolsan, ya que esto puede indicar actividad de prueba de la tarjeta.
Este monitoreo aplica tanto a compras rechazadas como aprobadas. Un reintento se define como cualquier nuevo intento de autorizar un pago con la misma tarjeta y el mismo comercio. Las normas de Mastercard establecen límites diarios y mensuales según la región (por ejemplo, no más de 10 intentos al día o 35 reintentos al mes). Superar cualquiera de estos límites puede resultar en cargos adicionales.
Códigos de asesoramiento para comerciantes de Mastercard (MAC)
Mastercard utiliza las MAC para ayudar a los comerciantes a comprender cuándo es apropiado reintentar una transacción. Algunos rechazos son irreversibles, lo que significa que no se debe reintentar la transacción, a menudo porque la tarjeta está cerrada o se confirma un fraude.
El programa TPE rastrea específicamente los reintentos tras estos rechazos irreversibles, centrándose en dos códigos: MAC 03 ("No volver a intentarlo") y MAC 21 ("Ciclo de vida sin reintentos"). Si intenta procesar la misma tarjeta y el mismo importe de nuevo después de recibir uno de estos códigos, Mastercard podría cobrarle una comisión.
Otras MAC, como aquellas que indican un problema temporal o fondos insuficientes, no generan tarifas de Excelencia en Transacciones MAC, pero aún así se le podría cobrar según el programa de Intentos de Autorización Excesivos si excede los límites de reintentos.
En algunos casos, las MAC recomiendan esperar un tiempo específico antes de reintentar (por ejemplo, "Reintentar después de 24 horas"). Esto te ayuda a elegir el mejor momento para volver a intentarlo.
Vea todos los MAC de Mastercard y sus equivalentes normalizados por Yuno en la lista de MAC.
Visa
Los MAC de Visa se organizan en cuatro categorías. El objetivo es mantener el ecosistema equilibrado, reducir los reintentos innecesarios y exigir a los emisores que utilizan códigos de rechazo precisos y no genéricos.
Tarifas de visaDado que son irreversibles, los códigos de categoría 1 tienen un cargo a partir del segundo intento. Las categorías 2, 3 y 4 permiten hasta 20 intentos en un plazo de 30 días, con cargos a partir del vigésimo primer intento. Transcurridos 30 días desde el primer intento, se cobra cualquier reintento. Las comisiones de Visa son las siguientes:
- Nacional: 0,10 USD + 13,83% de impuestos
- Transfronterizo: 0,25 USD + 13,83% de impuestos
Categoría 1 (el emisor nunca lo aprobará)
Irreversible: indica que la tarjeta fue cancelada o nunca existió, o que la denegación se debe a una restricción permanente o un error que impedirá futuras aprobaciones. Se aplican cargos desde el segundo intento.
- Los códigos comunes de categoría 1 pueden incluir:
04,07,12,15,41,43,46,57,R0,R1,R3
Categoría 2 (el emisor no puede aprobarlo en este momento)
Reversible: significa que la denegación se debe a una condición temporal, como un riesgo crediticio u otras restricciones de la tarjeta, que podrían permitir que se apruebe un nuevo intento de transacción. En algunos casos, el titular o el emisor de la tarjeta deben tomar medidas para eliminar la restricción antes de la aprobación.
- Los códigos comunes de categoría 2 pueden incluir:
03,19,39,51,52,53,59,61,62,65,75,78,86,91,93,96,N3,N4,Z5,5C,9G
Categoría 3 (calidad de los datos)
Reversible, se activa por un error de datos identificado por el emisor. Los comercios deben revalidar los datos de pago antes de reintentar. Estos códigos de denegación pueden indicar posibles riesgos de fraude para los comercios.
- Los códigos comunes de categoría 3 pueden incluir:
14,54,55,70,82,1A,6P,N7
Cargos de categoría 3Los comercios pueden tener hasta 25,000 transacciones rechazadas por errores de calidad de datos (categoría 3) en un período de 30 días. Si supera este límite, Visa cobrará una comisión por cada transacción rechazada adicional en esta categoría.
Categoría 4 (códigos de respuesta genéricos)
Reversible, incluye todos los demás códigos de respuesta de rechazo no incluidos en las categorías 1, 2 y 3, ya que puede haber casos en los que no exista un valor de código de respuesta para un rechazo específico. Los emisores pueden utilizar otros valores de código de respuesta definidos en las especificaciones técnicas de VisaNet. Sin embargo, se recomienda un uso mínimo.
Todos los MAC de Visa y sus equivalentes normalizados por Yuno están disponibles en la lista de MAC.
Elo
Elo implementó normas en enero de 2025 con el objetivo de reducir los reintentos innecesarios por parte de comerciantes y adquirentes. Las transacciones se contabilizan del primer al último día natural del mes.
Tarifas de EloBRL 0,80 por intento que exceda el límite del grupo.
Grupos Elo y reglas de reintento
Elo clasifica los códigos reversibles e irreversibles en tres grupos separados:
| Grupo | Descripción | Regla de carga |
|---|---|---|
| Grupo 1 (Irreversible) | Transacciones denegadas con códigos irreversibles (misma tarjeta, mismo establecimiento CNPJ, mismo importe) | Se cargará a partir del segundo intento dentro del mes de evaluación. |
| Grupo 2 (Reversible) | Transacciones rechazadas con códigos reversibles | Cargado a partir del 16º intento dentro del mes de evaluación |
| Grupo 3 (Calidad de los datos) | Declives con características de ataques de fuerza bruta (considerando el mismo comerciante Root CNPJ) | Se cobrarán 10.001 transacciones denegadas si >5% del total de rechazos |
“CNPJ” se refiere al número de identificación fiscal del establecimiento (CNPJ raíz a nivel de grupo) en Brasil.
Consulte la lista detodos los MACde Elo ylos equivalentes normalizados de Yuno.
Otras marcas
- Códigos reversibles: Se permiten reintentos para el mismo cliente y tarjeta. No hay límite ni plazo preestablecido.
AtenciónAntes de intentarlo nuevamente, siga las instrucciones recibidas en la respuesta de transacción denegada.
- Códigos irreversibles: No se permitirán autorizaciones para la misma tarjeta o establecimiento después de recibir la primera respuesta negativa del emisor.
Enrutamiento con MAC
El comportamiento de reintento debe implementarse mediante condiciones de enrutamiento. Actualizar las rutas para incluir las nuevas condiciones MAC.
Al crear un grupo de rechazo en el panel de control de Yuno, puede elegir añadir condiciones por Código de Respuesta o por Código MAC.
Período de transiciónHasta que todas las integraciones emitan la MAC por separado, algunos valores MAC aparecerán tanto en los códigos de respuesta como en los códigos MAC. Esto es previsible mientras se completa el despliegue de la función.
