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.
- 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.
Mis à jour le : 21/08/2026
Merci !
