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

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

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

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

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

त्वरित प्रारंभ
कुछ कोड की पंक्तियों में Dodo Payments इनलाइन चेकआउट के साथ शुरू करें:चरण-दर-चरण एकीकरण गाइड
1
SDK स्थापित करें
Dodo Payments चेकआउट SDK स्थापित करें:
2
इनलाइन डिस्प्ले के लिए SDK प्रारंभ करें
SDK को प्रारंभ करें और
displayType: 'inline' निर्दिष्ट करें। आपको अपने UI को वास्तविक समय में कर और कुल गणनाओं के साथ अपडेट करने के लिए checkout.breakdown इवेंट के लिए भी सुनना चाहिए।3
एक कंटेनर तत्व बनाएं
अपने HTML में एक तत्व जोड़ें जहाँ चेकआउट फ्रेम इंजेक्ट किया जाएगा:
4
चेकआउट खोलें
DodoPayments.Checkout.open() को checkoutUrl और आपके कंटेनर के elementId के साथ कॉल करें:5
अपने एकीकरण का परीक्षण करें
- अपने विकास सर्वर को प्रारंभ करें:
- चेकआउट प्रवाह का परीक्षण करें:
- इनलाइन फ्रेम में अपना ईमेल और पता विवरण दर्ज करें।
- सत्यापित करें कि आपका कस्टम ऑर्डर सारांश वास्तविक समय में अपडेट होता है।
- परीक्षण क्रेडेंशियल्स का उपयोग करके भुगतान प्रवाह का परीक्षण करें।
- पुष्टि करें कि रीडायरेक्ट सही ढंग से काम करते हैं।
यदि आपने
onEvent कॉलबैक में कंसोल लॉग जोड़ा है, तो आपको अपने ब्राउज़र कंसोल में checkout.breakdown इवेंट्स लॉग होते हुए दिखाई देंगे।6
लाइव जाएं
जब आप उत्पादन के लिए तैयार हों:
- मोड को
'live'में बदलें:
- अपने चेकआउट URLs को अपने बैकएंड से लाइव चेकआउट सत्रों का उपयोग करने के लिए अपडेट करें।
- उत्पादन में पूरे प्रवाह का परीक्षण करें।
पूर्ण React उदाहरण
यह उदाहरण दिखाता है कि कैसे इनलाइन चेकआउट के साथ एक कस्टम ऑर्डर सारांश को लागू किया जाए, उन्हेंcheckout.breakdown इवेंट का उपयोग करके समन्वयित रखा जाए।
API संदर्भ
कॉन्फ़िगरेशन
प्रारंभिक विकल्प
| विकल्प | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
mode | "test" | "live" | हाँ | पर्यावरण मोड। |
displayType | "inline" | "overlay" | हाँ | चेकआउट को एम्बेड करने के लिए "inline" पर सेट किया जाना चाहिए। |
onEvent | function | हाँ | चेकआउट इवेंट्स को संभालने के लिए कॉलबैक फ़ंक्शन। |
चेकआउट विकल्प
| विकल्प | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
checkoutUrl | string | हाँ | चेकआउट सत्र URL। |
elementId | string | हाँ | चेकआउट को रेंडर करने के लिए DOM तत्व का id। |
विधियाँ
चेकआउट खोलें
निर्दिष्ट कंटेनर में चेकआउट फ्रेम खोलता है।चेकआउट बंद करें
प्रोग्रामेटिक रूप से चेकआउट फ्रेम को हटा देता है और इवेंट लिसनर्स को साफ करता है।स्थिति जांचें
यह लौटाता है कि चेकआउट फ्रेम वर्तमान में इंजेक्ट किया गया है या नहीं।इवेंट्स
SDK वास्तविक समय में इवेंट्स प्रदान करता हैonEvent कॉलबैक के माध्यम से। इनलाइन चेकआउट के लिए, checkout.breakdown विशेष रूप से आपके UI को समन्वयित करने के लिए उपयोगी है।
| इवेंट प्रकार | विवरण |
|---|---|
checkout.opened | चेकआउट फ्रेम लोड हो गया है। |
checkout.breakdown | जब कीमतें, कर या छूट अपडेट होती हैं, तब फायर किया जाता है। |
checkout.customer_details_submitted | ग्राहक विवरण प्रस्तुत किए गए हैं। |
checkout.redirect | चेकआउट एक रीडायरेक्ट करेगा (जैसे, एक बैंक पृष्ठ पर)। |
checkout.error | चेकआउट के दौरान एक त्रुटि हुई। |
चेकआउट ब्रेकडाउन डेटा
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 का उपयोग कर सकते हैं:TypeScript समर्थन
SDK TypeScript में लिखा गया है और इसमें व्यापक प्रकार की परिभाषाएँ शामिल हैं।त्रुटि हैंडलिंग
SDK इवेंट सिस्टम के माध्यम से विस्तृत त्रुटि जानकारी प्रदान करता है। हमेशा अपनेonEvent कॉलबैक में उचित त्रुटि हैंडलिंग लागू करें:
सर्वोत्तम प्रथाएँ
- उत्तरदायी डिज़ाइन: सुनिश्चित करें कि आपके कंटेनर तत्व के पास पर्याप्त चौड़ाई और ऊँचाई है। iframe आमतौर पर अपने कंटेनर को भरने के लिए विस्तारित होगा।
- समन्वय: अपने कस्टम ऑर्डर सारांश या मूल्य तालिकाओं को चेकआउट फ्रेम में उपयोगकर्ता जो देखता है, के साथ समन्वयित रखने के लिए
checkout.breakdownइवेंट का उपयोग करें। - स्केलेटन राज्य:
checkout.openedइवेंट फायर होने तक अपने कंटेनर में लोडिंग संकेतक दिखाएँ। - साफ़ करना: जब आपका घटक अनमाउंट होता है, तो iframe और इवेंट लिसनर्स को साफ़ करने के लिए
DodoPayments.Checkout.close()को कॉल करें।
समस्या निवारण
चेकआउट फ्रेम दिखाई नहीं दे रहा है
चेकआउट फ्रेम दिखाई नहीं दे रहा है
- सुनिश्चित करें कि
elementIdएक ऐसेidसे मेल खाता है जो वास्तव में DOM में मौजूद है। - सुनिश्चित करें कि
displayType: 'inline'कोInitializeमें पास किया गया था। - जांचें कि
checkoutUrlमान्य है।
मेरे UI में कर अपडेट नहीं हो रहे हैं
मेरे UI में कर अपडेट नहीं हो रहे हैं
- सुनिश्चित करें कि आप
checkout.breakdownइवेंट के लिए सुन रहे हैं। - कर केवल तब गणना किए जाते हैं जब उपयोगकर्ता चेकआउट फ्रेम में एक मान्य देश और पोस्टल कोड दर्ज करता है।
ब्राउज़र समर्थन
Dodo Payments चेकआउट SDK निम्नलिखित ब्राउज़रों का समर्थन करता है:- क्रोम (नवीनतम)
- फ़ायरफ़ॉक्स (नवीनतम)
- सफारी (नवीनतम)
- एज (नवीनतम)
- IE11+
Apple Pay वर्तमान में इनलाइन चेकआउट अनुभव में समर्थित नहीं है। हम भविष्य के रिलीज़ में Apple Pay के लिए समर्थन जोड़ने की योजना बना रहे हैं।
इनलाइन बनाम ओवरले चेकआउट
अपने उपयोग मामले के लिए सही चेकआउट प्रकार चुनें:| विशेषता | इनलाइन चेकआउट | ओवरले चेकआउट |
|---|---|---|
| एकीकरण गहराई | पृष्ठ में पूरी तरह से एम्बेडेड | पृष्ठ के शीर्ष पर मोडल |
| लेआउट नियंत्रण | पूर्ण नियंत्रण | सीमित |
| ब्रांडिंग | निर्बाध | पृष्ठ से अलग |
| कार्यान्वयन प्रयास | उच्च | कम |
| सबसे अच्छा | कस्टम चेकआउट पृष्ठ, उच्च-परिवर्तन प्रवाह | त्वरित एकीकरण, मौजूदा पृष्ठ |
संबंधित संसाधन
ओवरले चेकआउट
त्वरित मोडल-आधारित एकीकरण के लिए ओवरले चेकआउट का उपयोग करें।
चेकआउट सत्र API
अपने चेकआउट अनुभवों को शक्ति देने के लिए चेकआउट सत्र बनाएं।
Webhook
वेबहुक के साथ सर्वर-साइड पर भुगतान घटनाओं को संभालें।
एकीकरण गाइड
Dodo Payments को एकीकृत करने के लिए पूर्ण गाइड।