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

यह कैसे काम करता है
इनलाइन चेकआउट आपकी वेबसाइट या ऐप में एक सुरक्षित डोडो पेमेंट्स फ्रेम को एम्बेड करके काम करता है। चेकआउट फ्रेम ग्राहक जानकारी एकत्र करने और भुगतान विवरण कैप्चर करने का काम करता है। आपकी पृष्ठ पर आइटम सूची, कुल और चेकआउट पर जो कुछ है उसे बदलने के विकल्प प्रदर्शित होते हैं। SDK आपकी पृष्ठ और चेकआउट फ्रेम के बीच बातचीत करने की अनुमति देता है। डोडो पेमेंट्स स्वचालित रूप से एक चेकआउट पूरा होने पर एक सदस्यता बनाता है, जिसे आप प्रावधान करने के लिए तैयार कर सकते हैं।इनलाइन चेकआउट फ्रेम सभी संवेदनशील भुगतान जानकारी को सुरक्षित रूप से संभालता है, आपके पक्ष पर अतिरिक्त प्रमाणपत्र के बिना PCI अनुपालन सुनिश्चित करता है।
एक अच्छा इनलाइन चेकआउट क्या बनाता है?
यह महत्वपूर्ण है कि ग्राहकों को पता हो कि वे किससे खरीद रहे हैं, वे क्या खरीद रहे हैं, और वे कितना भुगतान कर रहे हैं। एक इनलाइन चेकआउट बनाने के लिए जो अनुपालन में हो और रूपांतरण के लिए अनुकूलित हो, आपकी कार्यान्वयन में शामिल होना चाहिए:
- दोहराने की जानकारी: यदि यह दोहराने वाला है, तो यह कितनी बार दोहराता है और नवीनीकरण पर कुल कितना भुगतान करना है। यदि यह एक परीक्षण है, तो परीक्षण कितने समय तक चलता है।
- आइटम विवरण: जो खरीदा जा रहा है उसका विवरण।
- लेनदेन कुल: लेनदेन कुल, जिसमें उप-योग, कुल कर, और समग्र कुल शामिल हैं। सुनिश्चित करें कि मुद्रा भी शामिल है।
- डोडो पेमेंट्स फ़ुटर: पूरा इनलाइन चेकआउट फ्रेम, जिसमें चेकआउट फ़ुटर शामिल है जिसमें डोडो पेमेंट्स, हमारी बिक्री की शर्तें, और हमारी गोपनीयता नीति के बारे में जानकारी है।
- रिफंड नीति: आपकी रिफंड नीति का एक लिंक, यदि यह डोडो पेमेंट्स की मानक रिफंड नीति से भिन्न है।
ग्राहक यात्रा
चेकआउट प्रवाह आपकी चेकआउट सत्र कॉन्फ़िगरेशन द्वारा निर्धारित होता है। जिस तरह से आप चेकआउट सत्र को कॉन्फ़िगर करते हैं, उसके आधार पर, ग्राहक एक चेकआउट का अनुभव करेंगे जो एक ही पृष्ठ पर सभी जानकारी प्रस्तुत कर सकता है या कई चरणों में।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 इनलाइन चेकआउट के साथ शुरू करें:चरण-दर-चरण एकीकरण गाइड
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
- अपने विकास सर्वर को प्रारंभ करें:
- चेकआउट प्रवाह का परीक्षण करें:
- इनलाइन फ्रेम में अपना ईमेल और पता विवरण दर्ज करें।
- सत्यापित करें कि आपका कस्टम ऑर्डर सारांश वास्तविक समय में अपडेट होता है।
- परीक्षण क्रेडेंशियल्स का उपयोग करके भुगतान प्रवाह का परीक्षण करें।
- पुष्टि करें कि रीडायरेक्ट सही ढंग से काम करते हैं।
यदि आपने
onEvent कॉलबैक में एक कंसोल लॉग जोड़ा है, तो आपको ब्राउज़र कंसोल में checkout.breakdown इवेंट्स लॉग होते हुए दिखने चाहिए।6
Go Live
जब आप उत्पादन के लिए तैयार हों:
- मोड को
'live'में बदलें:
- अपने चेकआउट URLs को अपने बैकएंड से लाइव चेकआउट सत्रों का उपयोग करने के लिए अपडेट करें।
- उत्पादन में पूरे प्रवाह का परीक्षण करें।
पूर्ण React उदाहरण
यह उदाहरण दिखाता है कि कैसे इनलाइन चेकआउट के साथ एक कस्टम ऑर्डर सारांश को लागू किया जाए,checkout.breakdown इवेंट का उपयोग करके उन्हें सिंक में रखा जाए।
API संदर्भ
कॉन्फ़िगरेशन
प्रारंभिक विकल्प
चेकआउट विकल्प
विधियाँ
चेकआउट खोलें
निर्दिष्ट कंटेनर में चेकआउट फ्रेम खोलता है।चेकआउट बंद करें
प्रोग्रामेटिक रूप से चेकआउट फ्रेम को हटा देता है और इवेंट लिसेनर्स को साफ करता है।स्थिति जांचें
विवरण देता है कि चेकआउट फ्रेम वर्तमान में इंजेक्टेड है या नहीं।इवेंट्स
SDK वास्तविक समय की घटनाएं प्रदान करता हैonEvent कॉलबैक के माध्यम से। इनलाइन चेकआउट के लिए, checkout.breakdown विशेष रूप से आपके UI को सिंक करने के लिए उपयोगी है।
चेकआउट ब्रेकडाउन डेटा
checkout.breakdown घटना निम्न डेटा प्रदान करती है:
ब्रेकडाउन इवेंट को समझना
checkout.breakdown घटना आपके एप्लिकेशन के UI को Dodo Payments चेकआउट स्थिति के साथ सिंक में रखने का प्राथमिक तरीका है।
यह कब फायर करता है:
- आरंभ करने पर: ठीक बाद में जब चेकआउट फ्रेम लोड हो जाता है और तैयार होता है।
- पता बदलने पर: जब भी ग्राहक किसी देश का चयन करता है या एक पोस्टल कोड दर्ज करता है जिससे टैक्स पुनर्गणना होती है।
प्रमुख एकीकरण युक्तियाँ:
- मुद्रा स्वरूपण: मूल्य हमेशा सबसे छोटी मुद्रा इकाई (जैसे, 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 के लिए त्वरित सेटअप
डोमेन सत्यापन केवल इनलाइन (एम्बेडेड) चेकआउट के लिए आवश्यक है। ओवरले चेकआउट, होस्टेड चेकआउट और भुगतान लिंक को इसकी आवश्यकता नहीं होती है।
1
Open Wallet domains
Settings → 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 को सबमिट करता है।

6
Confirm it's active
जब स्थिति Active दिखाती है, तो उस डोमेन के लिए Apple Pay सक्षम होता है। प्रति डोमेन इसे चालू या बंद करने के लिए Enabled टॉगल का उपयोग करें।

7
Test the integration
- Apple डिवाइस पर चेकआउट खोलें
- सुनिश्चित करें कि Apple Pay बटन दिखाई दे
- एक परीक्षण लेन-देन पूरा करें
ब्राउज़र समर्थन
Dodo Payments Checkout SDK निम्नलिखित ब्राउज़र का समर्थन करता है:- Chrome (latest)
- Firefox (latest)
- Safari (latest)
- Edge (latest)
- IE11+
इनलाइन बनाम ओवरले चेकआउट
अपने उपयोग के मामले के लिए सही चेकआउट प्रकार चुनें:संबंधित संसाधन
Overlay Checkout
त्वरित मोडल-आधारित एकीकरण के लिए ओवरले चेकआउट का उपयोग करें।
Checkout Sessions API
अपने चेकआउट अनुभवों को सशक्त बनाने के लिए चेकआउट सत्र बनाएं।
Webhooks
वेबहुक के साथ सर्वर-साइड भुगतान इवेंट को संभालें।
Integration Guide
Dodo Payments को एकीकृत करने के लिए पूर्ण मार्गदर्शिका।