Personalizar as mensagens de erro
O que são as mensagens de erro?
Cada erro devolvido pelo Zru tem um código de erro associado (por exemplo MC2P-02003 ou MC2P-07003). Por defeito, quando uma operação falha, o cliente vê uma mensagem genérica do Zru. Esta secção permite-lhe substituir essa mensagem por um texto próprio em vários idiomas, alinhado com a voz da sua marca.
Como aceder às Mensagens de erro
- Vá a Configuração no menu lateral.
- Clique no mosaico «Mensagens de erro».
A lista de mensagens
A partir da lista pode procurar mensagens por código ou por texto. Para cada mensagem verá três colunas: Código (o código de erro que substitui), Texto (o início do texto personalizado) e Idiomas (as bandeiras dos idiomas em que está configurado).
Como criar uma mensagem personalizada
- Clique em «Nova mensagem» no canto superior direito.
- Abre-se a janela Adicionar.
- Selecione o Código de erro que pretende substituir. Pode consultar a lista completa de códigos em docs.zrupay.com/tools/errors.
- Escreva o texto personalizado nos idiomas de que precisar. Existe um campo para cada um dos 9 idiomas disponíveis: Espanhol, Inglês, Português, Catalão, Alemão, Italiano, Francês, Galego e Basco.
- Clique em «Criar».
Casos de uso típicos
- Reformular mensagens técnicas em linguagem natural. Por exemplo, um erro de autenticação 3DS pode ser substituído por «Não conseguimos verificar o seu cartão. Por favor, tente com outro.»
- Incluir instruções para que o cliente contacte o seu suporte.
- Adaptar o tom ao público-alvo (B2B, B2C, setores regulados...).
Ligação com as Estatísticas
A secção Estatísticas ▶︎ Otimização inclui o bloco Erros por tipologia, que mostra que códigos estão a ocorrer com mais frequência na sua conta e que percentagem representa cada um. Esses são os candidatos prioritários a personalizar aqui: se um código concentra a maioria dos seus erros, uma mensagem clara pode reduzir a fricção do cliente e melhorar a conversão.
Actualizado em: 21/08/2026
Obrigado!
