Esta página reúne os requisitos e recomendações aplicáveis ao tratamento e a comunicação de erros na Jornada Otimizada em Transferências Inteligentes 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 os pilares:
-
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.
Etapa 5: Efetivação
Requisitos - ITP
-
✅
REQ.PG-10704Informar ao usuário se a solicitação de Transferências Inteligentes for efetivada e o compartilhamento de saldo e limite via Jornada Otimizada falhar.-
Ações para prosseguir: orientar o usuário conforme estratégia da instituição.
-
Exemplo de mensagem: Falha no compartilhamento de saldo e limite. A autorização de Transferências Inteligentes foi criada, mas o compartilhamento de saldo e limite falhou.
-
Gestão na ITP
Requisitos - ITP
Cenário: Erros na gestão do compartilhamento de saldo e limite via Jornada Otimizada
-
✅
REQ.PG-11003Informar ao usuário sobre falha no cancelamento do compartilhamento de saldo e limite. -
Ações para prosseguir: tentar novamente.
-
Exemplo de mensagem: Falha no cancelamento. Tivemos um problema com o cancelamento do compartilhamento de saldo e limite. Tente novamente.
Gestão na ID
Requisitos - ID
Cenário: Erros na gestão do compartilhamento de saldo e limite via Jornada Otimizada
-
✅
REQ.PG-11003Informar ao usuário sobre falha no cancelamento do compartilhamento de saldo e limite. -
Ações para prosseguir: tentar novamente.
-
Exemplo de mensagem: Falha no cancelamento. Tivemos um problema com o cancelamento do compartilhamento de saldo e limite. Tente novamente.