मुख्य सामग्री पर जाएं
POST
cURL
अपने बैकएंड से अपनी एप्लिकेशन API कुंजी का उपयोग करके Google Wallet ID सत्यापन शुरू करें। आपको वर्कफ़्लो या workflow_id की आवश्यकता नहीं है। स्टार्ट रिस्पॉन्स अगली प्रमाणीकरण कार्रवाई का वर्णन करता है; यह स्वीकृत पहचान परिणाम नहीं है।

कवरेज और सक्रियण

वॉलेट सक्रियण API तैनाती और आपकी एप्लिकेशन की पात्रता से अलग है। दस्तावेज़ीकृत endpoint उस वॉलेट को सक्रिय नहीं करता जिसे “जल्द आ रहा है” के रूप में चिह्नित किया गया है। वर्तमान प्रकाशित दरों के लिए, डिजिटल ID वॉलेट मूल्य निर्धारण देखें।

व्यक्ति क्या करता है

आपका पेज या ऐप सीधे Google Wallet से पूछता है: कोई रीडायरेक्ट नहीं होता और Didit-होस्टेड पेज नहीं होता। उपयोगकर्ता के इशारे पर, उस origin पर जिससे आपने शुरुआत की थी, next_action.digital_credentials.request को navigator.credentials.get({digital: request}) कॉल में पास करें, या Android Credential Manager को GetDigitalCredentialOption के रूप में पास करें। फिर वॉलेट जो लौटाता है उसे वॉलेट प्रतिक्रिया सबमिट करें पर भेजें। जब वॉलेट किसी दूसरे डिवाइस पर हो, तो ब्राउज़र अपना QR कोड प्रस्तुत करता है।

परिणाम प्राप्त करें

सत्यापन को ट्रैक करने और उसका परिणाम प्राप्त करने के लिए डिजिटल ID वॉलेट API गाइड का पालन करें। केवल पूर्ण और सत्यापित परिणाम को ही इस बात का प्रमाण मानें कि वॉलेट ने व्यक्ति का प्रमाणीकरण किया है। लौटाई गई पहचान विशेषताएँ वॉलेट के अनुसार अलग-अलग होती हैं; यह न मानें कि पता, चित्र या अनुरोध की गई हर विशेषता मौजूद है।

संबंधित

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

हेडर

Idempotency-Key
string

वैकल्पिक पुनः प्रयास-सुरक्षा कुंजी (अधिकतम 255 वर्ण)। समान कुंजी, वॉलेट और बॉडी के साथ पुनः प्रयास करने पर दूसरा साइन-इन शुरू किए बिना मूल सत्यापन वापस मिलता है; किसी अन्य वॉलेट या बॉडी के साथ समान कुंजी 409 idempotency_key_reused लौटाती है।

बॉडी

Google Wallet सत्यापन (USA, GBR, BRA, SGP, TWN) शुरू करें।

country
enum<string>
आवश्यक

Google Wallet पहचान का ISO 3166-1 alpha-3 देश।

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
उपलब्ध विकल्प:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
आवश्यक

जहाँ आपका पेज या ऐप वॉलेट से पूछेगा: आपके पेज का https ऑरिजिन (इसका होस्ट एप्लिकेशन के allowed_return_hosts में होना चाहिए, या इसका व्हाइट लेबल डोमेन होना चाहिए), उदाहरण के लिए https://app.example.com, या android:apk-key-hash:<आपके ऐप के साइनिंग प्रमाणपत्र का बिना पैडिंग वाला base64 SHA-256>। वॉलेट किसी अन्य स्थान पर अनुरोध को अस्वीकार कर देता है।

Required string length: 1 - 256
vendor_data
string | null

इस सत्यापन के लिए आपका अपना संदर्भ (उदा. आपका उपयोगकर्ता id)। परिणामों और webhooks में वापस किया जाता है।

metadata
object | null

सत्यापन के साथ संग्रहीत और परिणामों तथा webhook में लौटाया गया वैकल्पिक JSON ऑब्जेक्ट।

sandbox_scenario
string

केवल सैंडबॉक्स एप्लिकेशन्स: सिम्युलेटेड परिणाम - 'wallet_cancelled', 'wallet_timeout' या 'wallet_provider_error'; कोई अन्य परिदृश्य (या कोई नहीं) सत्यापित करता है। लाइव एप्लिकेशन्स पर अस्वीकृत। पूरा कैटलॉग GET /v1/sandbox/scenarios/ पर उपलब्ध है।

Minimum string length: 1

प्रतिक्रिया

एक स्टैंडअलोन वॉलेट सत्यापन, जैसा कि प्रत्येक वॉलेट endpoint उत्तर देता है।

request_id
string<uuid>
आवश्यक
wallet_verification
object
आवश्यक
vendor_data
string | null
आवश्यक
metadata
object | null
आवश्यक

शुरुआत में भेजा गया मेटाडेटा ऑब्जेक्ट, या null।

created_at
string<date-time>
आवश्यक
अंतिम संशोधन 7 नवंबर 2026