maxAttemptsExceeded

As tentativas de captura permitidas foram esgotadas.

Detalhes

É emitido quando o usuário ultrapassa o número de tentativas configurado em maxAttempts.

Evento: maxAttemptsExceeded

Tipo: FacephiSelphiWidgetCustomEvent<MaxAttemptsExceededEvent> | CustomEvent<MaxAttemptsExceededEvent>

Sintaxe

selphi.addEventListener('maxAttemptsExceeded', onMaxAttemptsExceeded);

Objeto recebido

O payload útil está em event.detail.detail:

• eventType (string): Tipo de evento emitido.

• message (string): Breve descrição do motivo pelo qual as tentativas foram esgotadas.

Descrição

Indica que o usuário consumiu todas as tentativas de captura permitidas e que o widget não vai tentar o processo novamente. Ao contrário de extractionTimeout, que é emitido a cada tentativa expirada e permite tentar novamente, este evento marca o fim do fluxo de captura.

A Integração deve decidir aqui como continuar: mostrar uma tela de erro própria, oferecer um canal alternativo de verificação ou encerrar o processo.

Considerações

Só é emitido se maxAttempts estiver configurado com um limite que o mecanismo possa esgotar.

O payload útil está em event.detail.detail (veja formato de eventos).

O widget registra este caso no Tracking com estado EXPIRED e motivo SELPHI_MAX_ATTEMPTS.

---

Exemplo

<facephi-selphi-widget
    maxAttempts={3}
    onMaxAttemptsExceeded={(event) => {
      const { message } = event.detail.detail;
      console.log('Intentos agotados:', message);
      showRetriesExceededView();
    }}
/>

import { type MaxAttemptsExceededEvent } from '@facephi/selphi-web-component';

selphi.addEventListener('maxAttemptsExceeded', (event: CustomEvent<MaxAttemptsExceededEvent>) => {
  const detail = event.detail.detail;
  console.log('maxAttemptsExceeded:', detail);
});