अवलोकन
पते का प्रमाण (POA) सत्यापन निष्कर्षण और फ़ोरेंसिक विश्लेषण के दौरान पाई गई प्रत्येक गुणवत्ता, प्रामाणिकता या मिलान संबंधी समस्या के लिएpoa_verifications[].warnings[] पर चेतावनियाँ जारी करता है। प्रत्येक चेतावनी एक चेतावनी ऑब्जेक्ट होती है जिसमें feature को "PROOF_OF_ADDRESS" पर सेट किया गया होता है। कुछ जोखिम हमेशा Declined लागू करते हैं; बाकी आपके वर्कफ़्लो पर कॉन्फ़िगर की गई प्रति-जोखिम कार्रवाई (DECLINE / REVIEW / NO_ACTION) का पालन करते हैं।
नीचे दिए गए प्रत्येक जोखिम को लाइव निर्णय पाइपलाइन के विरुद्ध सत्यापित किया गया है; सटीक संक्षिप्त और विस्तृत विवरण स्ट्रिंग्स तालिकाओं में हूबहू प्रस्तुत की गई हैं।
POA निष्कर्षण प्रति दस्तावेज़ 5–15 सेकंड का विलंब जोड़ता है। चेतावनियाँ केवल तभी लिखी जाती हैं जब वर्कफ़्लो चरण पूरा हो जाता है; हर 5 सेकंड से अधिक तेज़ी से पोल न करें।
दो प्रोडक्शन पाथ
POA चेतावनियाँ दो अलग-अलग पाथ पर उत्पन्न होती हैं, और जोखिम सेट उनके बीच भिन्न होता है:- वर्कफ़्लो सत्र (सत्यापन सत्र के अंदर POA चरण) — अपलोड endpoint पहले पुनः प्रयास लूप के साथ ब्लॉकिंग सत्यापन चलाता है (देखें पुनः प्रयास व्यवहार), फिर अंतिम संग्रहीत चेतावनियों की गणना
check_poa_risksऔर बहु-दस्तावेज़ नाम जाँच द्वारा की जाती है। - स्वतंत्र API (
POST /v3/poa/) — चेतावनियाँ केवलcheck_poa_risksसे आती हैं। कोई पुनः प्रयास लूप नहीं होता, कोई सत्यापित-ID संदर्भ नहीं होता, और केवल एक दस्तावेज़ होता है, इसलिएNAME_MISMATCH_ID_VERIFICATION,POA_NAME_MISMATCH_BETWEEN_DOCUMENTS,POA_MAX_ATTEMPTS_EXCEEDED, औरFUTURE_ISSUE_DATEस्वतंत्र API द्वारा कभी नहीं उत्पन्न किए जाते हैं। इस पाथ पर निष्कर्षण-पूर्व सत्यापन त्रुटियों को छोड़ दिया जाता है।
POOR_DOCUMENT_QUALITY को जोखिम enum में परिभाषित किया गया है और कार्रवाई मैपिंग में आरक्षित रखा गया है, लेकिन POA पाइपलाइन में कोई भी कोड पाथ इसे उत्पन्न नहीं करता है — यह किसी भी पाथ पर warnings[] में कभी दिखाई नहीं देता है। इस पर ब्रांच न करें।
ऑटो-अस्वीकार चेतावनियाँ (हमेशा स्थिति Declined करती हैं)
ये जोखिम AUTO_DECLINE_RISKS में शामिल हैं; जब लॉग किए जाते हैं, तो कॉन्फ़िगरेशन की परवाह किए बिना POA स्थिति Declined होती है, और log_type हमेशा error होता है।
FUTURE_ISSUE_DATE को भी AUTO_DECLINE_RISKS में सूचीबद्ध किया गया है, लेकिन इसे निष्कर्षण-पूर्व सत्यापन में केवल एक ही स्थान पर उत्पन्न किया जाता है (भविष्य में 7 दिनों से अधिक की जारी करने की तिथि) जिसकी त्रुटियाँ केवल वर्कफ़्लो पुनः प्रयास लूप को फ़ीड करती हैं — यह वहां एक ब्लॉकिंग अपलोड त्रुटि के रूप में सामने आता है, स्वतंत्र API द्वारा कभी उत्पन्न नहीं किया जाता है, और इसे warnings[] में नहीं लिखा जाता है। देखें पुनः प्रयास व्यवहार।
कॉन्फ़िगर करने योग्य चेतावनियाँ
इनमें से हर चेतावनी वर्कफ़्लो के POA नोड पर किसी कार्रवाई विकल्प (DECLINE / REVIEW / NO_ACTION) का अनुसरण करती है। चेतावनी का log_type कॉन्फ़िगर की गई कार्रवाई से मेल खाता है: अस्वीकार के लिए error, समीक्षा के लिए warning और कोई कार्रवाई नहीं के लिए information।
सभी नाम और पता मिलान जोखिमों के लिए एक साझा कार्रवाई है:
poa_name_or_address_mismatch_action दोनों नाम जोखिमों, दोनों पता जोखिमों और दस्तावेज़ों के बीच नाम जाँच को कवर करता है। आप नाम और पते के मिलान व्यवहार को अलग-अलग कॉन्फ़िगर नहीं कर सकते। स्टैंडअलोन API पर यही समूह poa_address_mismatch_action अनुरोध विकल्प का अनुसरण करता है (poa_name_mismatch_action विकल्प स्वीकार किया जाता है, लेकिन उसे कभी पढ़ा नहीं जाता)।स्टैंडअलोन API अंतर (POST /v3/poa/)
स्टैंडअलोन endpoint समान जोखिम-से-कार्रवाई मैपिंग बनाता है लेकिन अनुरोध-स्तरीय विकल्पों के साथ जो केवल DECLINE या NO_ACTION स्वीकार करते हैं (सभी डिफ़ॉल्ट रूप से DECLINE पर सेट होते हैं):
UNABLE_TO_EXTRACT_ISSUE_DATEऔरPOA_NAME_NOT_DETECTEDइस endpoint पर अस्वीकार करने के लिए हार्ड-कोड किए गए हैं।POA_DOCUMENT_NOT_SUPPORTED_FOR_APPLICATIONऔरUNPARSABLE_OR_INVALID_ADDRESSयहाँ सूचनात्मक हैं — उनकी कार्रवाइयाँ डिफ़ॉल्ट रूप से कोई कार्रवाई नहीं पर होती हैं और प्रति अनुरोध कॉन्फ़िगर करने योग्य नहीं होती हैं।FUTURE_ISSUE_DATE,POOR_DOCUMENT_QUALITY,NAME_MISMATCH_ID_VERIFICATION,POA_NAME_MISMATCH_BETWEEN_DOCUMENTS, औरPOA_MAX_ATTEMPTS_EXCEEDEDकभी उत्पन्न नहीं होते हैं — इस endpoint पर भविष्य की तिथि वाले दस्तावेज़ को स्वतः अस्वीकृत नहीं किया जाता है।
पुनः प्रयास का व्यवहार (वर्कफ़्लो सत्र)
सत्यापन सत्र में, दस्तावेज़ स्वीकार किए जाने से पहले POA अपलोड चरण ब्लॉकिंग सत्यापन चलाता है। जब इसे कोई ब्लॉकिंग त्रुटि मिलती है —INVALID_DOCUMENT_TYPE, UNABLE_TO_EXTRACT_ISSUE_DATE, FUTURE_ISSUE_DATE, POA_NAME_NOT_DETECTED, MISSING_ADDRESS_INFORMATION, POA_COUNTRY_MISMATCH_WITH_PROVIDED, POA_DOCUMENT_NOT_SUPPORTED_FOR_APPLICATION, UNSUPPORTED_DOCUMENT_LANGUAGE, या POA_DOCUMENT_EXPIRED — तो अपलोड को 400 और संदेश के रूप में जोखिम कोड के साथ अस्वीकार कर दिया जाता है, और उपयोगकर्ता बेहतर दस्तावेज़ के साथ पुनः प्रयास कर सकता है।
POA_DOCUMENT_EXPIRED के लिए, 400 बॉडी में expiration_reason (printed_expiration या age_window) भी शामिल होता है ताकि आपका UI सटीक कारण दिखा सके; age_window पाथ पर यह अतिरिक्त रूप से max_age_months भी शामिल करता है। printed_expiration पाथ पर max_age_months को जानबूझकर छोड़ दिया जाता है, क्योंकि दस्तावेज़ को आयु विंडो के बजाय उसकी मुद्रित समाप्ति तिथि के कारण अस्वीकार किया गया था।
एक बार जब उपयोगकर्ता poa_max_retry_attempts प्रयास (डिफ़ॉल्ट 2, कॉन्फ़िगर करने योग्य 2–5) पूरे कर लेता है, तो सबमिशन को वैसे भी स्वीकार कर लिया जाता है: संग्रहीत चेतावनियों की सहेजे गए दस्तावेज़ से पुनः गणना की जाती है, POA_MAX_ATTEMPTS_EXCEEDED जोड़ दिया जाता है, और स्थिति का समाधान पूर्ण जोखिम सेट से किया जाता है। यही कारण है कि FUTURE_ISSUE_DATE अपलोड को ब्लॉक कर सकता है लेकिन कभी भी warnings[] में दिखाई नहीं देता।
कॉन्फ़िगर करने योग्य सेटिंग्स
वर्कफ़्लो का POA नोड ये सेटिंग्स उपलब्ध कराता है (VerificationSettings फ़ील्ड्स से मेल खाते हुए):
नाम मिलान तर्क
POA नाम मिलान सामान्य विविधताओं को सहन करता है:- मध्य नाम और आद्याक्षर का मिलान लचीले ढंग से किया जाता है (उपस्थिति/अनुपस्थिति की अनुमति है)।
- उम्मीदवार नाम — दस्तावेज़ पर पाए गए प्रत्येक नाम (
name_on_documentऔरadditional_names) को स्कोर किया जाता है, और सबसे अधिक स्कोर वाले उम्मीदवार को रखा जाता है। - मिलान थ्रेशोल्ड — डिफ़ॉल्ट
poa_name_match_score_threshold86 है; इससे कम स्कोर प्रासंगिकNAME_MISMATCH*चेतावनी को ट्रिगर करता है।
name_match_score_expected_details और name_match_score_id_verification (0–100) के रूप में प्रदर्शित होते हैं। कोई चेतावनी न होने पर भी बारीक समीक्षा के लिए स्कोर मान उपयोगी होते हैं।
उदाहरण
ओवरले हेरफेर (डिफ़ॉल्ट रूप से अस्वीकृति)
समय-सीमा समाप्त दस्तावेज़ + अनुपलब्ध पता (ऑटो-डिक्लाइन)
नाम बेमेल (डिफ़ॉल्ट रूप से समीक्षा)
संबंधित
- पते का प्रमाण रिपोर्ट — पूर्ण रिस्पॉन्स की संरचना, ओवरले-मैनिपुलेशन फोरेंसिक, स्थिति का अर्थ
- पते का प्रमाण अवलोकन — स्वीकृत दस्तावेज़ प्रकार
- डेटा मॉडल — पते का प्रमाण — विहित स्कीमा और चेतावनी ऑब्जेक्ट
- Webhooks —
status.updatedPOA चेतावनियाँ वहन करता है