Guia de Experiência Open Finance Brasil

Casos de erro na Jornada Otimizada em Transferências Inteligentes

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-10704 Informar 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

image-20251125-221213.png
Falha na efetivação da Jornada Otimizada - ITP

Gestão na ITP

Requisitos - ITP

Cenário: Erros na gestão do compartilhamento de saldo e limite via Jornada Otimizada

  • REQ.PG-11003 Informar 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.

image-20260624-143204.png
Falha no cancelamento do compartilhamento de saldo e limite


Gestão na ID

Requisitos - ID

Cenário: Erros na gestão do compartilhamento de saldo e limite via Jornada Otimizada

  • REQ.PG-11003 Informar 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.

image-20260624-143134.png
Falha no cancelamento do compartilhamento de saldo e limite