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

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

Customer enters their details
इनलाइन चेकआउट पहले ग्राहकों से उनके ईमेल पते, उनके देश का चयन करने, और (जहां आवश्यक हो) उनके ZIP या पोस्टल कोड दर्ज करने के लिए कहता है। यह चरण सभी आवश्यक जानकारी एकत्र करता है ताकि कर और उपलब्ध भुगतान विकल्पों का निर्धारण किया जा सके।आप ग्राहक विवरण को पूर्व-भर सकते हैं और अनुभव को सरल बनाने के लिए सहेजे गए पते प्रस्तुत कर सकते हैं।
Customer selects payment method
अपने विवरण दर्ज करने के बाद, ग्राहकों को उपलब्ध भुगतान विधियों और भुगतान फॉर्म के साथ प्रस्तुत किया जाता है। विकल्पों में क्रेडिट या डेबिट कार्ड, PayPal, Apple Pay, Google Pay, और उनके स्थान के आधार पर अन्य स्थानीय भुगतान विधियाँ शामिल हो सकती हैं।यदि उपलब्ध हो तो चेकआउट को तेज़ करने के लिए सहेजे गए भुगतान विधियों को प्रदर्शित करें।

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

त्वरित प्रारंभ
कुछ कोड की पंक्तियों में Dodo Payments इनलाइन चेकआउट के साथ शुरू करें:चरण-दर-चरण एकीकरण गाइड
Initialize the SDK for Inline Display
SDK को इनिशियलाइज़ करें और
displayType: 'inline' निर्दिष्ट करें। आपको checkout.breakdown इवेंट को भी सुनना चाहिए ताकि आप अपने UI को वास्तविक समय के कर और कुल गणनाओं के साथ अपडेट कर सकें।Open the Checkout
अपने कंटेनर के
checkoutUrl और elementId के साथ DodoPayments.Checkout.open() कॉल करें:Test Your Integration
- अपने विकास सर्वर को प्रारंभ करें:
- चेकआउट प्रवाह का परीक्षण करें:
- इनलाइन फ्रेम में अपना ईमेल और पता विवरण दर्ज करें।
- सत्यापित करें कि आपका कस्टम ऑर्डर सारांश वास्तविक समय में अपडेट होता है।
- परीक्षण क्रेडेंशियल्स का उपयोग करके भुगतान प्रवाह का परीक्षण करें।
- पुष्टि करें कि रीडायरेक्ट सही ढंग से काम करते हैं।
यदि आपने
onEvent कॉलबैक में एक कंसोल लॉग जोड़ा है, तो आपको ब्राउज़र कंसोल में checkout.breakdown इवेंट्स लॉग होते हुए दिखने चाहिए।पूर्ण React उदाहरण
यह उदाहरण दिखाता है कि कैसे इनलाइन चेकआउट के साथ एक कस्टम ऑर्डर सारांश को लागू किया जाए,checkout.breakdown इवेंट का उपयोग करके उन्हें सिंक में रखा जाए।
API संदर्भ
कॉन्फ़िगरेशन
प्रारंभिक विकल्प
| विकल्प | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
mode | "test" | "live" | Yes | Environment mode. |
displayType | "inline" | "overlay" | Yes | Must be set to "inline" to embed the checkout. |
onEvent | function | Yes | Callback function for handling checkout events. |
चेकआउट विकल्प
| विकल्प | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
checkoutUrl | string | हाँ | चेकआउट सत्र URL। |
elementId | string | हाँ | वह id जहां चेकआउट रेंडर होना चाहिए। |
options.showTimer | boolean | नहीं | चेकआउट टाइमर दिखाएं या छिपाएं। डिफॉल्ट्स से true। जब अक्षम किया जाता है, तो आपको सत्र समाप्त होने पर checkout.link_expired घटना प्राप्त होगी। |
options.showSecurityBadge | boolean | नहीं | सुरक्षा बैज दिखाएं या छिपाएं। डिफॉल्ट्स से true। |
options.payButtonText | string | नहीं | पे बटन पर प्रदर्शित करने के लिए कस्टम टेक्स्ट। |
options.fontSize | FontSize | नहीं | चेकआउट के लिए वैश्विक फॉन्ट साइज। |
options.fontWeight | FontWeight | नहीं | चेकआउट के लिए वैश्विक फॉन्ट वेट। |
विधियाँ
चेकआउट खोलें
निर्दिष्ट कंटेनर में चेकआउट फ्रेम खोलता है।चेकआउट बंद करें
प्रोग्रामेटिक रूप से चेकआउट फ्रेम को हटा देता है और इवेंट लिसेनर्स को साफ करता है।स्थिति जांचें
विवरण देता है कि चेकआउट फ्रेम वर्तमान में इंजेक्टेड है या नहीं।इवेंट्स
SDK वास्तविक समय की घटनाएं प्रदान करता हैonEvent कॉलबैक के माध्यम से। इनलाइन चेकआउट के लिए, checkout.breakdown विशेष रूप से आपके UI को सिंक करने के लिए उपयोगी है।
| इवेंट प्रकार | विवरण |
|---|---|
checkout.opened | चेकआउट फ्रेम लोड हो गया है। |
checkout.form_ready | चेकआउट फॉर्म उपयोगकर्ता द्वारा इनपुट प्राप्त करने के लिए तैयार है। लोडिंग राज्यों को छिपाने और चेकआउट UI दिखाने के लिए उपयोगी है। |
checkout.breakdown | जब कीमतें, कर, या छूट अपडेट की जाती है, फ़ायर किया जाता है। |
checkout.customer_details_submitted | ग्राहक विवरण सबमिट कर दिए गए हैं। |
checkout.pay_button_clicked | जब ग्राहक पे बटन पर क्लिक करता है तो फ़ायर किया जाता है। एनालिटिक्स और रूपांतरण फ़नल ट्रैक करने के लिए उपयोगी। |
checkout.redirect | चेकआउट एक रीडायरेक्ट करेगा (जैसे, एक बैंक पृष्ठ पर)। |
checkout.error | चेकआउट के दौरान कोई त्रुटि हुई। |
checkout.link_expired | जब चेकआउट सत्र समाप्त होता है तो फ़ायर किया जाता है। केवल तभी प्राप्त होता है जब showTimer को false पर सेट किया गया हो। |
चेकआउट ब्रेकडाउन डेटा
checkout.breakdown घटना निम्न डेटा प्रदान करती है:
ब्रेकडाउन इवेंट को समझना
checkout.breakdown घटना आपके एप्लिकेशन के UI को Dodo Payments चेकआउट स्थिति के साथ सिंक में रखने का प्राथमिक तरीका है।
यह कब फायर करता है:
- आरंभ करने पर: ठीक बाद में जब चेकआउट फ्रेम लोड हो जाता है और तैयार होता है।
- पता बदलने पर: जब भी ग्राहक किसी देश का चयन करता है या एक पोस्टल कोड दर्ज करता है जिससे टैक्स पुनर्गणना होती है।
| फील्ड | विवरण |
|---|---|
subTotal | सत्र में सभी लाइन आइटम्स का योग, किसी भी डिस्काउंट या टैक्स को लागू करने से पहले। |
discount | सभी लागू डिस्काउंट्स का कुल मूल्य। |
tax | गणना की गई कर राशि। inline मोड में, यह उपयोगकर्ता द्वारा पता फ़ील्ड के साथ इंटरैक्ट करने के दौरान डायनामिक रूप से अपडेट होती है। |
total | सत्र की आधार मुद्रा में subTotal - discount + tax का गणितीय परिणाम। |
currency | मानक सबटोटल, डिस्काउंट, और टैक्स मूल्यों के लिए ISO मुद्रा कोड (जैसे, "USD")। |
finalTotal | ग्राहक से वास्तविक चार्ज की गई राशि। इसमें अतिरिक्त विदेशी मुद्रा समायोजन या स्थानीय भुगतान विधि शुल्क शामिल हो सकते हैं जो मूल मूल्य ब्रेकडाउन का हिस्सा नहीं हैं। |
finalTotalCurrency | वह मुद्रा जिसमें ग्राहक वास्तव में भुगतान कर रहा है। यह currency से भिन्न हो सकता है यदि क्रय शक्ति समानता या स्थानीय मुद्रा रूपांतरण सक्रिय है। |
- मुद्रा स्वरूपण: मूल्य हमेशा सबसे छोटी मुद्रा इकाई (जैसे, USD के लिए सेंट्स, JPY के लिए येन) में पूर्णांकों के रूप में लौटाए जाते हैं। उन्हें दिखाने के लिए, 100 से विभाजित करें (या उपयुक्त 10 की शक्ति) या एक स्वरूपण लाइब्रेरी का उपयोग करें जैसे
Intl.NumberFormat। - प्रारंभिक राज्यों को संभालना: जब चेकआउट पहली बार लोड होता है,
taxऔरdiscount0याnullहो सकते हैं जब तक कि उपयोगकर्ता अपने बिलिंग जानकारी प्रदान नहीं करता या एक कोड लागू नहीं करता। आपका UI इन राज्यों को अनुग्रहपूर्वक संभालना चाहिए (जैसे, एक डैश—दिखाना या रो को छिपाना)। - “फाइनल टोटल” बनाम “टोटल”: जबकि
totalआपको मानक मूल्य की गणना देता है,finalTotalलेनदेन के लिए सत्य का स्रोत है। यदिfinalTotalमौजूद है, तो यह ग्राहक के कार्ड पर सही रूप से चार्ज किया जाएगा, जिसमें कोई डायनामिक समायोजन शामिल हो। - वास्तविक समय प्रतिक्रिया: टैक्सेस को वास्तविक समय में उपयोगकर्ताओं को दिखाने के लिए
taxफ़ील्ड का उपयोग करें। इससे आपके चेकआउट पेज को “लाइव” फील मिलता है और पते के प्रवेश चरण के दौरान घर्षण कम होता है।
कार्यान्वयन विकल्प
पैकेज प्रबंधक स्थापना
स्टेप-बाय-स्टेप इंटीग्रेशन गाइड में दिखाए गए अनुसार npm, yarn, या pnpm के माध्यम से इंस्टॉल करें।CDN कार्यान्वयन
बिल्ड स्टेप के बिना त्वरित एकीकरण के लिए, आप हमारे CDN का उपयोग कर सकते हैं:भुगतान विधि अपडेट करें
इनलाइन चेकआउट सदस्यताओं के लिए भुगतान विधि अपडेट का समर्थन करता है। जब किसी ग्राहक को उनकी भुगतान विधि अपडेट करने की ज़रूरत होती है - चाहे किसी सक्रिय सदस्यता के लिए हो या किसी स्थगित सदस्यता को पुन: सक्रिय करने के लिए - आप अपनी पेज लेआउट के भीतर सीधे अपडेट प्रवाह प्रस्तुत कर सकते हैं।यह कैसे काम करता है
- भुगतान विधि अपडेट API को कॉल करें ताकि आपको एक
payment_linkमिल सके:
- पारित किए गए
payment_linkकोcheckoutUrlके रूप में इनलाइन चेकआउट खोलने के लिए:
होल्ड पर सदस्यताओं के लिए
जबon_hold स्थिति में सदस्यता के लिए भुगतान विधि को अपडेट किया जाता है, Dodo Payments किसी भी बकाया शुल्क के लिए स्वतः चार्ज बनाता है। पुन: सक्रियता की पुष्टि के लिए payment.succeeded और subscription.active वेबहुक मॉनिटर करें।
त्रुटि प्रबंधन
SDK इवेंट सिस्टम के माध्यम से विस्तृत त्रुटि जानकारी प्रदान करता है। हमेशा अपनेonEvent कॉलबैक में उचित त्रुटि प्रबंधन को लागू करें:
सर्वोत्तम प्रथाएँ
- उत्तरदायी डिज़ाइन: सुनिश्चित करें कि आपकी कंटेनर तत्व में पर्याप्त चौड़ाई और ऊंचाई है। आईफ्रेम आमतौर पर इसके कंटेनर को भरने के लिए विस्तार करेगा।
- सिंक्रनाइज़ेशन: अपने कस्टम ऑर्डर सारांश या मूल्य निर्धारण टेबल को चेकआउट फ्रेम में दिखाए गए ग्राहक की दृष्टि से सिंक में रखने के लिए
checkout.breakdownइवेंट का उपयोग करें। - स्केलेटन स्टेट्स: जब तक
checkout.openedइवेंट फायर ना हो, तब तक अपने कंटेनर में एक लोडिंग इंडिकेटर दिखाएं। - सफाई: जब आपका घटक अनमाउंट हो तो आईफ्रेम और इवेंट लिसनर्स की सफाई के लिए
DodoPayments.Checkout.close()को कॉल करें।
डार्क मोड कार्यान्वयन के लिए, इनलाइन चेकआउट फ्रेम के साथ अधिकतम दृश्य इंटीग्रेशन के लिए
#0d0d0d को पृष्ठभूमि के रंग के रूप में उपयोग करने की अनुशंसा की जाती है।भुगतान स्थिति सत्यापन
क्यों सर्वर-साइड सत्यापन आवश्यक है
हालांकि इनलाइन चेकआउट इवेंट्स वास्तविक समय प्रतिक्रिया प्रदान करते हैं, वे आपके भुगतान स्टेटस का एकमात्र सत्य का स्रोत नहीं होना चाहिए। नेटवर्क समस्याएँ, ब्राउज़र क्रैश, या उपयोगकर्ताओं द्वारा पेज बंद करने से घटनाएँ छूट सकती हैं। विश्वसनीय भुगतान सत्यापन सुनिश्चित करने के लिए:- आपका सर्वर वेबहुक इवेंट्स सुने - Dodo Payments भुगतान स्थिति परिवर्तनों के लिए वेबहुक भेजता है
- एक पोलिंग तंत्र लागू करें - आपकी फ्रंटेंड को आपके सर्वर से स्थिति अपडेट्स के लिए पोल करें
- दोनों दृष्टिकोणों का संयोजन करें - वेबहुक को प्राथमिक स्रोत के रूप में उपयोग करें और पोलिंग को बैकअप के रूप में
सिफारिश की गई संरचना
कार्यान्वयन चरण
1. चेकआउट इवेंट्स सुनें - जब उपयोगकर्ता पे पर क्लिक करता है, तो स्थिति की सत्यता की तैयारी शुरू करें:payment.succeeded या payment.failed वेबहुक्स भेजता है, तो अपने डेटाबेस को अपडेट करें। विवरण के लिए हमारे वेबहुक्स दस्तावेज़ीकरण देखें।
समस्या निवारण
Checkout frame is not appearing
Checkout frame is not appearing
- सत्यापित करें कि
elementIdयथार्थ में DOM में मौजूदidसे मेल खाता है। - सुनिश्चित करें कि
displayType: 'inline'कोInitializeको पास किया गया था। - यह जांचें कि
checkoutUrlवैध है।
Taxes are not updating in my UI
Taxes are not updating in my UI
- सुनिश्चित करें कि आप
checkout.breakdownइवेंट सुन रहे हैं। - टैक्स केवल तभी गणना किए जाते हैं जब उपयोगकर्ता चेकआउट फ्रेम में एक वैध देश और पोस्टल कोड दर्ज करता है।
डिजिटल वॉलेट्स सक्षम करें
Apple Pay, Google Pay, और अन्य डिजिटल वॉलेट्स सेट अप करने के लिए विस्तृत जानकारी के लिए डिजिटल वॉलेट्स पृष्ठ देखें।Apple Pay के लिए त्वरित सेटअप
Download domain association file
Apple Pay डोमेन सहयोगी फ़ाइल डाउनलोड करें।
Request activation
अपना उत्पादन डोमेन URL के साथ support@dodopayments.com को ईमेल करें और Apple Pay सक्रियता का अनुरोध करें।
ब्राउज़र समर्थन
Dodo Payments Checkout SDK निम्नलिखित ब्राउज़रों का समर्थन करता है:- Chrome (नवीनतम)
- Firefox (नवीनतम)
- Safari (नवीनतम)
- Edge (नवीनतम)
- IE11+
इनलाइन बनाम ओवरले चेकआउट
अपने उपयोग के मामले के लिए सही चेकआउट प्रकार चुनें:| सुविधा | इनलाइन चेकआउट | ओवरले चेकआउट |
|---|---|---|
| एकीकरण की गहराई | पृष्ठ में पूर्ण रूप से अंतर्निहित | पृष्ठ के ऊपर पर मोडल |
| लेआउट नियंत्रण | पूरा नियंत्रण | सीमित |
| ब्रांडिंग | निर्बाध | पृष्ठ से अलग |
| कार्यान्वयन प्रयास | उच्चतर | निम्नतर |
| सर्वोत्तम के लिए | कस्टम चेकआउट पृष्ठ, उच्च-कन्वर्जन प्रवाह | त्वरित एकीकरण, मौजूदा पृष्ठ |
संबंधित संसाधन
Overlay Checkout
त्वरित मोडल-आधारित एकीकरण के लिए ओवरले चेकआउट का उपयोग करें।
Checkout Sessions API
अपने चेकआउट अनुभव संचालित करने के लिए चेकआउट सत्र बनाएं।
Webhooks
वेबहुक्स के साथ सर्वर-साइड पर भुगतान इवेंट्स को प्रबंधित करें।
Integration Guide
Dodo Payments को एकीकृत करने के लिए पूरी गाइड।
