> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/maxattemptsexceeded.md).

# maxAttemptsExceeded

Se agotaron los intentos de captura permitidos.

## Detalles

Se emite cuando el usuario supera el número de intentos configurado en [maxAttempts](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md).

**Evento:** `maxAttemptsExceeded`

**Tipo:** `FacephiSelphiWidgetCustomEvent<MaxAttemptsExceededEvent>` | `CustomEvent<MaxAttemptsExceededEvent>`

### Sintaxis

```typescript
selphi.addEventListener('maxAttemptsExceeded', onMaxAttemptsExceeded);
```

### Objeto recibido

El payload útil está en `event.detail.detail`:

* `eventType` (`string`): Tipo de evento emitido.
* `message` (`string`): Descripción breve del motivo por el que se agotaron los intentos.

## Descripción

Indica que el usuario ha consumido todos los intentos de captura permitidos y que el widget no va a reintentar el proceso. A diferencia de [extractionTimeout](/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/extractiontimeout.md), que se emite en cada intento expirado y permite reintentar, este evento marca el final del flujo de captura.

La integración debe decidir aquí cómo continuar: mostrar una vista de error propia, ofrecer un canal alternativo de verificación o cerrar el proceso.

### Consideraciones

Solo se emite si [maxAttempts](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md) está configurado con un límite que el motor pueda agotar.

El payload útil está en `event.detail.detail` (ver [formato de eventos](/sdks/sdk-web/componentes/selphi-biometria-facial/eventos.md#formato-de-los-eventos)).

El widget registra este caso en el tracking con estado `EXPIRED` y motivo `SELPHI_MAX_ATTEMPTS`.

***

## Ejemplo

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

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

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