v.23.00.00 Casos de erro de Pix Agendado
Esta página reúne os requisitos e recomendações aplicáveis ao tratamento e a comunicação de erros na jornada de pagamento com Pix Agendado com e sem redirecionamento via Open Finance.
Mensagem de erro
A mensagem de erro deve comunicar o erro com clareza, explicar o que ocasionou o erro com linguagem simples e fornecer orientação e opções de ação para que o usuário consiga continuar.
Boas práticas de experiência considerando ospilares:
O que houve?
O que ocasionou o erro?
Orientações ao usuário.
Ação necessária para prosseguir.
Exemplo de erro:
QR Code inválido. O QR Code informado é inválido ou não pôde ser lido corretamente.
O que houve?
A solicitação de pagamento não pode ser iniciada.
O que ocasionou o erro?
O QR Code informado é inválido.
Orientações ao usuário
Tentar novamente com outro QR Code ou usar outra forma de pagamento.
Ações para prosseguir
Tentar novamente.
Mensagem de erro
QR Code inválido. O QR Code informado é inválido ou não pôde ser lido corretamente.
Sempre que possível, identificar se o problema ocorreu na Instituição Iniciadora de Transação de Pagamento (ITP) ou na Instituição Detentora de Conta (ID), além do tipo de erro.
Quando o erro acontecer em ambiente da ID, esta deverá redirecionar o usuário ao ambiente da ITP junto com o código do erro específico, conforme as possibilidades descritas no Diagrama de Sequência — Momento 3 - Etapa de Autorização do Cliente, disponível no Portal do Desenvolvedor, onde deverá ocorrer a tratativa.
A tratativa na ITP deverá ser o mais específica possível a fim de evitar erros genéricos.
Os casos de erros devem ser tratados conforme previsto nos regulamentos dos arranjos.
Os requisitos estão organizados por cenário, ações necessárias para resolver o erro e exemplos de mensagem para comunicar o erro de forma clara.
Para casos que não estejam cobertos nesta página, as instituições devem garantir que, diante de qualquer erro, o usuário seja sempre informado com clareza, sobre o que ocorreu e o que pode fazer a seguir.
Geral
Etapa 1: Solicitação
Etapa 2: Direcionamento
Etapa 3: Confirmação