> ## 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: OTP और जोखिम मूल्यांकन

> Didit के साथ OTP व जोखिम मूल्यांकन से ईमेल सत्यापित करें। ब्रीच और डिस्पोज़ेबल पते पहचानें। $0.02 प्रति कॉल, बिना किसी न्यूनतम मासिक शुल्क के।

Didit का ईमेल सत्यापन वन-टाइम कोड (OTP) और उन्नत जोखिम मूल्यांकन के माध्यम से उपयोगकर्ता के ईमेल पतों को सत्यापित करने का एक विश्वसनीय तरीका प्रदान करता है। यह सुविधा उच्च-जोखिम वाले और समझौता किए गए ईमेल से सुरक्षा करते हुए वैध और पहुँच योग्य संपर्क जानकारी सुनिश्चित करने में मदद करती है।

ईमेल सत्यापन इंटीग्रेशन प्रॉम्प्ट
        प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें



      
      

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



      
      

यहाँ पेस्ट करें

सत्यापन परिणाम पढ़ने पर Academy का पाठ 8:34 पर ईमेल सत्यापन जाँच तक पहुँचता है।[ईमेल सत्यापन — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=514\&rel=0\&playsinline=1)![ईमेल सत्यापन फ़्लो आरेख](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)## यह कैसे काम करता हैहमारा ईमेल सत्यापन समाधान OTP सत्यापन को ब्रीच एक्सपोज़र, डिलीवरेबिलिटी और प्रदाता की प्रतिष्ठा जैसे इंटेलिजेंस सिग्नलों के साथ जोड़ता है।**1. ईमेल संग्रह**सिस्टम सुरक्षित रूप से निम्नलिखित एकत्र करता है:| इनपुट | विवरण |
| - | - |
| **ईमेल पता** | यदि सत्र निर्माण के दौरान प्रदान नहीं किया गया है, तो उपयोगकर्ता अपना ईमेल पता दर्ज करता है। यदि सत्र निर्माण के दौरान प्रदान किया गया है, तो उपयोगकर्ता को पहले से भरे हुए ईमेल को सत्यापित करना होगा। |
| **पसंदीदा भाषा** | लागू होने पर स्थानीयकृत संचार के लिए उपयोग की जाती है। |**2. OTP जनरेशन और डिलीवरी**हमारा सत्यापन सिस्टम:- एक सुरक्षित, समय-सीमित वन-टाइम कोड जनरेट करता है
- प्रदान किए गए पते पर ईमेल के माध्यम से कोड डिलीवर करता है
- इनबॉक्स प्लेसमेंट को अधिकतम करने के लिए डिलीवरेबिलिटी की सर्वोत्तम कार्यप्रणालियों को लागू करता है
- दुरुपयोग को रोकने के लिए सुरक्षा उपायों के साथ पुनः भेजने के फ़्लो प्रदान करता है**3. कोड सत्यापन**उपयोगकर्ता निम्नलिखित द्वारा सत्यापन पूरा करता है:- सत्यापन इंटरफ़ेस में प्राप्त कोड दर्ज करके
- कॉन्फ़िगर की गई समय-सीमा (5 मिनट) के भीतर सबमिट करके
- आवश्यकता पड़ने पर एक नया कोड अनुरोध करके (उचित रेट लिमिट के साथ)**4. जोखिम मूल्यांकन**हमारा सिस्टम उन्नत जाँच करता है:| जाँच | विवरण |
| - | - |
| **ब्रीच एक्सपोज़र** | ज्ञात डेटा उल्लंघनों में ईमेल की खोज करता है और उजागर हुई सेवाओं को सूचीबद्ध करता है। |
| **डिस्पोज़ेबल प्रदाता डिटेक्शन** | अस्थायी/डिस्पोज़ेबल प्रदाताओं के ईमेल को फ़्लैग करता है। |
| **डिलीवरेबिलिटी जाँच** | न डिलीवर होने योग्य या सिंटैक्स की दृष्टि से अमान्य पतों का पता लगाता है। |
| **रेपुटेशन सिग्नल्स** | संभावित रूप से उच्च-जोखिम वाले ईमेल पैटर्न की पहचान करता है। |
| **डुप्लिकेट उपयोग** | ऐतिहासिक सत्यापन डेटा के साथ क्रॉस-रेफ़रेंस करता है। |**5. परिणाम डिलीवरी**कई चैनलों के माध्यम से सत्यापन परिणामों तक पहुँचें:| चैनल | विवरण |
| - | - |
| **डैशबोर्ड** | रीयल-टाइम डैशबोर्ड अपडेट। |
| **webhook** | webhook सूचनाएं। |
| **API** | RESTful API रिस्पॉन्स। |
| **रिपोर्ट** | विस्तृत सत्यापन जानकारी वाली व्यापक रिपोर्ट। |## सत्यापन सुविधाएँहमारी ईमेल सत्यापन सेवा आपकी सत्यापन प्रक्रिया को बेहतर बनाने के लिए कई प्रमुख सुविधाएँ प्रदान करती है:#### OTP सत्यापन- **सुरक्षित कोड जनरेशन**: रैंडम, समय-बद्ध वन-टाइम कोड
- **ईमेल डिलीवरी**: विश्वसनीय और स्थानीयकृत ईमेल डिलीवरी
- **कॉन्फ़िगर करने योग्य टाइमआउट**: अपनी सुरक्षा आवश्यकताओं के आधार पर समाप्ति समय निर्धारित करें
- **पुनः प्रयास के विकल्प**: उपयोगकर्ताओं को उचित सीमाओं के साथ नए कोड का अनुरोध करने की अनुमति दें#### ईमेल विश्लेषण- **सिंटैक्स सत्यापन**: सुनिश्चित करें कि ईमेल पता RFC-अनुपालक प्रारूप का पालन करता है
- **प्रदाता जाँच**: डिस्पोज़ेबल/अस्थायी प्रदाताओं की पहचान करें
- **डिलीवरेबिलिटी अंतर्दृष्टि**: न डिलीवर होने योग्य पतों का पता लगाएँ
- **ब्रीच इंटेलिजेंस**: विवरण के साथ ज्ञात ब्रीच रिकॉर्ड सामने लाएँ#### जोखिम मूल्यांकन- **एक्सपोज़र डिटेक्शन**: पहचानें कि क्या ईमेल ज्ञात उल्लंघनों में दिखाई देता है
- **डिस्पोज़ेबल डिटेक्शन**: अस्थायी या थ्रोअवे ईमेल को फ़्लैग करें
- **गतिविधि निगरानी**: प्रयासों के दौरान संदिग्ध पैटर्न को ट्रैक करें
- **ब्लॉकलिस्ट जाँच**: पहले दुरुपयोग किए गए ईमेल की आंतरिक सूचियों के विरुद्ध जाँच करें


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