maxAttempts

Maximum number of facial capture attempts.

Details

Attribute: max-attempts

Type: number

Allowed values: 0 or higher

Default value: the one from the capture engine (the property is only sent if it is defined)

Morphology

selphi.maxAttempts = 3;

Description

Maximum number of capture attempts the user can make in facephi-selphi-widget before the Widget considers the process exhausted.

When the limit is exceeded, the Widget emits maxAttemptsExceeded and stops retrying the capture. Without this property, the Integration had to keep track of retries on its own starting from extractionTimeout and timeoutErrorButtonClick.

Considerations

If the property is not defined, the Widget does not send it to the engine and the capture engine's default value is applied.

This property limits the attempts of the complete capture Flow. It does not replace livenessMoveFailedAttempts, which controls the failed attempts within each step of the active liveness check.

---

Example

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