मुख्य सामग्री पर जाएं

अवलोकन

इनलाइन चेकआउट आपको पूरी तरह से एकीकृत चेकआउट अनुभव बनाने की अनुमति देता है जो आपकी वेबसाइट या एप्लिकेशन के साथ सहजता से मिश्रित होता है। ओवरले चेकआउट के विपरीत, जो आपकी पृष्ठ पर एक मोडल के रूप में खुलता है, इनलाइन चेकआउट भुगतान फॉर्म को सीधे आपकी पृष्ठ लेआउट में एम्बेड करता है। इनलाइन चेकआउट का उपयोग करके, आप:
  • ऐसे चेकआउट अनुभव बनाएं जो आपके ऐप या वेबसाइट के साथ पूरी तरह से एकीकृत हों
  • डोडो पेमेंट्स को सुरक्षित रूप से ग्राहक और भुगतान जानकारी एक अनुकूलित चेकआउट फ्रेम में कैप्चर करने दें
  • अपनी पृष्ठ पर डोडो पेमेंट्स से आइटम, कुल और अन्य जानकारी प्रदर्शित करें
  • उन्नत चेकआउट अनुभव बनाने के लिए SDK विधियों और घटनाओं का उपयोग करें
इनलाइन चेकआउट कवर छवि

यह कैसे काम करता है

इनलाइन चेकआउट आपकी वेबसाइट या ऐप में एक सुरक्षित डोडो पेमेंट्स फ्रेम को एम्बेड करके काम करता है। चेकआउट फ्रेम ग्राहक जानकारी एकत्र करने और भुगतान विवरण कैप्चर करने का काम करता है। आपकी पृष्ठ पर आइटम सूची, कुल और चेकआउट पर जो कुछ है उसे बदलने के विकल्प प्रदर्शित होते हैं। SDK आपकी पृष्ठ और चेकआउट फ्रेम के बीच बातचीत करने की अनुमति देता है। डोडो पेमेंट्स स्वचालित रूप से एक चेकआउट पूरा होने पर एक सदस्यता बनाता है, जिसे आप प्रावधान करने के लिए तैयार कर सकते हैं।
इनलाइन चेकआउट फ्रेम सभी संवेदनशील भुगतान जानकारी को सुरक्षित रूप से संभालता है, आपके पक्ष पर अतिरिक्त प्रमाणपत्र के बिना PCI अनुपालन सुनिश्चित करता है।

एक अच्छा इनलाइन चेकआउट क्या बनाता है?

यह महत्वपूर्ण है कि ग्राहकों को पता हो कि वे किससे खरीद रहे हैं, वे क्या खरीद रहे हैं, और वे कितना भुगतान कर रहे हैं। एक इनलाइन चेकआउट बनाने के लिए जो अनुपालन में हो और रूपांतरण के लिए अनुकूलित हो, आपकी कार्यान्वयन में शामिल होना चाहिए:
आवश्यक तत्वों के लेबल के साथ इनलाइन चेकआउट उदाहरण
  1. दोहराने की जानकारी: यदि यह दोहराने वाला है, तो यह कितनी बार दोहराता है और नवीनीकरण पर कुल कितना भुगतान करना है। यदि यह एक परीक्षण है, तो परीक्षण कितने समय तक चलता है।
  2. आइटम विवरण: जो खरीदा जा रहा है उसका विवरण।
  3. लेनदेन कुल: लेनदेन कुल, जिसमें उप-योग, कुल कर, और समग्र कुल शामिल हैं। सुनिश्चित करें कि मुद्रा भी शामिल है।
  4. डोडो पेमेंट्स फ़ुटर: पूरा इनलाइन चेकआउट फ्रेम, जिसमें चेकआउट फ़ुटर शामिल है जिसमें डोडो पेमेंट्स, हमारी बिक्री की शर्तें, और हमारी गोपनीयता नीति के बारे में जानकारी है।
  5. रिफंड नीति: आपकी रिफंड नीति का एक लिंक, यदि यह डोडो पेमेंट्स की मानक रिफंड नीति से भिन्न है।
हमेशा पूरा इनलाइन चेकआउट फ़्रेम, फ़ूटर सहित, प्रदर्शित करें। कानूनी जानकारी को हटाना या छिपाना अनुपालन आवश्यकताओं का उल्लंघन करता है।

ग्राहक यात्रा

चेकआउट प्रवाह आपकी चेकआउट सत्र कॉन्फ़िगरेशन द्वारा निर्धारित होता है। जिस तरह से आप चेकआउट सत्र को कॉन्फ़िगर करते हैं, उसके आधार पर, ग्राहक एक चेकआउट का अनुभव करेंगे जो एक ही पृष्ठ पर सभी जानकारी प्रस्तुत कर सकता है या कई चरणों में।
1

Customer opens checkout

आप इनलाइन चेकआउट को आइटम या मौजूदा लेनदेन पास करके खोल सकते हैं। SDK का उपयोग पेज पर जानकारी दिखाने और अपडेट करने के लिए करें, और ग्राहक संपर्क के आधार पर आइटम अपडेट करने के लिए SDK विधियों का उपयोग करें।आइटम सूची और भुगतान फॉर्म के साथ प्रारंभिक चेकआउट पृष्ठ
2

Customer enters their details

इनलाइन चेकआउट पहले ग्राहकों से उनके ईमेल पते, उनके देश का चयन करने, और (जहां आवश्यक हो) उनके ZIP या पोस्टल कोड दर्ज करने के लिए कहता है। यह चरण सभी आवश्यक जानकारी एकत्र करता है ताकि कर और उपलब्ध भुगतान विकल्पों का निर्धारण किया जा सके।आप ग्राहक विवरण को पूर्व-भर सकते हैं और अनुभव को सरल बनाने के लिए सहेजे गए पते प्रस्तुत कर सकते हैं।
3

Customer selects payment method

अपने विवरण दर्ज करने के बाद, ग्राहकों को उपलब्ध भुगतान विधियों और भुगतान फॉर्म के साथ प्रस्तुत किया जाता है। विकल्पों में क्रेडिट या डेबिट कार्ड, PayPal, Apple Pay, Google Pay, और उनके स्थान के आधार पर अन्य स्थानीय भुगतान विधियाँ शामिल हो सकती हैं।यदि उपलब्ध हो तो चेकआउट को तेज़ करने के लिए सहेजे गए भुगतान विधियों को प्रदर्शित करें।उपलब्ध भुगतान विधियाँ और कार्ड विवरण फॉर्म
4

Checkout completed

डोडो पेमेंट्स हर भुगतान को उस बिक्री के लिए सबसे अच्छे अधिग्रहणकर्ता के पास रूट करता है ताकि सफलता की सबसे अच्छी संभावना मिल सके। ग्राहक एक सफलता कार्यप्रवाह में प्रवेश करते हैं जिसे आप बना सकते हैं।पुष्टि के चेकमार्क के साथ सफल स्क्रीन
5

Dodo Payments creates subscription

डोडो पेमेंट्स स्वचालित रूप से ग्राहक के लिए एक सदस्यता बनाता है, जिसे आप प्रावधान करने के लिए तैयार कर सकते हैं। ग्राहक द्वारा उपयोग की गई भुगतान विधि नवीनीकरण या सदस्यता परिवर्तनों के लिए फ़ाइल पर रखी जाती है।वेबहुक अधिसूचना के साथ सदस्यता बनाई गई

त्वरित प्रारंभ

कुछ कोड की पंक्तियों में Dodo Payments इनलाइन चेकआउट के साथ शुरू करें:
सुनिश्चित करें कि आपके पेज पर संबंधित id वाला एक container element मौजूद है: <div id="dodo-inline-checkout"></div>

चरण-दर-चरण एकीकरण गाइड

1

Install the SDK

Dodo Payments चेकआउट SDK स्थापित करें:
2

Initialize the SDK for Inline Display

SDK को इनिशियलाइज़ करें और displayType: 'inline' निर्दिष्ट करें। आपको checkout.breakdown इवेंट को भी सुनना चाहिए ताकि आप अपने UI को वास्तविक समय के कर और कुल गणनाओं के साथ अपडेट कर सकें।
3

Create a Container Element

अपने HTML में एक तत्व जोड़ें जहाँ चेकआउट फ्रेम इंजेक्ट किया जाएगा:
4

Open the Checkout

अपने कंटेनर के checkoutUrl और elementId के साथ DodoPayments.Checkout.open() कॉल करें:
5

Test Your Integration

  1. अपने विकास सर्वर को प्रारंभ करें:
  1. चेकआउट प्रवाह का परीक्षण करें:
    • इनलाइन फ्रेम में अपना ईमेल और पता विवरण दर्ज करें।
    • सत्यापित करें कि आपका कस्टम ऑर्डर सारांश वास्तविक समय में अपडेट होता है।
    • परीक्षण क्रेडेंशियल्स का उपयोग करके भुगतान प्रवाह का परीक्षण करें।
    • पुष्टि करें कि रीडायरेक्ट सही ढंग से काम करते हैं।
यदि आपने onEvent कॉलबैक में एक कंसोल लॉग जोड़ा है, तो आपको ब्राउज़र कंसोल में checkout.breakdown इवेंट्स लॉग होते हुए दिखने चाहिए।
6

Go Live

जब आप उत्पादन के लिए तैयार हों:
  1. मोड को 'live' में बदलें:
  1. अपने चेकआउट URLs को अपने बैकएंड से लाइव चेकआउट सत्रों का उपयोग करने के लिए अपडेट करें।
  2. उत्पादन में पूरे प्रवाह का परीक्षण करें।

पूर्ण React उदाहरण

यह उदाहरण दिखाता है कि कैसे इनलाइन चेकआउट के साथ एक कस्टम ऑर्डर सारांश को लागू किया जाए, checkout.breakdown इवेंट का उपयोग करके उन्हें सिंक में रखा जाए।

API संदर्भ

कॉन्फ़िगरेशन

प्रारंभिक विकल्प

चेकआउट विकल्प

विधियाँ

चेकआउट खोलें

निर्दिष्ट कंटेनर में चेकआउट फ्रेम खोलता है।
आप चेकआउट व्यवहार को अनुकूलित करने के लिए अतिरिक्त विकल्प भी पास कर सकते हैं:

चेकआउट बंद करें

प्रोग्रामेटिक रूप से चेकआउट फ्रेम को हटा देता है और इवेंट लिसेनर्स को साफ करता है।

स्थिति जांचें

विवरण देता है कि चेकआउट फ्रेम वर्तमान में इंजेक्टेड है या नहीं।

इवेंट्स

SDK वास्तविक समय की घटनाएं प्रदान करता है onEvent कॉलबैक के माध्यम से। इनलाइन चेकआउट के लिए, checkout.breakdown विशेष रूप से आपके UI को सिंक करने के लिए उपयोगी है।

चेकआउट ब्रेकडाउन डेटा

checkout.breakdown घटना निम्न डेटा प्रदान करती है:

ब्रेकडाउन इवेंट को समझना

checkout.breakdown घटना आपके एप्लिकेशन के UI को Dodo Payments चेकआउट स्थिति के साथ सिंक में रखने का प्राथमिक तरीका है। यह कब फायर करता है:
  • आरंभ करने पर: ठीक बाद में जब चेकआउट फ्रेम लोड हो जाता है और तैयार होता है।
  • पता बदलने पर: जब भी ग्राहक किसी देश का चयन करता है या एक पोस्टल कोड दर्ज करता है जिससे टैक्स पुनर्गणना होती है।
फील्ड विवरण: प्रमुख एकीकरण युक्तियाँ:
  1. मुद्रा स्वरूपण: मूल्य हमेशा सबसे छोटी मुद्रा इकाई (जैसे, USD के लिए सेंट्स, JPY के लिए येन) में पूर्णांकों के रूप में लौटाए जाते हैं। उन्हें दिखाने के लिए, 100 से विभाजित करें (या उपयुक्त 10 की शक्ति) या एक स्वरूपण लाइब्रेरी का उपयोग करें जैसे Intl.NumberFormat
  2. प्रारंभिक राज्यों को संभालना: जब चेकआउट पहली बार लोड होता है, tax और discount 0 या null हो सकते हैं जब तक कि उपयोगकर्ता अपने बिलिंग जानकारी प्रदान नहीं करता या एक कोड लागू नहीं करता। आपका UI इन राज्यों को अनुग्रहपूर्वक संभालना चाहिए (जैसे, एक डैश दिखाना या रो को छिपाना)।
  3. “फाइनल टोटल” बनाम “टोटल”: जबकि total आपको मानक मूल्य की गणना देता है, finalTotal लेनदेन के लिए सत्य का स्रोत है। यदि finalTotal मौजूद है, तो यह ग्राहक के कार्ड पर सही रूप से चार्ज किया जाएगा, जिसमें कोई डायनामिक समायोजन शामिल हो।
  4. वास्तविक समय प्रतिक्रिया: टैक्‍सेस को वास्तविक समय में उपयोगकर्ताओं को दिखाने के लिए tax फ़ील्ड का उपयोग करें। इससे आपके चेकआउट पेज को “लाइव” फील मिलता है और पते के प्रवेश चरण के दौरान घर्षण कम होता है।

कार्यान्वयन विकल्प

पैकेज प्रबंधक स्थापना

स्टेप-बाय-स्टेप इंटीग्रेशन गाइड में दिखाए गए अनुसार npm, yarn, या pnpm के माध्यम से इंस्टॉल करें।

CDN कार्यान्वयन

बिल्ड स्टेप के बिना त्वरित एकीकरण के लिए, आप हमारे CDN का उपयोग कर सकते हैं:

भुगतान विधि अपडेट करें

इनलाइन चेकआउट सदस्यताओं के लिए भुगतान विधि अपडेट का समर्थन करता है। जब किसी ग्राहक को उनकी भुगतान विधि अपडेट करने की ज़रूरत होती है - चाहे किसी सक्रिय सदस्यता के लिए हो या किसी स्थगित सदस्यता को पुन: सक्रिय करने के लिए - आप अपनी पेज लेआउट के भीतर सीधे अपडेट प्रवाह प्रस्तुत कर सकते हैं।

यह कैसे काम करता है

  1. भुगतान विधि अपडेट API को कॉल करें ताकि आपको एक payment_link मिल सके:
  1. पारित किए गए payment_link को checkoutUrl के रूप में इनलाइन चेकआउट खोलने के लिए:
इनलाइन फ्रेम केवल भुगतान विधि संग्रह फॉर्म प्रस्तुत करता है। ग्राहक नए कार्ड विवरण दर्ज कर सकते हैं या बिना आपके पेज को छोड़े एक सहेजी गई भुगतान विधि का चयन कर सकते हैं।

होल्ड पर सदस्यताओं के लिए

जब on_hold स्थिति में सदस्यता के लिए भुगतान विधि को अपडेट किया जाता है, Dodo Payments किसी भी बकाया शुल्क के लिए स्वतः चार्ज बनाता है। पुन: सक्रियता की पुष्टि के लिए payment.succeeded और subscription.active वेबहुक मॉनिटर करें।
आप नवीन विवरण एकत्र करने के बजाय एक मौजूदा सहेजी गई भुगतान विधि का उपयोग कर सकते हैं, इसके लिए_type: 'existing' को payment_method_id के साथ भुगतान विधि अपडेट API में पास करके।

त्रुटि प्रबंधन

SDK इवेंट सिस्टम के माध्यम से विस्तृत त्रुटि जानकारी प्रदान करता है। हमेशा अपने onEvent कॉलबैक में उचित त्रुटि प्रबंधन को लागू करें:
जब समस्याएं होती हैं तो उपयोगकर्ता अनुभव को बेहतर बनाने के लिए हमेशा checkout.error इवेंट को संसाधित करें।

सर्वोत्तम प्रथाएँ

  1. उत्तरदायी डिज़ाइन: सुनिश्चित करें कि आपकी कंटेनर तत्व में पर्याप्त चौड़ाई और ऊंचाई है। आईफ्रेम आमतौर पर इसके कंटेनर को भरने के लिए विस्तार करेगा।
  2. सिंक्रनाइज़ेशन: अपने कस्टम ऑर्डर सारांश या मूल्य निर्धारण टेबल को चेकआउट फ्रेम में दिखाए गए ग्राहक की दृष्टि से सिंक में रखने के लिए checkout.breakdown इवेंट का उपयोग करें।
  3. स्केलेटन स्टेट्स: जब तक checkout.opened इवेंट फायर ना हो, तब तक अपने कंटेनर में एक लोडिंग इंडिकेटर दिखाएं।
  4. सफाई: जब आपका घटक अनमाउंट हो तो आईफ्रेम और इवेंट लिसनर्स की सफाई के लिए DodoPayments.Checkout.close() को कॉल करें।
डार्क मोड कार्यान्वयन के लिए, इनलाइन चेकआउट फ्रेम के साथ अधिकतम दृश्य इंटीग्रेशन के लिए #0d0d0d को पृष्ठभूमि के रंग के रूप में उपयोग करने की अनुशंसा की जाती है।

भुगतान स्थिति सत्यापन

चेकआउट इवेंट्स पर विशेष रूप से निर्भर न रहें ताकि भुगतान का सफल या असफल होना जान सकें। हमेशा वेबहुक और/या पोलिंग का उपयोग करके सर्वर-साइड वेलिडेशन को लागू करें।

क्यों सर्वर-साइड सत्यापन आवश्यक है

हालांकि इनलाइन चेकआउट इवेंट्स वास्तविक समय प्रतिक्रिया प्रदान करते हैं, वे आपके भुगतान स्टेटस का एकमात्र सत्य का स्रोत नहीं होना चाहिए। नेटवर्क समस्याएँ, ब्राउज़र क्रैश, या उपयोगकर्ताओं द्वारा पेज बंद करने से घटनाएँ छूट सकती हैं। विश्वसनीय भुगतान सत्यापन सुनिश्चित करने के लिए:
  1. आपका सर्वर वेबहुक इवेंट्स सुने - Dodo Payments भुगतान स्थिति परिवर्तनों के लिए वेबहुक भेजता है
  2. एक पोलिंग तंत्र लागू करें - आपकी फ्रंटेंड को आपके सर्वर से स्थिति अपडेट्स के लिए पोल करें
  3. दोनों दृष्टिकोणों का संयोजन करें - वेबहुक को प्राथमिक स्रोत के रूप में उपयोग करें और पोलिंग को बैकअप के रूप में

सिफारिश की गई संरचना

कार्यान्वयन चरण

1. चेकआउट इवेंट्स सुनें - जब उपयोगकर्ता पे पर क्लिक करता है, तो स्थिति की सत्यता की तैयारी शुरू करें:
2. अपने सर्वर को पोल करें - एक एंडपॉइंट बनाएं जो आपके डेटाबेस में भुगतान की स्थिति की जांच करता है (जो वेबहुक्स द्वारा अपडेट किया गया है):
3. वेबहुक्स को सर्वर-साइड पर प्रबंधित करें - जब Dodo payment.succeeded या payment.failed वेबहुक्स भेजता है, तो अपने डेटाबेस को अपडेट करें। विवरण के लिए हमारे वेबहुक्स दस्तावेज़ीकरण देखें।

समस्या निवारण

  • सत्यापित करें कि elementId यथार्थ में DOM में मौजूद id से मेल खाता है।
  • सुनिश्चित करें कि displayType: 'inline' को Initialize को पास किया गया था।
  • यह जांचें कि checkoutUrl वैध है।
  • सुनिश्चित करें कि आप checkout.breakdown इवेंट सुन रहे हैं।
  • टैक्स केवल तभी गणना किए जाते हैं जब उपयोगकर्ता चेकआउट फ्रेम में एक वैध देश और पोस्टल कोड दर्ज करता है।

डिजिटल वॉलेट्स सक्षम करें

Apple Pay, Google Pay, और अन्य डिजिटल वॉलेट्स सेट अप करने के लिए विस्तृत जानकारी के लिए डिजिटल वॉलेट्स पृष्ठ देखें।

Apple Pay के लिए त्वरित सेटअप

डोमेन सत्यापन केवल इनलाइन (एम्बेडेड) चेकआउट के लिए आवश्यक है। ओवरले चेकआउट, होस्टेड चेकआउट और भुगतान लिंक को इसकी आवश्यकता नहीं होती है।
Apple Pay प्रति डोमेन डैशबोर्ड से सत्यापित किया जाता है।
1

Open Wallet domains

Settings → Payment Methods पर जाएं और Apple Pay पंक्ति में Manage domains पर क्लिक करें।
Payment Methods सेटिंग्स में Apple Pay पंक्ति पर Manage domains बटन
2

Download the domain association file

वॉलेट डोमेन पैनल से एसोसिएशन फ़ाइल डाउनलोड करें।
डॉउनलोड फ़ाइल बटन के साथ वॉलेट डोमेन पैनल
3

Register your domain

Register domain पर क्लिक करें और वह डोमेन दर्ज करें जहां आप इनलाइन चेकआउट एम्बेड करते हैं (उदाहरण के लिए shop.example.com), फिर Continue
डोमेन दर्ज किए गए डोमेन रूप को पंजीकृत करें
4

Host the file on your domain

इसे यहां होस्ट करें:
इसे HTTPS पर सर्व करना चाहिए, बिना रीडायरेक्ट के पहुंच योग्य होना चाहिए, और Content-Type: application/octet-stream या text/plain के साथ सर्व करना चाहिए।
5

Verify the domain

Verify domain पर क्लिक करें। Dodo Payments पुष्टि करता है कि फ़ाइल लाइव है और आपका डोमेन Apple को सबमिट करता है।
एसोसिएशन फ़ाइल होस्ट पथ और Verify domain बटन के साथ अपना डोमेन सत्यापित करें स्क्रीन
6

Confirm it's active

जब स्थिति Active दिखाती है, तो उस डोमेन के लिए Apple Pay सक्षम होता है। प्रति डोमेन इसे चालू या बंद करने के लिए Enabled टॉगल का उपयोग करें।
वॉलेट डोमेन सूची, जिसमें सक्रिय Apple Pay स्थिति और सक्षम टॉगल के साथ डोमेन दिखाई देती हैं
7

Test the integration

  1. Apple डिवाइस पर चेकआउट खोलें
  2. सुनिश्चित करें कि Apple Pay बटन दिखाई दे
  3. एक परीक्षण लेन-देन पूरा करें

ब्राउज़र समर्थन

Dodo Payments Checkout SDK निम्नलिखित ब्राउज़र का समर्थन करता है:
  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)
  • IE11+

इनलाइन बनाम ओवरले चेकआउट

अपने उपयोग के मामले के लिए सही चेकआउट प्रकार चुनें:
जब आप चेकआउट अनुभव पर अधिकतम नियंत्रण और सीमलेस ब्रांडिंग चाहते हैं, तो इनलाइन चेकआउट का उपयोग करें। आपके मौजूदा पृष्ठों में न्यूनतम परिवर्तनों के साथ तेज़ एकीकरण के लिए ओवरले चेकआउट का उपयोग करें।

संबंधित संसाधन

Overlay Checkout

त्वरित मोडल-आधारित एकीकरण के लिए ओवरले चेकआउट का उपयोग करें।

Checkout Sessions API

अपने चेकआउट अनुभवों को सशक्त बनाने के लिए चेकआउट सत्र बनाएं।

Webhooks

वेबहुक के साथ सर्वर-साइड भुगतान इवेंट को संभालें।

Integration Guide

Dodo Payments को एकीकृत करने के लिए पूर्ण मार्गदर्शिका।
अधिक सहायता के लिए, हमारी Discord community पर जाएं या हमारे डेवलपर सहायता दल से संपर्क करें।
अंतिम संशोधन 9 जुलाई 2026