Casos de erro de Vinculação de Conta (JSR)

Esta página reúne os requisitos e recomendações aplicáveis ao tratamento e a comunicação de erros na jornada de Vinculação de Conta para pagamentos sem redirecionamento (JSR) 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.
  

• O que houve?

  • A solicitação não pôde ser cancelada.
    

• O que ocasionou o erro?

  • Uma indisponibilidade do sistema.
    

• Orientações ao usuário

  • Tentar novamente mais tarde.
    

• Ações para prosseguir

  • Tentar novamente.
    

• Mensagem de erro

  • Falha no cancelamento. Não foi possível cancelar o vínculo de conta. Tente novamente mais tarde.

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

Cenário: Erro genérico na ITP

1. Mensagem de erro: exibir mensagem de erro clara, orientando o usuário sobre como prosseguir.

Etapa 2: Direcionamento

Cenário: Erros no direcionamento ITP > ID

1. Erro genérico de direcionamento: informar o usuário sobre a impossibilidade de direcioná-lo para a ID em caso de erro genérico.

• Ações para prosseguir: tentar novamente mais tarde. 

• Exemplo de mensagem: não foi possível te direcionar para a [Detentora] para confirmar a transação. Tente novamente mais tarde. 

Etapa 3: Confirmação

Cenário: Erro genérico na ID

1. Mensagem de erro: comunicar o erro com clareza, orientando o usuário sobre como prosseguir.

Cenário: Erros na autenticação/confirmação

1. Falha de infraestrutura: informar o usuário sobre a impossibilidade de concluir a autenticação/confirmação devido à falha de infraestrutura.

• Ações para prosseguir: tentar novamente mais tarde.  

• Exemplo de mensagem:  Tivemos um problema com sua autenticação. Tente novamente mais tarde.

2. Dados divergentes: informar o usuário sobre a impossibilidade de concluir a autenticação devido à divergência dos dados informados na ITP.

• Ações para prosseguir: tentar novamente com os dados corrigidos. / Alterar a conta de origem, se necessário. 

• Exemplo de mensagem: Não foi possível prosseguir com a solicitação. Os dados informados não coincidem com os registrados na sua instituição. Verifique e tente novamente com as informações corretas. 
   

3. Conta indisponível: informar o usuário sobre a indisponibilidade da conta impedindo-o de confirmar a solicitação através da desabilitação da conta.

• Ações para prosseguir: tentar novamente com outra conta de origem ou outra ID. 

• Exemplo de mensagem: Conta indisponível. Ex.: tag

4. Sessão expirada: informar o usuário sobre a expiração do tempo para confirmação da solicitação.

• Ações para prosseguir: iniciar nova solicitação. 

• Exemplo de mensagem: Sessão expirada. A solicitação não foi realizada pois o tempo expirou. Tente novamente. 

Cenário: Tratativa de erro pós-cancelamento por parte do usuário 

1. Manutenção do cancelamento: respeitar a decisão do usuário de cancelar a solicitação mesmo que o cancelamento ocorra após a validação de algum erro (Ex.: Conta indisponível).

Cenário: Erros na tentativa de confirmação

1. Prazo expirado: informar sobre a expiração do prazo para efetivação da solicitação autorizada o pelo usuário.

• Ações para prosseguir: iniciar nova solicitação. 

• Exemplo de mensagem: Falha na solicitação. Sua solicitação falhou devido a problemas internos na [Iniciadora]. Tente novamente.

Etapa 4: Redirecionamento

Cenário: Erros no redirecionamento ID > ITP

1. Erro genérico de redirecionamento: quando a solicitação não puder ser confirmada por conta de erros como indisponibilidade da conta, saldo insuficiente, falha de infraestrutura ou outros impedimentos, redirecionar o usuário para a ITP.

• Ações para prosseguir: -

• Exemplo de mensagem: -

Etapa 5: Efetivação

Cenário: Erros na efetivação

1. Sistema indisponível: informar o usuário sobre a indisponibilidade do sistema e sobre a possibilidade de a solicitação ter sido concluída no backend.

• Ações para prosseguir: Verificar se a solicitação foi efetivada na ID./Tentar novamente mais tarde caso a solicitação não tenha sido efetivada. 

• Exemplo de mensagem: Sistema indisponível. Verifique na sua instituição se a solicitação foi concluída. Caso não tenha sido, tente novamente mais tarde.

2. Falha na efetivação da Jornada Otimizada: em caso de falha na Jornada Otimizada, informar o usuário que a solicitação de Vinculação de Conta foi efetivada, mas o compartilhamento de saldo e limite falhou.

• Ações para prosseguir: orientar o usuário conforme estratégia da instituição. 

• Exemplo de mensagem: Falha no compartilhamento de saldo e limite. O vínculo de conta com a [Instituição] foi criado, mas o compartilhamento de saldo e limite falhou.  

Cenário: Otimização da solicitação em caso de erro 

1. Manutenção dos dados da solicitação: ao receber o usuário de volta após a identificação do erro, otimizar a nova solicitação, mantendo os dados corretos já preenchidos e indicando a alteração apenas da informação que causou o erro.

Gestão na ITP

Cenário: Erros na gestão

1. Falha no cancelamento da solicitação: informar o usuário sobre o erro no cancelamento da solicitação.

• Ações para prosseguir: tentar novamente mais tarde. 

• Exemplo de mensagem:  Falha no cancelamento. Não foi possível cancelar o vínculo de conta. Tente novamente mais tarde.

Cenário: Erros na gestão - Jornada Otimizada

1. Falha no cancelamento do compartilhamento de saldo e limite: informar o usuário que o cancelamento do compartilhamento de saldo e limite falhou.

• Ações para prosseguir: tentar novamente mais tarde. 

• Exemplo de mensagem: Tivemos um problema com o cancelamento do compartilhamento de saldo e limite. Tente novamente.

Gestão na ID

Cenário: Erros na gestão

1. Falha no cancelamento da solicitação: informar o usuário sobre o erro no cancelamento da solicitação.

• Ações para prosseguir: tentar novamente mais tarde. 

• Exemplo de mensagem:  Falha no cancelamento. Não foi possível cancelar o vínculo de conta. Tente novamente mais tarde.

2. Falha na alteração da solicitação: informar o usuário sobre o erro na alteração de algum parâmetro da solicitação.

• Ações para prosseguir: tentar novamente mais tarde. 

• Exemplo de mensagem: Falha na alteração. Não foi possível realizar essa alteração. Tente novamente mais tarde. 

Cenário: Erros na gestão - Jornada Otimizada

1. Falha no cancelamento do compartilhamento de saldo e limite: informar o usuário que o cancelamento do compartilhamento de saldo e limite falhou.

• Ações para prosseguir: tentar novamente mais tarde. 

• Exemplo de mensagem: Tivemos um problema com o cancelamento do compartilhamento de saldo e limite. Tente novamente.