> 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/propiedades/maxattempts.md).

# maxAttempts

Número máximo de intentos de captura facial.

## Detalles

**Atributo:** `max-attempts`

**Tipo:** `number`

**Valores admitidos:** `0` o superior

**Valor por defecto:** el del motor de captura (la propiedad solo se envía si se define)

## Morfología

```typescript
selphi.maxAttempts = 3;
```

## Descripción

Número máximo de intentos de captura que el usuario puede realizar en `facephi-selphi-widget` antes de que el widget dé por agotado el proceso.

Cuando se supera el límite, el widget emite [maxAttemptsExceeded](/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/maxattemptsexceeded.md) y deja de reintentar la captura. Sin esta propiedad, la integración tenía que llevar la cuenta de reintentos por su cuenta a partir de [extractionTimeout](/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/extractiontimeout.md) y [timeoutErrorButtonClick](/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/timeouterrorbuttonclick.md).

### Consideraciones

Si no se define la propiedad, el widget no la envía al motor y se aplica el valor por defecto del motor de captura.

Esta propiedad limita los intentos del flujo completo de captura. No sustituye a [livenessMoveFailedAttempts](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovefailedattempts.md), que controla los intentos fallidos dentro de cada paso de la prueba de vida activa.

***

## Ejemplo

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