> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Verificació de correu: advertències i codis de risc

> Referència de Didit per a codis de risc de verificació de correu: BREACHED_EMAIL_DETECTED, DISPOSABLE_EMAIL_DETECTED, bloquejos i límits d'OTP.

La funcionalitat de Verificació de correu electrònic emet **advertències** sempre que s'activa un senyal de risc en el flux d'OTP o en la mateixa adreça: una filtració de dades coneguda, un proveïdor d'un sol ús, una bústia a la qual no es pot lliurar correu, un límit d'intents d'OTP o una coincidència amb la teva llista de bloqueig o amb una altra verificació aprovada. Aquesta pàgina enumera cada codi, què l'activa i com configurar la resposta del flux de treball.

## Visió general

Les advertències s'etiqueten amb la funcionalitat `EMAIL`. Apareixen a l'informe a `email_verifications[].warnings[]` i segueixen l'estructura estàndard de l'[objecte d'advertència](https://docs.didit.me/ca/reference/data-models.md#objecte-d’advertència) (`feature`, `risk`, `additional_data`, `log_type`, `short_description`, `long_description`, `node_id`). Cada advertència també s'encamina al registre per sessió perquè aparegui a la Business Console sota la secció de correu electrònic.

Algunes advertències són activadors de **rebuig automàtic estricte**: sempre estableixen l'estat de la funcionalitat a `Declined` i inclouen `log_type: "error"`. Les altres es mapen a una **acció configurable** (`DECLINE`, `REVIEW` o el valor predeterminat `NO_ACTION`) definida per node del flux de treball o per crida a l'API, de manera que el mateix codi de risc pot rebutjar un flux de treball mentre que en un altre només genera una advertència. L'acció configurada també defineix la gravetat: `DECLINE` → `error`, `REVIEW` → `warning`, `NO_ACTION` → `information`.

## Condicions de rebuig automàtic

Les següents advertències sempre rebutgen el pas de Verificació de correu electrònic independentment de la configuració:

* `EMAIL_CODE_ATTEMPTS_EXCEEDED` — l'usuari ha esgotat el límit d'intents d'OTP: 2 entrades de codi incorrectes (`email_max_check_attempts`) o 2 enviaments d'OTP —l'enviament inicial més un reenviament (`email_max_retries`)— per defecte.
* `EMAIL_IN_BLOCKLIST` — l'adreça es troba en una llista de bloqueig gestionada mitjançant la [Lists API](https://docs.didit.me/ca/management-api/lists/overview.md), o ha coincidit amb una verificació de correu electrònic prèviament aprovada que s'ha afegit a la llista de bloqueig.
* `UNDELIVERABLE_EMAIL_DETECTED` — l'adreça no pot rebre correu: sintaxi no vàlida, un domini inexistent, absència de registres DNS (MX) o el correu electrònic d'OTP no s'ha pogut lliurar. El pas finalitza com a `Declined` immediatament; no s'arriba a executar cap comprovació de codi. Excepció: quan l'usuari ha escrit l'adreça ell mateix (no s'ha emplenat prèviament en crear la sessió), un enviament que no es pot lliurar retorna un error en línia perquè pugui reintentar-ho amb una adreça diferent en lloc de ser rebutjat.

## Riscos configurables

Cadascun dels següents riscos es mapeja a un paràmetre de configuració (per node del flux de treball, o per crida a l'[endpoint de comprovació](https://docs.didit.me/ca/standalone-apis/email-check.md) independent) que pots configurar com a `DECLINE`, `REVIEW` o `NO_ACTION`:

| Configuració | Codi de risc | Comportament per defecte |
| - | - | - |
| `breached_email_action` | `BREACHED_EMAIL_DETECTED` | `NO_ACTION` — mostra els detalls de la filtració a nivell `information` sense canviar l'estat. |
| `disposable_email_action` | `DISPOSABLE_EMAIL_DETECTED` | `NO_ACTION` — marca el proveïdor d'un sol ús a nivell `information` sense canviar l'estat. |
| `duplicated_email_action` | `DUPLICATED_EMAIL` | `NO_ACTION` — registra el duplicat a nivell `information`. S'omet quan l'adreça és a la llista d'admesos. |

La detecció de duplicats només té en compte les verificacions de correu electrònic **prèviament aprovades** a la mateixa aplicació, agrupades per `vendor_data`: les verificacions que comparteixen el mateix `vendor_data` es tracten com un únic usuari final i s'exclouen. Si deixes `vendor_data` buit, cada sessió es tracta com un usuari diferent. Si l'adreça és a la teva llista d'admesos de correu electrònic, s'omet l'acció de duplicat i s'emet `EMAIL_IN_ALLOWLIST` en el seu lloc.

## Límits d'intents de verificació

La funcionalitat de Verificació de correu electrònic aplica un límit estricte als intents d'OTP per evitar abusos:

* **Intents d'introducció de codi** — `email_max_check_attempts`, per defecte **2**: el segon intent amb un codi incorrecte (o caducat) finalitza el pas.
* **Intents d'enviament** — `email_max_retries`, per defecte **2** enviaments en total (l'enviament inicial més un reenviament): una sol·licitud de reenviament addicional finalitza el pas.

Superar qualsevol dels dos límits genera `EMAIL_CODE_ATTEMPTS_EXCEEDED` i rebutja automàticament. Pots ajustar ambdós límits per cada node del flux de treball.

## Advertències generades

| Etiqueta | Gravetat | Descripció |
| - | - | - |
| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | `error` | L'usuari ha superat el límit d'introducció de codis o d'enviaments. Es rebutja automàticament. |
| `EMAIL_IN_BLOCKLIST` | `error` | L'adreça és present en una llista de bloqueig creada mitjançant la [Lists API](https://docs.didit.me/ca/management-api/lists/overview.md) o ha coincidit amb una verificació aprovada present a la llista de bloqueig. Es rebutja automàticament. `additional_data` inclou `blocklisted_session_id`, `blocklisted_session_number` i `api_service` (tots `null` en cas de coincidència exclusiva amb la llista). |
| `EMAIL_IN_ALLOWLIST` | `information` | L'adreça ha coincidit amb una llista d'admesos creada mitjançant la [Lists API](https://docs.didit.me/ca/management-api/lists/overview.md), per la qual cosa s'ha omès l'acció per a correus duplicats. |
| `BREACHED_EMAIL_DETECTED` | Segons `breached_email_action` (`information` per defecte) | L'adreça s'ha trobat en una o més filtracions de dades conegudes. La matriu `breaches[]` de l'informe inclou el servei afectat, la data i les classes de dades. |
| `DISPOSABLE_EMAIL_DETECTED` | Segons `disposable_email_action` (`information` per defecte) | El domini és un proveïdor d'un sol ús o d'adreces temporals conegut que s'acostuma a utilitzar per eludir la traçabilitat. |
| `UNDELIVERABLE_EMAIL_DETECTED` | `error` | L'adreça no pot rebre correus (sintaxi no vàlida, domini inexistent, registres MX absents o lliurament fallit). Es rebutja automàticament. |
| `DUPLICATED_EMAIL` | Segons `duplicated_email_action` (`information` per defecte) | L'adreça coincideix amb una verificació de correu electrònic aprovada anteriorment que pertany a un usuari final diferent (agrupat per `vendor_data`). `additional_data` inclou `duplicated_session_id`, `duplicated_session_number` i `api_service`. |

Com a màxim s'activa un d'entre `EMAIL_IN_BLOCKLIST`, `DUPLICATED_EMAIL` i `EMAIL_IN_ALLOWLIST` per intent: la llista de bloqueig té prioritat sobre el duplicat, que al seu torn té prioritat sobre la llista d'admesos.

## Coincidències entre sessions

Quan es detecta una adreça en verificacions de correu electrònic aprovades anteriorment o a la teva llista de bloqueig, aquestes coincidències també apareixen a `email_verifications[].matches[]` (amb un límit de 5 entrades). Cada coincidència inclou `session_id`, `session_number`, `vendor_data`, `verification_date`, `email`, `status`, `is_blocklisted`, `api_service`, i un `source` de `session` (una altra verificació aprovada) o `list_entry` (una entrada de la llista de bloqueig). Si l'adreça actual és a la teva llista d'admesos de correu electrònic, Didit conserva l'evidència de la coincidència però emet `EMAIL_IN_ALLOWLIST` en lloc d'aplicar l'acció per a correus duplicats. Consulta l'[informe de Verificació de correu electrònic](https://docs.didit.me/ca/core-technology/email-verification/report-email-verification.md#coincidències-entre-sessions) per veure l'esquema complet de coincidències.

## Exemple

```json theme={null}
{
  "warnings": [
    {
      "feature": "EMAIL",
      "risk": "EMAIL_IN_BLOCKLIST",
      "additional_data": {
        "blocklisted_session_id": null,
        "blocklisted_session_number": null,
        "api_service": null
      },
      "log_type": "error",
      "short_description": "Email in blocklist",
      "long_description": "The system detected that the email is in the blocklist, which is not allowed.",
      "node_id": "feature_email_1"
    },
    {
      "feature": "EMAIL",
      "risk": "DISPOSABLE_EMAIL_DETECTED",
      "additional_data": null,
      "log_type": "information",
      "short_description": "Disposable email detected",
      "long_description": "The system detected that the email is disposable, which is not allowed.",
      "node_id": "feature_email_1"
    }
  ]
}
```

## Tipus d'advertència

A cada risc se li assigna una gravetat en funció de la configuració de la teva aplicació. Les gravetats es divideixen en tres categories:

## Relacionat

* [Visió general de la Verificació de correu electrònic](https://docs.didit.me/ca/core-technology/email-verification/overview.md) — comportament de la funcionalitat i preus.
* [Informe de Verificació de correu electrònic](https://docs.didit.me/ca/core-technology/email-verification/report-email-verification.md) — estructura completa de la resposta, inclosos `lifecycle[]` i `matches[]`.
* [Models de dades — verificació de correu electrònic](https://docs.didit.me/ca/reference/data-models.md#verificació-de-correu-electrònic) — esquema canònic camp per camp.
* [Management API — Llistes](https://docs.didit.me/ca/management-api/lists/overview.md) — gestiona la llista de bloqueig de correus electrònics que utilitza `EMAIL_IN_BLOCKLIST`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.