Falhas na criação de Banco Digital

Pré-requisitos de acesso

• Permissão (módulo): digitalAccountErrors
• Licença/Feature: DIGITAL_BANKING habilitada na licença do tenant
• Contêiner do menu: GERAL → grupo Auditoria

O que é / quando usar

A tela Falhas na criação de Banco Digital (/digital-account-errors) lista as tentativas de abertura de conta digital (banco digital via BaaS) que ficaram pendentes ou falharam no provedor. Cada registro guarda o userId, o provedor, o código de erro, o payload de abertura enviado e o payload de erro retornado.

Use esta tela para diagnosticar por que a conta de um usuário não foi aberta no banco digital, reprocessar/encaminhar a correção e marcar o caso como resolvido. É a camada de auditoria que sobrevive a um crash do provedor: o payload de abertura é persistido independentemente da resposta.

Pré-condições

• Permissão: módulo digitalAccountErrors. Permissão é dupla — enum CPM no backend + módulo dinâmico no DB.
• Licença/Feature: DIGITAL_BANKING habilitada (Vault). Se desabilitada, o item nem aparece no menu.
• Dependências de outras telas: o registro vem da cadeia de auditoria de abertura de conta (payload em digital_account_creation.body no BSM + middleware banking-audit no BLS). O checkOnboarding no BaaS-Gateway sempre responde a partir do BLS — contas que existem só no provedor, sem registro no BLS, podem aparecer como inconsistência.

Passo a passo

1. Acesse o menu GERAL → Auditoria → Falhas na criação de Banco Digital.
2. A tabela carrega os registros paginados (10/25/50/100 por página).
3. (Opcional) Filtre por ID do usuário e/ou Status (PENDING, SUCCESS, ERROR) e clique em Aplicar.
4. Clique em uma linha (ou em Ver detalhes) para abrir o modal com os payloads completos.
5. Se o registro estiver em status ERROR, use Marcar como resolvido após tratar o caso.

Filtros e colunas

Filtro / Coluna	O que mostra	Origem do dado
ID do usuário (filtro)	Filtra a listagem pelo usuário-alvo	Parâmetro userId enviado ao backend
Status (filtro)	PENDING, SUCCESS ou ERROR	Parâmetro status
ID do usuário (coluna)	Usuário cuja abertura falhou	userId
Provedor	Provedor BaaS de destino	provider
Código de erro	Código retornado pelo provedor/integração	errorCode
Criado em	Momento da tentativa	createdAt
Ações	Abre os detalhes	—

Campos (modal de detalhes)

Campo	O que é	Origem
Status	Estado atual do registro	status
Body (payload de abertura)	JSON enviado ao provedor na criação da conta	body
Error payload	JSON de erro retornado	errorPayload

Ações e modais

• Aplicar / Limpar filtros: refaz a consulta (resetando a paginação) ou zera os filtros.
• Atualizar: recarrega a lista.
• Ver detalhes: abre o DigitalAccountErrorDetailsModal com os payloads formatados (JSON).
• Marcar como resolvido: disponível apenas quando status === 'ERROR'. Pede confirmação (confirm) e chama o backend para baixar o registro. Ao concluir, fecha o modal e recarrega a lista.

Regras de negócio / cuidados

Atenção

• "Marcar como resolvido" é uma ação de trilha de auditoria: registra que o caso foi tratado. Não recria a conta sozinha — a correção efetiva (novo onboarding, ajuste de dados, backfill no BLS) deve ser feita no fluxo apropriado.
• Para contas legacy que existem no provedor mas não no BLS, o checkOnboarding retorna 404 — esses casos exigem backfill no BLS, não apenas "marcar como resolvido".
• O payload de abertura contém PII (documentos, dados do titular). Trate conforme a LGPD.

• Step-up: ações sensíveis de banco digital podem exigir re-autenticação (senha+MFA, header X-Step-Up-Token) conforme a configuração do tenant.

Telas relacionadas

• Falhas na criação de usuário
• Webhooks recebidos
• Auditoria (visão geral)