Dodo Payments चेकआउट SDK आपके वेब एप्लिकेशन में हमारे भुगतान ओवरले को एकीकृत करने का एक सहज तरीका प्रदान करता है। TypeScript और आधुनिक वेब मानकों के साथ निर्मित, यह रीयल-टाइम इवेंट हैंडलिंग और अनुकूलन योग्य थीम के साथ भुगतान को संभालने के लिए एक मजबूत समाधान प्रदान करता है।
अपने पसंदीदा पैकेज प्रबंधक का उपयोग करके Dodo Payments चेकआउट SDK स्थापित करें:
कॉपी करें
npm install dodopayments-checkout
2
SDK प्रारंभ करें
अपने एप्लिकेशन में SDK को प्रारंभ करें, आमतौर पर आपके मुख्य घटक या ऐप के प्रवेश बिंदु में:
कॉपी करें
import { DodoPayments } from "dodopayments-checkout";DodoPayments.Initialize({ mode: "test", // Change to 'live' for production displayType: "overlay", // Optional: defaults to 'overlay' for overlay checkout onEvent: (event) => { console.log("Checkout event:", event); // Handle different events switch (event.event_type) { case "checkout.opened": // Checkout overlay has been opened break; case "checkout.closed": // Checkout has been closed break; case "checkout.error": // Handle errors console.error("Checkout error:", event.data?.message); break; } },});
चेकआउट खोलने का प्रयास करने से पहले हमेशा SDK को प्रारंभ करें। प्रारंभिककरण आपके एप्लिकेशन के लोड होने पर एक बार होना चाहिए।
चेकआउट टाइमर को दिखाना या छिपाना। डिफ़ॉल्ट true है। जब अक्षम किया जाता है, तो आपको सत्र समाप्त होने पर checkout.link_expired घटना प्राप्त होगी।
options.showSecurityBadge
boolean
नहीं
सुरक्षा बैज को दिखाना या छिपाना। डिफ़ॉल्ट true है।
options.manualRedirect
boolean
नहीं
जब सक्षम किया जाता है, तो चेकआउट पूरा होने के बाद स्वचालित रूप से पुनर्निर्देशित नहीं होगा। इसके बजाय, आपको checkout.status और checkout.redirect_requested घटनाएँ प्राप्त होंगी ताकि आप पुनर्निर्देशन को स्वयं संभाल सकें।
DodoPayments.Initialize({ onEvent: (event: CheckoutEvent) => { switch (event.event_type) { case "checkout.opened": // Checkout overlay has been opened break; case "checkout.payment_page_opened": // Payment page has been displayed break; case "checkout.customer_details_submitted": // Customer and billing details submitted break; case "checkout.closed": // Checkout has been closed break; case "checkout.redirect": // Checkout will perform a redirect break; case "checkout.error": // An error occurred console.error("Error:", event.data?.message); break; case "checkout.link_expired": // Checkout session has expired (only when showTimer is false) break; case "checkout.status": // Checkout status update (only when manualRedirect is enabled) const status = event.data?.message?.status; break; case "checkout.redirect_requested": // Redirect requested (only when manualRedirect is enabled) const redirectUrl = event.data?.message?.redirect_to; break; } }});
घटना प्रकार
विवरण
checkout.opened
चेकआउट ओवरले खोला गया
checkout.payment_page_opened
भुगतान पृष्ठ प्रदर्शित किया गया
checkout.customer_details_submitted
ग्राहक और बिलिंग विवरण प्रस्तुत किए गए
checkout.closed
चेकआउट ओवरले बंद किया गया
checkout.redirect
चेकआउट पुनर्निर्देशन करेगा
checkout.error
चेकआउट के दौरान एक त्रुटि हुई
checkout.link_expired
जब चेकआउट सत्र समाप्त होता है तो फायर किया जाता है। केवल तब प्राप्त होता है जब showTimer को false पर सेट किया गया हो।
checkout.status
जब manualRedirect सक्षम होता है तो फायर किया जाता है। चेकआउट स्थिति (succeeded, failed, या processing) को शामिल करता है।
checkout.redirect_requested
जब manualRedirect सक्षम होता है तो फायर किया जाता है। ग्राहक को पुनर्निर्देशित करने के लिए URL शामिल करता है।
आप चेकआउट उपस्थिति को themeConfig ऑब्जेक्ट को options पैरामीटर में पास करके अनुकूलित कर सकते हैं जब चेकआउट खोलते हैं। थीम कॉन्फ़िगरेशन हल्के और गहरे दोनों मोड का समर्थन करता है, जिससे आप रंग, सीमाएँ, पाठ, बटन और सीमा त्रिज्या को अनुकूलित कर सकते हैं।
SDK घटनाओं के माध्यम से विस्तृत त्रुटि जानकारी प्रदान करता है। हमेशा अपने onEvent कॉलबैक में उचित त्रुटि हैंडलिंग लागू करें:
कॉपी करें
DodoPayments.Initialize({ mode: "test", displayType: "overlay", onEvent: (event: CheckoutEvent) => { if (event.event_type === "checkout.error") { console.error("Checkout error:", event.data?.message); // Handle error appropriately // You may want to show a user-friendly error message // or retry the checkout process } if (event.event_type === "checkout.link_expired") { // Handle expired checkout session console.warn("Checkout session has expired"); } }});
हमेशा त्रुटियों के होने पर एक अच्छा उपयोगकर्ता अनुभव प्रदान करने के लिए checkout.error घटना को संभालें।
एप्पल पे ग्राहकों को उनके सहेजे गए भुगतान विधियों का उपयोग करके तेजी से और सुरक्षित रूप से भुगतान पूरा करने की अनुमति देता है। जब सक्षम किया जाता है, तो ग्राहक समर्थित उपकरणों पर चेकआउट ओवरले से सीधे एप्पल पे मोडल लॉन्च कर सकते हैं।
एप्पल पे iOS 17+, iPadOS 17+, और macOS पर Safari 17+ पर समर्थित है।
अपने डोमेन के लिए उत्पादन में एप्पल पे सक्षम करने के लिए, इन चरणों का पालन करें:
1
एप्पल पे डोमेन एसोसिएशन फ़ाइल डाउनलोड और अपलोड करें
एप्पल पे डोमेन एसोसिएशन फ़ाइल डाउनलोड करें।फाइल को अपने वेब सर्वर पर /.well-known/apple-developer-merchantid-domain-association पर अपलोड करें। उदाहरण के लिए, यदि आपकी वेबसाइट example.com है, तो फाइल को https://example.com/well-known/apple-developer-merchantid-domain-association पर उपलब्ध कराएँ।
आपका उत्पादन डोमेन URL (जैसे, https://example.com)
अपने डोमेन के लिए Apple Pay सक्षम करने के लिए अनुरोध
आपको 1-2 कार्य दिवसों के भीतर पुष्टि प्राप्त होगी जब एप्पल पे आपके डोमेन के लिए सक्षम हो जाएगा।
3
एप्पल पे उपलब्धता की पुष्टि करें
पुष्टि प्राप्त करने के बाद, अपने चेकआउट में एप्पल पे का परीक्षण करें:
समर्थित उपकरण (iOS 17+, iPadOS 17+, या macOS पर Safari 17+) पर अपने चेकआउट को खोलें
सत्यापित करें कि एप्पल पे बटन भुगतान विकल्प के रूप में दिखाई देता है
पूर्ण भुगतान प्रवाह का परीक्षण करें
एप्पल पे को आपके डोमेन के लिए सक्षम किया जाना चाहिए इससे पहले कि यह उत्पादन में भुगतान विकल्प के रूप में दिखाई दे। यदि आप एप्पल पे की पेशकश करने की योजना बना रहे हैं तो लाइव जाने से पहले समर्थन से संपर्क करें।