> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Personalizar Mensajes de error

# ¿Qué son los Mensajes de error?

Cada error que devuelve Zru tiene un código de error asociado (por ejemplo `MC2P-02003` o `MC2P-07003`). Por defecto, cuando una operación falla, el cliente ve un mensaje genérico de Zru. Esta sección te permite **sobrescribir ese mensaje** con un texto propio en múltiples idiomas, alineado con la voz de tu marca.

# Cómo acceder a Mensajes de error

- Ve a **Configuración** en el menú lateral.
- Haz clic en el tile **"Mensajes de error"**.

# El listado de mensajes

Desde el listado puedes buscar mensajes por código o por texto. Para cada mensaje verás tres columnas: **Código** (el código de error que sobrescribe), **Texto** (el inicio del texto personalizado) e **Idiomas** (las banderas de los idiomas en que está configurado).

# Cómo crear un mensaje personalizado

- Haz clic en **"Nuevo mensaje"** arriba a la derecha.
- Se abrirá el modal **Añadir**.
- Selecciona el **Código de error** que quieres sobrescribir. Puedes consultar la lista completa de códigos en [docs.zrupay.com/tools/errors](http://docs.zrupay.com/tools/errors).
- Escribe el texto personalizado en los idiomas que necesites. Hay un campo para cada uno de los **9 idiomas** disponibles: Español, Inglés, Portugués, Catalán, Alemán, Italiano, Francés, Gallego y Euskera.
- Haz clic en **"Crear"**.

# Casos de uso típicos

- Reformular mensajes técnicos en lenguaje natural. Por ejemplo, un error de autenticación 3DS puede sustituirse por "No hemos podido verificar tu tarjeta. Por favor, prueba con otra."
- Incluir instrucciones para que el cliente contacte con tu soporte.
- Adaptar el tono al público objetivo (B2B, B2C, sectores regulados...).

# Conexión con Estadísticas

La sección **Estadísticas** ▶︎ **Optimización** incluye el bloque **Errores por tipología**, que muestra qué códigos están ocurriendo con más frecuencia en tu cuenta y qué porcentaje representa cada uno. Esos son los candidatos prioritarios para personalizar aquí: si un código concentra la mayoría de tus errores, un mensaje claro puede reducir la fricción del cliente y mejorar la conversión.