> ## 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).

# Personnaliser les messages d'erreur

# Que sont les messages d'erreur ?

Chaque erreur renvoyée par Zru a un code d'erreur associé (par exemple `MC2P-02003` ou `MC2P-07003`). Par défaut, lorsqu'une opération échoue, le client voit un message générique de Zru. Cette section vous permet de **remplacer ce message** par votre propre texte dans plusieurs langues, aligné sur la voix de votre marque.

# Comment accéder aux Messages d'erreur

- Allez dans **Configuration** dans le menu latéral.
- Cliquez sur la tuile **« Messages d'erreur »**.

# La liste des messages

Depuis la liste vous pouvez rechercher des messages par code ou par texte. Pour chaque message vous verrez trois colonnes : **Code** (le code d'erreur remplacé), **Texte** (le début du texte personnalisé) et **Langues** (les drapeaux des langues configurées).

# Comment créer un message personnalisé

- Cliquez sur **« Nouveau message »** en haut à droite.
- La fenêtre **Ajouter** s'ouvre.
- Sélectionnez le **Code d'erreur** que vous voulez remplacer. Vous pouvez consulter la liste complète des codes sur [docs.zrupay.com/tools/errors](http://docs.zrupay.com/tools/errors).
- Saisissez le texte personnalisé dans les langues dont vous avez besoin. Il y a un champ pour chacune des **9 langues disponibles** : espagnol, anglais, portugais, catalan, allemand, italien, français, galicien et basque.
- Cliquez sur **« Créer »**.

# Cas d'usage typiques

- Reformuler des messages techniques en langage naturel. Par exemple, une erreur d'authentification 3DS peut être remplacée par « Nous n'avons pas pu vérifier votre carte. Veuillez en essayer une autre. »
- Ajouter des instructions pour que le client contacte votre support.
- Adapter le ton à votre public (B2B, B2C, secteurs réglementés...).

# Lien avec les Statistiques

La section **Statistiques** ▶︎ **Optimisation** contient le bloc **Erreurs par typologie**, qui montre quels codes surviennent le plus souvent dans votre compte et quel pourcentage représente chacun. Ce sont les candidats prioritaires à personnaliser ici : si un code concentre la majorité de vos erreurs, un message clair peut réduire la friction client et améliorer la conversion.