मुख्य सामग्री पर जाएं
POST
Unico IDCloud बायोमेट्रिक सत्यापन: उपयोगकर्ता की सेल्फ़ी की तुलना उनके CPF से जुड़े रिकॉर्ड के चेहरे से करता है और लौटाता है कि यह वही व्यक्ति है, वही व्यक्ति नहीं है, या परिणाम अनिर्णायक है। Didit इस सेवा को POST /v3/database-validation/ के ज़रिए उपलब्ध कराता है, ताकि आप सबमिट किए गए डेटा को प्रामाणिक स्रोत से सत्यापित कर सकें और सामान्यीकृत मिलान परिणाम प्राप्त कर सकें। इनपुट प्रारूप: tax_number में ब्राज़ीलियाई CPF लिया जाता है (ठीक 11 अंक)।

कवरेज

  • कवरेज: 96%
  • देश: ब्राज़ील
  • सेवा ID: bra_unico_idcloud
  • डेटा डोमेन: पहचान
  • श्रेणी: बायोमेट्रिक जोखिम स्कोर
ब्राज़ीलियाई CPF धारकों में से लगभग 96% का Unico की रजिस्ट्री में बायोमेट्रिक रिकॉर्ड मिलता है, जो सरकारी चेहरा मिलान स्रोत Datavalid की पहुँच से लगभग दोगुना है, जिसकी पहुँच लगभग 50% है।

इनपुट

  • आवश्यक इनपुट: tax_number, selfie
  • वैकल्पिक इनपुट: first_name, last_name, full_name, date_of_birth, vendor_data
  • सहमति: आवश्यक
  • वर्कफ़्लो में उपलब्धता: वर्कफ़्लो में उपलब्ध
  • कवरेज: 96%
  • कीमत: प्रति सफल क्वेरी $0.20

मुख्य भाग के पैरामीटर

string
डिफ़ॉल्ट:"BRA"
आवश्यक
इस डेटाबेस सेवा के लिए ISO 3166-1 alpha-3 देश कोड।उदाहरण: BRA
string
डिफ़ॉल्ट:"bra_unico_idcloud"
आवश्यक
इस सेवा ID वाली एक सरणी। सेवा को पिन करने से अनुरोध इसी सटीक डेटाबेस तक सीमित रहता है।उदाहरण: bra_unico_idcloud
इस सेवा के लिए अंतिम उपयोगकर्ता की स्पष्ट सहमति।उदाहरण: true
string
डिफ़ॉल्ट:"11111111111"
आवश्यक
कर या राजकोषीय पहचान संख्या।उदाहरण: 11111111111
file
आवश्यक
बायोमेट्रिक डेटाबेस सत्यापन के लिए अपलोड की जाने वाली सेल्फ़ी छवि फ़ाइल। स्वीकृत प्रारूप: JPEG, PNG या WebP।उदाहरण: @./selfie.jpg
string
सत्यापित किया जाने वाला पहला नाम।उदाहरण: John
string
सत्यापित किया जाने वाला अंतिम नाम।उदाहरण: Doe
string
सत्यापित किया जाने वाला पूरा कानूनी नाम।उदाहरण: John Doe
string
YYYY-MM-DD प्रारूप में जन्म तिथि।उदाहरण: 1990-01-01
string
डिफ़ॉल्ट:"user-1234"
इस व्यक्ति के लिए आपका स्थिर उपयोगकर्ता संदर्भ, जैसे आपकी आंतरिक उपयोगकर्ता ID। Didit इसका उपयोग स्टैंडअलोन जाँच को उसी अंतिम उपयोगकर्ता से जोड़ने और डुप्लिकेट-पहचान के शोर को कम करने के लिए करता है।उदाहरण: user-1234

इनपुट नियम और सत्यापन नोट्स

  • ब्राज़ीलियाई CPF (ठीक 11 अंक)
  • tax_number में केवल अंक होने चाहिए; अनुरोध भेजने से पहले स्पेस, हाइफ़न और विराम चिह्न हटा दें।
  • tax_number की लंबाई ठीक 11 वर्ण होनी चाहिए।

इसे कैसे कॉल करें

लौटाया गया डेटा

source_data में कौन-से सटीक फ़ील्ड दिखते हैं, यह इस बात पर निर्भर करता है कि रजिस्ट्री क्या लौटाती है। bra_unico_idcloud के लिए बनाया गया उदाहरण फ़िलहाल यह सामान्यीकृत संरचना दस्तावेज़ित करता है:
  • unico_face_match

मूल्य निर्धारण और SLAs

BRA - Unico IDCloud (CPF + सेल्फ़ी) क्वेरी तभी बिल की जाती हैं जब Didit को सत्यापन स्रोत से निर्णायक परिणाम मिलता है।
  • प्रति कॉल कीमत: $0.20 USD।
  • बिलिंग: प्रति सफल क्वेरी। जब रजिस्ट्री तक पहुँच न हो, आवश्यक फ़ील्ड गायब हों, या अनुरोध स्रोत तक पहुँचने से पहले अस्वीकार कर दिया जाए, तब आपसे शुल्क नहीं लिया जाता।
  • लेटेंसी: सामान्यतः p95 < 2 s।
  • उपलब्धता: Didit की ओर से प्रति तिमाही 99.9%; डाउनस्ट्रीम स्रोत की उपलब्धता देश और डेटासेट के अनुसार अलग होती है।

इस स्रोत के बारे में

Unico एक ब्राज़ीलियाई IDtech कंपनी है, जो देश की सबसे बड़ी निजी चेहरे की बायोमेट्रिक रजिस्ट्री संचालित करती है। इसके IDCloud प्लेटफ़ॉर्म में एक अरब से अधिक फ़ेस एम्बेडिंग हैं, और इसमें हर महीने लगभग 35 मिलियन नए चेहरे जुड़ते हैं। यह डेटा 800 से अधिक ब्राज़ीलियाई कंपनियों के ऑनबोर्डिंग और पुनः-प्रमाणीकरण प्रवाहों से आता है, जिनमें देश के सबसे बड़े पाँच बैंकों में से चार शामिल हैं। इसी पैमाने की वजह से ऊपर दिया गया कवरेज आँकड़ा संभव है: CPF लुकअप से ब्राज़ीलियाई वयस्कों के लगभग 96% के लिए एक बायोमेट्रिक रिकॉर्ड मिल जाता है। Didit की Unico के साथ सीधी साझेदारी है, इसलिए आप मानक Database Validation API के माध्यम से IDCloud से क्वेरी कर सकते हैं। इसमें प्रति कॉल भुगतान होता है, अलग Unico अनुबंध की ज़रूरत नहीं होती, कोई न्यूनतम मात्रा नहीं है, और कोई अलग ऑनबोर्डिंग प्रक्रिया नहीं है। यह सरकारी रजिस्ट्री से कैसे अलग है। Didit Brazil - CPF + face match (Datavalid) भी प्रदान करता है, जो आधिकारिक SERPRO स्रोत है और तब सही विकल्प है जब आपको विशेष रूप से सरकारी रजिस्ट्री को ही अपने सत्य के स्रोत के रूप में उपयोग करना हो। बाकी सभी स्थितियों के लिए IDCloud बेहतर विकल्प है, और इसे दो ऐसे पहलुओं पर जाँचा जा सकता है जिन्हें आप स्वयं परख सकते हैं। पहला, यह लगभग 96% वयस्कों तक पहुँचता है, जबकि Datavalid की पहुँच लगभग 50% है। दूसरा, यह मिलान उस बायोमेट्रिक रिकॉर्ड से करता है जिसे रजिस्ट्री स्वयं रखती है, न कि उस तस्वीर से जो उपयोगकर्ता द्वारा दिए गए दस्तावेज़ से ली गई हो। इसलिए यह दस्तावेज़ जालसाजी और चोरी किए गए CPF से होने वाली धोखाधड़ी, दोनों के खिलाफ़ अधिक मज़बूत है। साथ ही, प्रति क्वेरी इसकी कीमत आधे से भी कम है।

ब्राज़ील के लिए अनुशंसित फ़्लो

ज़्यादातर ब्राज़ीलियाई उपयोग मामलों में आपको दस्तावेज़ कैप्चर की ज़रूरत बिल्कुल नहीं होती। उपयोगकर्ता आपको CPF देता है, और लाइवनेस-जाँचित सेल्फ़ी पुष्टि करती है कि वह उसी CPF वाला व्यक्ति है।
1

CPF एकत्र करें

आपका एकमात्र टेक्स्ट इनपुट 11 अंकों का CPF है: कोई दस्तावेज़ फ़ोटो नहीं, और हाथ से टाइप किया गया नाम या जन्म तिथि भी नहीं।चूँकि इस फ़्लो में कोई दस्तावेज़ नहीं पढ़ा जाता, इसलिए Didit के पास CPF लेने का कोई स्रोत नहीं होगा, जब तक आप यह न बताएँ कि वह कहाँ से आएगा। सत्र बनाते समय उसे सत्र के metadata में भेजें, और उसे डेटाबेस सत्यापन चरण के tax_number इनपुट से मैप करें। Business Console में यह चरण की इनपुट मैपिंग है; workflows API के ज़रिए यह नोड का database_validation_field_sources है:
फिर हर सत्र इसी कुंजी के नीचे मान के साथ बनाएँ:
मैपिंग के बिना भी चरण चलता है, लेकिन वह tax_number को गायब बताता है और रजिस्ट्री से कभी पूछताछ नहीं करता। इसके लिए कोई शुल्क नहीं लगता, और सत्र की database_validations प्रविष्टि में कारण दर्ज होता है।
2

लाइवनेस जाँच के साथ सेल्फ़ी कैप्चर करें

उसी वर्कफ़्लो में लाइवनेस चरण जोड़ें और वह तरीका चुनें जो आपकी जोखिम-सहनशीलता से मेल खाए: निष्क्रिय लाइवनेस (उपयोगकर्ता की ओर से कोई कार्रवाई नहीं), 3D फ़्लैश, या 3D एक्शन और फ़्लैश (सक्रिय तरीके जो प्रकाश पैटर्न प्रोजेक्ट करते हैं, जिनमें आखिरी में एक यादृच्छिक कार्रवाई भी जुड़ती है)। इसे Business Console में या workflows API के ज़रिए face_liveness_method (PASSIVE, FLASHING, या ACTIVE_3D) से सेट करें। जो भी चुनें, Didit कैप्चर चरण दिखाता है और पुष्टि करता है कि वास्तविक, मौजूद व्यक्ति है। इसी से रोका जाता है कि संग्रहीत फ़ोटो या स्क्रीन रीप्ले जमा किया जाए।
3

Unico IDCloud से CPF और सेल्फ़ी का सत्यापन करें

सत्र फ़्लो के भीतर Didit लाइवनेस सेल्फ़ी को अपने-आप दोबारा उपयोग करता है, आपको कभी इमेज नहीं संभालनी पड़ती, और ऊपर की मैपिंग से CPF पढ़ता है। IDCloud फिर पुष्टि करता है कि वह चेहरा उसी व्यक्ति का है जिसका CPF है। इस चरण को सिर्फ़ ये दो इनपुट चाहिए; यदि आप metadata में full_name या date_of_birth भी भेजते हैं और उन्हें मैप करते हैं, तो वे Unico को क्रॉस-जाँच के रूप में भेजे जाते हैं, पर वे अनिवार्य नहीं हैं।
यह केवल-CPF फ़्लो सत्र और वर्कफ़्लो इंटीग्रेशन पर लागू होता है, जहाँ Didit कैप्चर करता है और लाइवनेस सेल्फ़ी आपके लिए इस सेवा को भेजता है। यदि आप POST /v3/database-validation/ को सीधे कॉल करते हैं, तो selfie एक अनिवार्य फ़ाइल इनपुट है और इमेज आपको स्वयं देनी होगी। दोनों मोड के लिए डेटाबेस सत्यापन अवलोकन देखें।
लागत: निष्क्रिय लाइवनेस के साथ प्रति सत्यापित उपयोगकर्ता लगभग $0.30 आता है, जो IDCloud क्वेरी के लिए $0.20 और लाइवनेस जाँच के लिए $0.10 मिलाकर बनता है। सक्रिय तरीके के साथ यह लगभग $0.35 है, जहाँ लाइवनेस जाँच $0.15 की है। ये सूची मूल्य हैं: इनमें से हर एक पर आपकी प्लान छूट लागू होती है; देखें मूल्य निर्धारण। लगभग 4% उपयोगकर्ताओं के लिए कवरेज न होने पर विकल्प। जब IDCloud INCONCLUSIVE लौटाता है, तो रजिस्ट्री उस CPF को किसी उपयोगी बायोमेट्रिक रिकॉर्ड से नहीं जोड़ सकी, आम तौर पर इसलिए कि व्यक्ति उसमें नहीं है। इसे विफल जाँच नहीं, बल्कि “कोई उत्तर नहीं” मानें, और पूर्ण पहचान सत्यापन पर लौटें: दस्तावेज़ कैप्चर और दस्तावेज़ चित्र से चेहरा मिलान। हर उपयोगकर्ता सत्यापन योग्य रहता है, और दस्तावेज़ सत्यापन का शुल्क केवल छोटे से शेष हिस्से पर लगता है। अस्वीकृतियों को संभालना। BIOMETRIC_NO_MATCH का अर्थ है कि रजिस्ट्री ने सक्रिय रूप से असहमति जताई: चेहरा उस CPF का नहीं है। इसे एक मज़बूत नकारात्मक संकेत मानें, दोबारा प्रयास करने का संकेत नहीं। उपयोगकर्ता को सीधे दस्तावेज़ कैप्चर पर भेजना ठीक वही रास्ता है जो धोखेबाज़ चाहता है, क्योंकि दस्तावेज़ वही चीज़ है जिस पर वे नियंत्रण रखते हैं। फिर भी गलत नकारात्मक परिणाम होते हैं: बदला हुआ रूप, पुरानी रजिस्ट्री फ़ोटो, या खराब कैप्चर। इसलिए इन्हें मैन्युअल समीक्षा में भेजें, न कि अपने-आप स्वीकृत करें और न ही उपयोगकर्ता का आगे बढ़ने का रास्ता बंद करें। BIOMETRIC_IMAGE_UNUSABLE अलग है: सेल्फ़ी पढ़ी ही नहीं जा सकी, इसलिए नई सेल्फ़ी माँगें। हर परिणाम सत्र पर क्या असर डाले, यह आंशिक मिलान / कोई मिलान नहीं होने पर की जाने वाली कार्रवाइयों से तय करें, और पूरी सूची के लिए परिणाम कोड देखें। लौटने वाले उपयोगकर्ता। रजिस्ट्री लुकअप का शुल्क आपको केवल एक बार देना होता है। इस फ़्लो को पास करने के बाद लाइवनेस सेल्फ़ी उनके vendor_data में संग्रहीत हो जाती है, ताकि आप बाद में बायोमेट्रिक प्रमाणीकरण से उन्हें दोबारा सत्यापित कर सकें: उस संग्रहीत चेहरे से लाइवनेस जाँच और चेहरा मिलान, $0.10 में, और उसी लाइवनेस तरीकों के विकल्प के साथ। ध्यान दें कि यह लौटने वाले उपयोगकर्ताओं के लिए है। बायोमेट्रिक-प्रमाणीकरण सत्र को संग्रहीत चेहरा (या आपका दिया portrait_image) चाहिए, और यदि उपयोगकर्ता के पास दोनों में से कोई न हो तो सत्र बनाते समय ही विफल हो जाता है। इसलिए पहली बार आने वाले उपयोगकर्ता ऊपर वाले फ़्लो से ही गुज़रेंगे।

आगे पढ़ें

अंतिम संशोधन 7 नवंबर 2026