Skip to main content
Inline checkout एक सुरक्षित payment form को सीधे आपके पेज लेआउट में एम्बेड करता है। overlay checkout के विपरीत, जो modal के रूप में खुलता है, inline checkout आपके पेज का हिस्सा बन जाता है। आप लेआउट नियंत्रित कर सकते हैं और checkout form के साथ अपना order summary दिखा सकते हैं।
ऑर्डर सारांश के साथ product page में एम्बेड किया गया inline checkout form

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

Inline checkout आपके पेज के container में एक सुरक्षित Dodo Payments frame रेंडर करता है। यह frame ग्राहक की जानकारी और payment details एकत्र करने का काम संभालता है। आपका पेज items, totals और अन्य जानकारी दिखाता है। SDK आपके पेज और checkout frame को एक-दूसरे के साथ communicate करने देता है। Checkout पूरा होने पर, Dodo Payments payment बनाता है या subscription product के लिए subscription बनाता है, और एक webhook भेजता है ताकि आप access provision कर सकें।
Inline checkout frame सभी संवेदनशील payment information को सुरक्षित रूप से संभालता है और आपके पक्ष में अतिरिक्त certification के बिना PCI compliance सुनिश्चित करता है।

एक अच्छा Inline Checkout किसे कहते हैं

ग्राहकों को पता होना चाहिए कि वे किससे खरीद रहे हैं, क्या खरीद रहे हैं और कितना भुगतान कर रहे हैं। आपके implementation में ये शामिल होने चाहिए:
आवश्यक elements के labels वाला inline checkout example

Example inline checkout layout showing required elements

  1. Recurring information: यदि भुगतान recurring है, तो इसकी frequency और renewal पर भुगतान की जाने वाली कुल राशि दिखाएँ। यदि trial है, तो trial की अवधि दिखाएँ।
  2. Item descriptions: खरीदी जा रही वस्तु का विवरण।
  3. Transaction totals: Currency सहित subtotal, total tax और grand total।
  4. Dodo Payments footer: पूरा inline checkout frame, जिसमें Dodo Payments की जानकारी, terms of sale और privacy policy वाला footer शामिल है।
  5. Refund policy: यदि आपकी refund policy Dodo Payments की standard refund policy से अलग है, तो उसकी link।
कानूनी जानकारी सहित पूरा inline checkout frame हमेशा दिखाएँ। इसे हटाना या छिपाना compliance requirements का उल्लंघन है।

Customer Journey

Checkout flow आपकी checkout session configuration पर निर्भर करता है। Session को configure करने के तरीके के आधार पर ग्राहकों को सारी जानकारी एक ही पेज पर या कई steps में दिखाई दे सकती है।
1

Customer opens checkout

आप checkout URL पास करके inline checkout खोलते हैं। पेज पर मौजूद जानकारी दिखाने और अपडेट करने के लिए checkout.breakdown जैसे SDK events का उपयोग करें।Items list और payment form वाला प्रारंभिक checkout page
2

Customer enters their details

Inline checkout सबसे पहले ग्राहकों से उनका email address दर्ज करने, अपना country चुनने और (जहाँ आवश्यक हो) ZIP या postal code दर्ज करने के लिए कहता है। यह step taxes और उपलब्ध payment options निर्धारित करने के लिए आवश्यक सभी जानकारी एकत्र करता है।अनुभव को सरल बनाने के लिए आप customer details पहले से भर सकते हैं और saved addresses दिखा सकते हैं।
3

Customer selects payment method

अपनी details दर्ज करने के बाद ग्राहकों को उपलब्ध payment methods और payment form दिखाई देते हैं। Location के आधार पर options में credit या debit card, PayPal, Apple Pay, Google Pay और अन्य local payment methods शामिल हो सकते हैं।Checkout को तेज़ बनाने के लिए, यदि उपलब्ध हों, तो saved payment methods दिखाएँ।उपलब्ध payment methods और card details form
4

Checkout completed

Dodo Payments हर payment को उस sale के लिए सबसे अच्छे acquirer के पास route करता है, ताकि सफलता की सबसे अच्छी संभावित संभावना मिल सके। ग्राहक आपके द्वारा बनाए गए success workflow में प्रवेश करते हैं।Confirmation checkmark वाली success screen
5

Dodo Payments creates the payment or subscription

Dodo Payments payment बनाता है या subscription product के लिए subscription बनाता है, और एक webhook भेजता है ताकि आप access provision कर सकें। ग्राहक द्वारा उपयोग किया गया payment method renewals या subscription changes के लिए file पर सुरक्षित रखा जाता है।Webhook notification के साथ बनाई गई subscription

Quick Start

SDK install करें, इसे inline mode के लिए initialize करें और एक container element में checkout खोलें:
सुनिश्चित करें कि आपके पेज पर संबंधित id वाला container element मौजूद है: <div id="dodo-inline-checkout"></div>.

Step-by-Step Integration

1

Install the SDK

npm, yarn या pnpm के माध्यम से install करें:
2

Initialize the SDK for Inline Display

SDK initialize करें और displayType: 'inline' निर्दिष्ट करें। Real-time tax और total calculations के साथ अपना UI अपडेट करने के लिए checkout.breakdown event को listen करें:
3

Initialize the SDK for Inline Display

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

Create a Container Element

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

Open the Checkout

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

Test Your Integration

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

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 के लिए त्वरित सेटअप

inline (embedded) checkout के लिए ही डोमेन सत्यापन आवश्यक है। hosted checkout के लिए इसकी आवश्यकता नहीं है।
overlay checkout के लिए Apple Pay उपलब्ध नहीं है।
Apple Pay को dashboard से प्रत्येक डोमेन के लिए सत्यापित किया जाता है।
1

Open Wallet domains

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

Open Wallet domains from the Apple Pay row

2

Download the domain association file

Wallet domains पैनल से association file डाउनलोड करें।
Download file बटन वाला Wallet domains पैनल

Download the Apple Pay domain association file

3

Register your domain

Register domain पर क्लिक करें और वह डोमेन दर्ज करें जहाँ आप inline checkout एम्बेड करते हैं (उदाहरण के लिए shop.example.com), फिर Continue पर क्लिक करें।
दर्ज किए गए डोमेन वाला Register a domain फ़ॉर्म

Register the domain where you embed inline checkout

4

Host the file on your domain

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

Verify the domain

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

Verify the hosted association file

6

Confirm it's active

जब status Active दिखाए, तो उस डोमेन के लिए Apple Pay सक्षम हो जाता है। प्रत्येक डोमेन के लिए इसे चालू या बंद करने हेतु Enabled toggle का उपयोग करें।
Active Apple Pay status और Enabled toggles वाले डोमेन दिखाने वाली Wallet domains सूची

Verified domains show an Active status

7

Test the integration

  1. Apple device पर checkout खोलें
  2. सत्यापित करें कि Apple Pay बटन दिखाई दे रहा है
  3. एक test transaction पूरा करें

Browser Support

Dodo Payments Checkout SDK निम्नलिखित browsers को support करता है:
  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)
  • IE11+

Inline vs Overlay Checkout

अपने use case के लिए सही checkout प्रकार चुनें:
जब आप checkout अनुभव पर अधिकतम नियंत्रण और सहज branding चाहते हैं, तब inline checkout का उपयोग करें। अपने मौजूदा पेजों में न्यूनतम बदलावों के साथ तेज़ integration के लिए overlay checkout का उपयोग करें।

Overlay Checkout

त्वरित modal-based integration के लिए overlay checkout का उपयोग करें।

Checkout Sessions API

अपने checkout अनुभवों को सक्षम करने के लिए checkout sessions बनाएँ।

Webhooks

webhooks के साथ server-side payment events संभालें।

Integration Guide

Dodo Payments को integrate करने की पूरी guide।
अधिक सहायता के लिए हमारे Discord community पर जाएँ या हमारी developer support team से संपर्क करें।

Overlay Checkout

Use the overlay checkout for quick modal-based integration.

Checkout Sessions API

Create checkout sessions to power your checkout experiences.

Webhooks

Handle payment events server-side with webhooks.

Integration Guide

Complete guide to integrating Dodo Payments.
For more help, visit our Discord community or contact our developer support team.
अंतिम संशोधन 26 सितंबर 2026