> ## 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.

# API de vérification de l'e-mail : OTP et risques

> Vérifiez les e-mails avec Didit : OTP, évaluation des risques et détection d'adresses jetables. $0.02 par appel, sans minimum mensuel.

La Vérification de l'e-mail de Didit offre une méthode fiable pour vérifier les adresses e-mail des utilisateurs grâce à des codes à usage unique (OTP) et une évaluation avancée des risques. Cette fonctionnalité permet de garantir des coordonnées valides et joignables tout en protégeant contre les e-mails compromis ou à haut risque.

Prompt d'intégration de la vérification de l'e-mail
        Copier le prompt dans le presse-papiers



      
      

\<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>



      
      

Coller dans

La leçon de l'Academy sur la lecture d'un résultat de vérification atteint l'étape de vérification de l'e-mail à 8:34.[Vérification de l'e-mail — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=514\&rel=0\&playsinline=1)![Diagramme du flux de vérification de l'e-mail](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)## Comment ça fonctionneNotre solution de Vérification de l'e-mail combine la vérification par OTP avec des signaux de renseignement sur les menaces, tels que l'exposition aux fuites de données, la délivrabilité et la réputation du fournisseur.**1. Collecte de l'e-mail**Le système recueille en toute sécurité :| Entrée | Description |
| - | - |
| **Adresse e-mail** | Si elle n'a pas été fournie lors de la création de la session, l'utilisateur saisit son adresse e-mail. Si elle a été fournie lors de la création de la session, l'utilisateur doit vérifier l'adresse e-mail préremplie. |
| **Langue préférée** | Utilisée pour les communications localisées, le cas échéant. |**2. Génération et envoi de l'OTP**Notre système de vérification :- Génère un code à usage unique sécurisé et limité dans le temps
- Envoie le code par e-mail à l'adresse fournie
- Applique les meilleures pratiques de délivrabilité afin d'optimiser le taux de réception en boîte principale
- Propose des flux de renvoi avec des protections pour empêcher les abus**3. Validation du code**L'utilisateur effectue la vérification en :- Saisissant le code reçu dans l'interface de vérification
- Soumettant le code dans le délai configuré (5 minutes)
- Demandant un nouveau code si nécessaire (avec une limite de débit appropriée)**4. Évaluation des risques**Notre système effectue des contrôles avancés :| Contrôle | Description |
| - | - |
| **Exposition aux fuites de données** | Recherche l'adresse e-mail dans les fuites de données connues et répertorie les services exposés. |
| **Détection de fournisseurs jetables** | Signale les adresses e-mail issues de fournisseurs temporaires ou jetables. |
| **Contrôles de délivrabilité** | Détecte les adresses non distribuables ou syntaxiquement invalides. |
| **Signaux de réputation** | Identifie les schémas d'e-mails potentiellement à haut risque. |
| **Utilisation en double** | Effectue des recoupements avec l'historique des vérifications. |**5. Transmission des résultats**Accédez aux résultats de vérification par le biais de plusieurs canaux :| Canal | Description |
| - | - |
| **Tableau de bord** | Mises à jour en temps réel sur le tableau de bord. |
| **Webhooks** | Notifications par webhook. |
| **API** | Réponses de l'API RESTful. |
| **Rapports** | Rapports complets contenant des informations détaillées sur la vérification. |## Fonctionnalités de vérificationNotre service de Vérification de l'e-mail propose plusieurs fonctionnalités clés pour optimiser votre processus de vérification :#### Vérification par OTP- **Génération sécurisée de codes** : Codes à usage unique aléatoires et limités dans le temps
- **Envoi d'e-mails** : Envoi d'e-mails fiable et localisé
- **Délais d'expiration configurables** : Définissez la durée de validité selon vos exigences de sécurité
- **Options de réessai** : Permettez aux utilisateurs de demander de nouveaux codes avec des limites adaptées#### Analyse de l'e-mail- **Validation de la syntaxe** : Assurez-vous que l'adresse e-mail respecte le format conforme aux normes RFC
- **Contrôles du fournisseur** : Identifiez les fournisseurs jetables ou temporaires
- **Visibilité sur la délivrabilité** : Détectez les adresses non distribuables
- **Informations sur les fuites de données** : Mettez en évidence les enregistrements de fuites connues avec leurs détails#### Évaluation des risques- **Détection d'exposition** : Identifiez si l'adresse e-mail apparaît dans des fuites de données connues
- **Détection d'adresses jetables** : Signalez les adresses e-mail temporaires ou jetables
- **Surveillance de l'activité** : Suivez les comportements suspects au fil des tentatives
- **Contrôle sur liste de blocage** : Comparez l'adresse avec les listes internes d'e-mails ayant fait l'objet d'abus antérieurs


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