> ## 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 electrònic: OTP i avaluació de risc

> Verifica correus amb Didit: OTP i anàlisi de risc. Detecta adreces filtrades, d'un sol ús i no lliurables. $0.02 per crida, sense mínims mensuals.

La Verificació de correu electrònic de Didit ofereix un mètode fiable per verificar adreces de correu electrònic d'usuaris mitjançant codis d'un sol ús (OTP) i una avaluació de riscos avançada. Aquesta funcionalitat ajuda a garantir que la informació de contacte sigui vàlida i accessible, alhora que protegeix contra correus electrònics d'alt risc o compromesos.

Prompt d'integració de la verificació de correu electrònic
        Copia el prompt al porta-retalls



      
      

\<pre>

\````# Goal
Integrate Didit Email Verification (OTP send + check + deliverability / breach / disposable lookup) into your app. Pick ONE mode.

\# Mode A — Session-based
Use this when the user completes verification through a hosted Didit flow.

1\. Add the EMAIL feature to the workflow (Business Console or POST /v3/workflows/). Configure risk actions: duplicated_email_action, breached_email_action, disposable_email_action.
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `email_verifications[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server, OTP pair)
Two endpoints paired by email address.

Step 1 — send the code:
\```bash
curl -X POST 'https://verification.didit.me/v3/email/send/' \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "alice@example.com",
"options": { "code_size": 6, "locale": "en", "use_white_label_customization": false },
"vendor_data": "user-1234"
}'
\```
Default: 6 numeric digits and Didit-branded delivery. Set `options.alphanumeric_code: true` for letters+digits (check is case-insensitive). Set `options.use_white_label_customization: true` to use your application's configured white-label sender and branding for this standalone OTP email; the default is `false`. `options.code_size` 4–8. Codes expire in **5 minutes**; one free retry per email within the window.

Step 2 — check the code (user types it into your UI):
\```bash
curl -X POST 'https://verification.didit.me/v3/email/check/' \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "alice@example.com",
"code": "123456",
"disposable_email_action": "DECLINE"
}'
\```
Each session accepts **up to 3** code-entry attempts. The check response always includes the full email metadata (breaches[], disposable flag, deliverable flag).

\# Status enum (per email_verifications[].status / email.status)
"Not Started" | "In Progress" | "Approved" | "Declined" | "Failed" | "Undeliverable" | "Expired or Not Found" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.EMAIL)
warnings[] risk codes include:
DUPLICATED_EMAIL, BREACHED_EMAIL, DISPOSABLE_EMAIL, UNDELIVERABLE_EMAIL, INVALID_EMAIL, OTP_MAX_ATTEMPTS_REACHED, OTP_EXPIRED.
Full catalogue: /core-technology/email-verification/warnings-email-verification.

\# Failure modes to handle
\- send response status="Undeliverable" — bounce/invalid domain; no charge, surface to the user.
\- check response status="Failed" — wrong code, attempts remaining; re-prompt.
\- check response status="Declined" — third failed attempt; restart with /v3/email/send/.
\- check response status="Expired or Not Found" — outside the 5-minute window; restart.
\- BREACHED_EMAIL warning — the address appears in known breaches; route to review per policy.

\# See also
\- Canonical schema: /reference/data-models#email-verification
\- Per-feature report: /core-technology/email-verification/report-email-verification
\- Risk catalogue: /core-technology/email-verification/warnings-email-verification
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

Enganxa a

La lliçó de l'Academy sobre com interpretar el resultat d'una verificació arriba a la comprovació de verificació de correu electrònic al minut 8:34.[Email verification — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=514\&rel=0\&playsinline=1)![Diagrama del flux de verificació de correu electrònic](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/email-verification-flow.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=23d035a261faa2063d6d941290ecf752)## Com funcionaLa nostra solució de verificació de correu electrònic combina la verificació per OTP amb senyals d'intel·ligència com ara l'exposició en filtracions de dades, la capacitat de lliurament i la reputació del proveïdor.**1. Recollida del correu electrònic**El sistema recull de manera segura:| Entrada | Descripció |
| - | - |
| **Adreça de correu electrònic** | Si no es proporciona durant la creació de la sessió, l'usuari introdueix la seva adreça de correu electrònic. Si es proporciona durant la creació de la sessió, l'usuari ha de verificar el correu electrònic emplenat prèviament. |
| **Idioma preferit** | S'utilitza per a comunicacions localitzades quan sigui aplicable. |**2. Generació i lliurament de l'OTP**El nostre sistema de verificació:- Genera un codi d'un sol ús segur i amb validesa limitada
- Lliura el codi per correu electrònic a l'adreça proporcionada
- Implementa bones pràctiques de lliurament per maximitzar el lliurament a la safata d'entrada
- Ofereix fluxos de reenviament amb mecanismes de protecció per evitar abusos**3. Validació del codi**L'usuari completa la verificació:- Introduint el codi rebut a la interfície de verificació
- Enviant-lo dins del termini de temps configurat (5 minuts)
- Sol·licitant un nou codi si és necessari (amb el límit de freqüència adequat)**4. Avaluació de riscos**El nostre sistema realitza comprovacions avançades:| Comprovació | Descripció |
| - | - |
| **Exposició en filtracions** | Cerca el correu electrònic en filtracions de dades conegudes i enumera els serveis exposats. |
| **Detecció de proveïdors d'un sol ús** | Marca els correus electrònics de proveïdors temporals o d'un sol ús. |
| **Comprovacions de lliurament** | Detecta adreces no lliurables o amb una sintaxi no vàlida. |
| **Senyals de reputació** | Identifica patrons de correu electrònic potencialment d'alt risc. |
| **Ús duplicat** | Contrasta les dades amb dades històriques de verificació. |**5. Lliurament de resultats**Accedeix als resultats de verificació a través de múltiples canals:| Canal | Descripció |
| - | - |
| **Tauler** | Actualitzacions del tauler en temps real. |
| **Webhooks** | Notificacions per webhook. |
| **API** | Respostes d'API RESTful. |
| **Informes** | Informes complets amb informació detallada de la verificació. |## Funcionalitats de verificacióEl nostre servei de verificació de correu electrònic ofereix diverses funcionalitats clau per millorar el teu procés de verificació:#### Verificació OTP- **Generació segura de codis**: Codis d'un sol ús aleatoris i amb validesa limitada
- **Lliurament per correu electrònic**: Lliurament per correu electrònic fiable i localitzat
- **Temps d'espera configurables**: Defineix terminis de caducitat segons els teus requisits de seguretat
- **Opcions de reintent**: Permet que els usuaris sol·licitin nous codis amb els límits adequats#### Anàlisi del correu electrònic- **Validació de sintaxi**: Assegura que l'adreça de correu electrònic compleixi el format segons les RFC
- **Comprovacions de proveïdors**: Identifica proveïdors temporals o d'un sol ús
- **Informació sobre el lliurament**: Detecta adreces a les quals no es pot lliurar correu
- **Intel·ligència sobre filtracions**: Mostra registres de filtracions conegudes amb detalls#### Avaluació de riscos- **Detecció d'exposició**: Identifica si el correu electrònic apareix en filtracions conegudes
- **Detecció d'adreces d'un sol ús**: Marca correus electrònics temporals o d'un sol ús
- **Monitoratge d'activitat**: Rastreja patrons sospitosos al llarg dels intents
- **Comprovació de llistes de bloqueig**: Comprova en llistes internes de correus electrònics utilitzats indegudament anteriorment


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