--- title: KYC Magic Link description: मेक्सिको में पहचान प्रक्रिया को निष्पादित करता है, एक अद्वितीय लिंक द्वारा वितरित होस्टेड यात्रा के माध्यम से राष्ट्रीय पहचान दस्तावेज़ (INE) और चेहरे की बायोमेट्रिक्स एकत्र करता है। canonical: https://developer.unico.io/hi/dual-api/products/sign-up/kyc-magic-link/index locale: hi generated_by: markdown-export --- - [/hi/](/hi/) - [बनाएं](/hi/dual-api/products/) - क्षेत्रीय गाइड - KYC Magic Link **इस पेज पर# KYC Magic Link अलग क्षेत्रीय अनुबंधयह उपयोग मामला `POST /v1/process` Unico endpoint या API अनुबंध का **उपयोग नहीं करता**। एकीकरण **Trully.ai** (host `api.trully.ai`) के साथ है, Bearer JWT के बजाय **`x-api-key` के माध्यम से प्रमाणीकरण** के साथ, और एक **स्वामित्व प्रतिक्रिया स्कीमा** के साथ। अन्य देशों के लिए, Onboarding (Global) का उपयोग करें। ### यह उपयोग मामला क्या हल करता है​ KYC Magic Link मेक्सिको में पहचान प्रक्रिया को निष्पादित करने, राष्ट्रीय पहचान दस्तावेज़ (INE) और चेहरे की बायोमेट्रिक्स एकत्र करने की चुनौती को संबोधित करता है। Unico द्वारा होस्ट की गई यात्रा के साथ, आप अपने स्वयं के चैनलों (WhatsApp, SMS, ईमेल) के माध्यम से भेजे गए एक लिंक के माध्यम से फ्रंट-एंड विकास की बाधा को समाप्त कर देते हैं। **इस उपयोग मामले का उपयोग करें जब:** आप **मेक्सिको** में काम करते हैं और उपयोग किया जाने वाला पहचान दस्तावेज़ **INE (अनिवार्य)** है। **इस उपयोग मामले का उपयोग न करें जब:** उपयोगकर्ता मेक्सिको के बाहर है या अन्य दस्तावेजों का उपयोग करता है → अन्य onboarding उपयोग मामलों को देखें। ### शामिल क्षमताएं​ एक ही प्रक्रिया में निष्पादित pipeline: [दस्तावेज़ कैप्चर (INE)](/hi/capabilities/document-reuse-and-capture)[Liveness](/hi/capabilities/liveness)[जोखिम वर्गीकरण](/hi/capabilities/fraud-risk-classification)[पहचान सत्यापन](/hi/capabilities/identity-verification) क्षमताआवश्यकप्रवाह में भूमिका**दस्तावेज़ कैप्चर**आवश्यकINE दस्तावेज़ की छवि कैप्चर करता है। इस उपयोग मामले में दस्तावेज़ पुनः उपयोग **उपलब्ध नहीं है** — प्रत्येक सत्र के लिए एक नई कैप्चर आवश्यक है।**Liveness**आवश्यकLiveness जांच — अनिवार्य सेल्फी जो प्रक्रिया को आधार देती है।**जोखिम वर्गीकरण**आवश्यकCPF से जुड़े धोखाधड़ी के जोखिम को चिह्नित करने के लिए व्यवहार संबंधी संकेतों का क्रॉस-रेफरेंस करता है।**पहचान सत्यापन**वैकल्पिक (यदि अनुबंधित)Unico की पहचान आधार और अतिरिक्त संकेतों का उपयोग करके सत्यापित करता है कि लेनदेन का चेहरा प्रदान किए गए सरकारी पहचानकर्ता के धारक का है या नहीं।**[RENAPO Verification](/hi/capabilities/renapo-verification)**वैकल्पिक (यदि अनुबंधित)उपयोगकर्ता के CURP के साथ मेक्सिको की राष्ट्रीय जनसंख्या रजिस्ट्री RENAPO से query करता है और पहचान सत्यापन परिणाम के साथ रजिस्ट्री रिकॉर्ड लौटाता है। ### पूर्वापेक्षाएं​ **API key** — Unico में आपके Onboarding Project Manager द्वारा प्रावधानित। `x-api-key` header में भेजा गया। **Public HTTPS endpoint** — webhooks प्राप्त करने के लिए (वैकल्पिक, लेकिन अनुशंसित)। **CORS कॉन्फ़िगरेशन** — webhook प्राप्त करने वाले सर्वर पर origins `https://verification.unico.app` (production) और `https://verification.uat.unico.app` (sandbox) को अनुमति दें। ### चरण-दर-चरण कार्यान्वयन​ अन्य उपयोग मामलों के विपरीत, Magic Link में **`flow` field नहीं है** — एकीकरण सीधे Trully API के साथ है। endpoint एक अद्वितीय सत्यापन लिंक बनाता है जिसे आप अपने स्वयं के चैनल के माध्यम से उपयोगकर्ता को वितरित करते हैं। ### 1. Magic Link बनाएं​ **Endpoint:** `POST https://sandbox.trully.ai/v2/magic-link` **Headers:** Headerआवश्यकविवरण`x-api-key`हांUnico में आपके Onboarding Project Manager द्वारा प्रावधानित API key।`Content-Type`हां`application/json` **Body (application/json):** FieldTypeआवश्यकविवरण`external_id`stringनहींअनुरोध के लिए एक बाहरी पहचानकर्ता, ट्रैकिंग और संदर्भ उद्देश्यों के लिए उपयोग किया जाता है।`metadata`objectनहींकॉन्फ़िगरेशन पैरामीटर के लिए कंटेनर।`metadata.phone`stringनहींअंतर्राष्ट्रीय प्रारूप में उपयोगकर्ता का फ़ोन नंबर (जैसे, `521234567890`)।`metadata.redirect_url`stringनहींKYC प्रक्रिया पूरी होने के बाद उपयोगकर्ता को redirect करने का URL।`metadata.webhook_url`stringनहींKYC प्रक्रिया पूरी होने के बाद KYC प्रक्रिया डेटा भेजने का URL। यह webhook client side में call किया जाएगा। सुरक्षा कारणों से endpoint को HTTPS का उपयोग करना चाहिए। component आपके webhook server के जवाब देने के लिए एक मिनट प्रतीक्षा करेगा — उसके बाद, यह संचार बंद कर देगा। प्रक्रिया किसी भी तरह से webhook संचार से प्रभावित नहीं होगी। सुनिश्चित करें कि production और sandbox के लिए क्रमशः `https://verification.unico.app` और `https://verification.uat.unico.app` को अपने CORS कॉन्फ़िगरेशन में अनुमति दें।`metadata.track_webhook_url`stringनहींउपयोगकर्ता द्वारा संसाधित प्रत्येक KYC चरण भेजने का URL (नीचे webhook events देखें)। यह webhook client side में call किया जाएगा। सुरक्षा कारणों से endpoint को HTTPS का उपयोग करना चाहिए। component आपके webhook server के जवाब देने के लिए एक मिनट प्रतीक्षा करेगा — उसके बाद, यह संचार बंद कर देगा। प्रक्रिया किसी भी तरह से webhook संचार से प्रभावित नहीं होगी। सुनिश्चित करें कि production और sandbox के लिए क्रमशः `https://verification.unico.app` और `https://verification.uat.unico.app` को अपने CORS कॉन्फ़िगरेशन में अनुमति दें। `data.step` (जो `track_webhook_url` को भेजा जाता है) वही चरण रिपोर्ट करता है जो Webhook V2 द्वारा ट्रैक किए जाते हैं — नीचे [समर्थित चरण तालिका](#webhook-v2) देखें। **उदाहरण अनुरोध:** ``` curl -X POST https://sandbox.trully.ai/v2/magic-link \ -H "x-api-key: $TRULLY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "external_id": "user-mx-12345", "metadata": { "phone": "521234567890", "redirect_url": "https://app.client.com.mx/kyc-done", "webhook_url": "https://app.client.com.mx/webhook/result", "track_webhook_url": "https://app.client.com.mx/webhook/track" } }' ``` ### 2. टोकन और लिंक URL प्राप्त करें​ **प्रतिक्रिया fields:** FieldTypeविवरण`data.external_id`string (nullable)अनुरोध के लिए एक बाहरी पहचानकर्ता, ट्रैकिंग और संदर्भ उद्देश्यों के लिए उपयोग किया जाता है।`data.created_on`string (date-time)magic link बनाए जाने की तारीख।`data.is_active`booleanयदि `true`, तो magic link सक्रिय है।`data.token`stringmagic link का टोकन जो KYC प्रक्रियाओं को magic link से जोड़ने के लिए उपयोग किया जाएगा।`data.magic_link_url`string (URI)KYC प्रक्रिया शुरू करने के लिए magic URL लिंक।`data.metadata.redirect_url`string (nullable)KYC प्रक्रिया पूरी होने के बाद उपयोगकर्ता को redirect करने का URL।`data.metadata.webhook_url`string (nullable)KYC प्रक्रिया पूरी होने के बाद KYC प्रक्रिया डेटा भेजने का URL। यह webhook client side में call किया जाएगा।`data.metadata.track_webhook_url`string (nullable)उपयोगकर्ता द्वारा संसाधित प्रत्येक KYC चरण भेजने का URL। यह webhook client side में call किया जाएगा।`data.version`stringmagic link का संस्करण।`version`stringAPI का संस्करण जिसने अनुरोध संसाधित किया, परिवर्तनों और संगतता को ट्रैक करने के लिए उपयोगी।`status`stringप्रतिक्रिया स्थिति का पाठ्य प्रतिनिधित्व, ऑपरेशन की सफलता या विफलता को दर्शाता है।`status_code`integerप्रतिक्रिया का HTTP status code, अनुरोध के परिणाम का एक मानकीकृत संकेतक प्रदान करता है।`request_date`string (date-time)अनुरोध किए जाने की तारीख और समय, ISO 8601 प्रारूप में।`request.metadata.redirect_url`string (nullable)KYC प्रक्रिया पूरी होने के बाद उपयोगकर्ता को redirect करने का URL (अनुरोध की प्रतिध्वनि)।`request.metadata.webhook_url`string (nullable)पूरा होने के बाद KYC प्रक्रिया डेटा भेजने का URL (अनुरोध की प्रतिध्वनि)।`request.metadata.track_webhook_url`string (nullable)उपयोगकर्ता द्वारा संसाधित प्रत्येक KYC चरण भेजने का URL (अनुरोध की प्रतिध्वनि)। **उदाहरण प्रतिक्रिया:** ``` { "data": { "external_id": null, "created_on": "2025-07-28T18:11:54.430048399Z", "is_active": true, "token": "3f6dbcc1-49ba-4935-be90-dd8dd59b5530", "magic_link_url": "https://verification.uat.unico.app/link/v2/3f6dbcc1-49ba-4935-be90-dd8dd59b5530", "metadata": { "redirect_url": null, "webhook_url": null, "track_webhook_url": null }, "version": "v2" }, "version": "v1.4.2", "status": "ok", "status_code": 200, "request_date": "2025-07-28T18:11:54+0000", "request": { "metadata": { "redirect_url": null, "webhook_url": null, "track_webhook_url": null } }} ``` **त्रुटि प्रतिक्रियाएं — POST /v2/magic-link**CodeMessageविवरण`400 Bad Request``data provided in the field is invalid`अनुरोध payload में अमान्य डेटा संरचना या field मान। आवश्यक fields और प्रारूपों की जांच करें।`403 Forbidden``Forbidden`API key गायब है, समाप्त हो गई है या अनुमति नहीं है। `x-api-key` header सत्यापित करें।`500 Internal Server Error``internal server error`Server-side प्रसंस्करण विफलता। exponential backoff के साथ पुनः प्रयास करें। यदि लगातार हो, तो support को रिपोर्ट करें।**उदाहरण 400 प्रतिक्रिया:**``` { "data": { "error": "data provided in the field is invalid" }, "version": "v1.4.2", "status": "bad request", "status_code": 400, "request_date": "2025-07-28T20:22:29+0000", "request": { "metadata": null }} ``` ### 3. magic_link_url को उपयोगकर्ता को वितरित करें​ WhatsApp, SMS, ईमेल के माध्यम से भेजें या embed करें। उपयोगकर्ता अपने स्वयं के डिवाइस पर लिंक एक्सेस करता है और होस्टेड यात्रा पूरी करता है। यदि आप ब्राउज़र में लिंक खोलने के बजाय यात्रा को अपने स्वयं के ऐप के अंदर embed करना पसंद करते हैं, तो आप ऐसा WebView या CustomTab के माध्यम से कर सकते हैं। संदर्भ PoCs: **Android/Kotlin:** [TrullyAi-AndroidMagicLink](https://github.com/unico-labs/TrullyAi-AndroidMagicLink) **React Native:** [TrullyAI-ReactNativeMagicLink](https://github.com/unico-labs/TrullyAI-ReactNativeMagicLink) ### 4. परिणाम प्राप्त करें​ आपके पास यह तय करने की पूरी flexibility है कि KYC प्रक्रिया का अंतिम परिणाम कैसे प्राप्त करें — वह strategy चुनें जो आपके सिस्टम के architecture के लिए सबसे उपयुक्त हो। आप सक्रिय रूप से परिणाम के लिए poll कर सकते हैं (GET) या इसे notifications (Webhook) के माध्यम से passively प्राप्त कर सकते हैं। **विकल्प A — GET के माध्यम से सक्रिय Polling** `GET /v2/history/request?magic_link_token={token}` को call करके परिणाम प्राप्त करें (नीचे [GET के माध्यम से Polling](#polling-via-get) देखें)। अंतिम निर्णय `data.response.unico.result` में populated होता है। GET के लिए सर्वोत्तम प्रथालिंक बनाए जाने के क्षण से समय-समय पर poll करने के बजाय, यह जानने के लिए कि कब query करना है, tracking webhooks (नीचे [Webhook V2](#webhook-v2) देखें) का उपयोग करें। एक बार जब आपको `form_decision_maker` चरण प्राप्त हो जाए, तो यह इस GET call को trigger करने का सटीक, सुरक्षित क्षण है। **विकल्प B — Webhook के माध्यम से स्वचालित प्राप्ति** अपने सिस्टम को स्वचालित रूप से सूचित करवाएं जैसे ही अंतिम परिणाम तैयार हो (नीचे [Webhook V2](#webhook-v2) देखें)। दो versions उपलब्ध हैं: **Webhook V1** — टोकन बनाते समय `metadata.webhook_url` में भेजे गए URL पर आपको परिणाम प्राप्त होता है। **Webhook V2** — पहले से अपने Onboarding PM के साथ कॉन्फ़िगर किया गया। आप `MAGIC_LINK_RESULTS` event को सुनकर अंतिम निर्णय प्राप्त करते हैं। Resilience — fallbackयदि Webhook (विकल्प B) आपकी प्राथमिक विधि है, तो fallback के रूप में GET query (विकल्प A) को भी implement करें। यह आपको network विफलताओं, अस्थायी server outages, या ठीक से process न होने वाले webhook की स्थिति में reconciliation routines के माध्यम से परिणाम पुनर्प्राप्त करने देता है। ### GET के माध्यम से Polling​ **Endpoint:** `GET https://sandbox.trully.ai/v2/history/request` **Query parameters:** ParameterTypeआवश्यकविवरण`magic_link_token`stringहांMagic Link बनाए जाने पर लौटाया गया टोकन। **Headers:** Headerआवश्यकविवरण`x-api-key`हांUnico में आपके Onboarding Project Manager द्वारा प्रावधानित API key। **उदाहरण अनुरोध:** ``` curl "https://sandbox.trully.ai/v2/history/request?magic_link_token=$TOKEN" \ -H "x-api-key: $TRULLY_API_KEY" ``` **उदाहरण प्रतिक्रिया:** ``` { "data": { "images": { "document_image": "/9j/4ASu7bmV[...]fyPjOKfgif//Z", "document_image_back": "/9j/4ASu7bmV[...]fyPjOKfgif//Z", "selfie": "/9j/4ASu7bmV[...]fyPjOKfgif//Z" }, "response": { "curp": { "age": 58, "curp": "GOCJ850627HDFRRL09", "date_of_birth": "14/11/1956", "deceased": false, "gender": "M", "government_name": "LUKE SKYWALKER", "government_valid": true, "is_mexican": true, "name_to_CURP_valid": true, "state_iso": "MX-NLE", "state_of_birth": "Nuevo León" }, "document": { "back": { "cic": "237457894", "citizen_id": "237457894", "mrz": "IDMEX999999999999<9 VADER