अवलोकन
Next.js न्यूनतम बुनियाद आपके Next.js एप्लिकेशन के साथ Dodo Payments को एकीकृत करने के लिए एक तैयार-से-उपयोग प्रारंभिक बिंदु प्रदान करता है। इस टेम्पलेट में चेकआउट सत्र, वेबहुक हैंडलिंग, ग्राहक पोर्टल, और आधुनिक UI घटक शामिल हैं जो आपको जल्दी से भुगतान स्वीकार करने में मदद करते हैं।यह बुनियाद Next.js 16 ऐप राउटर, TypeScript, Tailwind CSS 4, और
@dodopayments/nextjs एडेप्टर का उपयोग करता है।विशेषताएँ
- त्वरित सेटअप - 5 मिनट से कम समय में शुरू करें
- भुगतान एकीकरण -
@dodopayments/nextjsका उपयोग करके पूर्व-कॉन्फ़िगर किया गया चेकआउट प्रवाह - आधुनिक UI - Tailwind CSS के साथ साफ, डार्क-थीम वाला मूल्य निर्धारण पृष्ठ
- वेबहुक हैंडलर - भुगतान घटनाओं के लिए तैयार-से-उपयोग वेबहुक एंडपॉइंट
- ग्राहक पोर्टल - एक-क्लिक सदस्यता प्रबंधन
- TypeScript - न्यूनतम, केंद्रित प्रकारों के साथ पूरी तरह से टाइप किया गया
- पूर्व-भरे हुए चेकआउट - UX में सुधार के लिए ग्राहक डेटा पास करने का प्रदर्शन
पूर्वापेक्षाएँ
शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:- Node.js 20.9+ (Next.js 16 के लिए आवश्यक)
- Dodo Payments खाता (डैशबोर्ड से API और वेबहुक कुंजी तक पहुँचने के लिए)
त्वरित प्रारंभ
1
गिट रिपॉजिटरी क्लोन करें
2
निर्भरता स्थापित करें
3
API क्रेडेंशियल प्राप्त करें
Dodo Payments पर साइन अप करें और डैशबोर्ड से अपने क्रेडेंशियल प्राप्त करें:
- API कुंजी: डैशबोर्ड → डेवलपर → API कुंजी
- वेबहुक कुंजी: डैशबोर्ड → डेवलपर → वेबहुक
4
पर्यावरण चर कॉन्फ़िगर करें
रूट निर्देशिका में एक अपने Dodo Payments क्रेडेंशियल के साथ मान अपडेट करें:
.env फ़ाइल बनाएं:5
अपने उत्पाद जोड़ें
src/lib/products.ts को अपने वास्तविक उत्पाद IDs के साथ अपडेट करें जो Dodo Payments से हैं:6
विकास सर्वर चलाएँ
परियोजना संरचना
अनुकूलन
उत्पाद जानकारी अपडेट करें
src/lib/products.ts को संपादित करें:
- उत्पाद IDs (आपके Dodo डैशबोर्ड से)
- मूल्य निर्धारण
- विशेषताएँ
- विवरण
ग्राहक डेटा पूर्व-भरे
src/app/components/ProductCard.tsx में, हार्डकोडेड मानों को अपने वास्तविक उपयोगकर्ता डेटा के साथ बदलें:
ग्राहक पोर्टल अपडेट करें
src/app/components/Header.tsx में, हार्डकोडेड ग्राहक ID को बदलें:
वेबहुक घटनाएँ
यह बुनियादsrc/app/api/webhook/route.ts में दो वेबहुक घटनाओं को संभालने का प्रदर्शन करता है:
onSubscriptionActive- जब एक सदस्यता सक्रिय होती है तो ट्रिगर होता हैonPaymentSucceeded- जब एक भुगतान सफल होता है तो ट्रिगर होता है
तैनाती
उत्पादन के लिए निर्माण करें
Vercel पर तैनात करें
[वेबहुक URL अपडेट करें
तैनाती के बाद, अपने वेबहुक URL को Dodo Payments डैशबोर्ड में अपडेट करें:समस्या निवारण
मॉड्यूल नहीं मिला या निर्माण त्रुटियाँ
मॉड्यूल नहीं मिला या निर्माण त्रुटियाँ
node_modules को हटाएँ और निर्भरताएँ फिर से स्थापित करें:चेकआउट रीडायरेक्ट विफल
चेकआउट रीडायरेक्ट विफल
सामान्य कारण:
- अमान्य उत्पाद ID - सत्यापित करें कि यह आपके Dodo डैशबोर्ड में मौजूद है
.envमें गलत API कुंजी या पर्यावरण सेटिंग- त्रुटियों के लिए ब्राउज़र कंसोल और टर्मिनल की जांच करें
वेबहुक घटनाएँ प्राप्त नहीं कर रहे हैं
वेबहुक घटनाएँ प्राप्त नहीं कर रहे हैं
स्थानीय परीक्षण के लिए, अपने सर्वर को उजागर करने के लिए ngrok का उपयोग करें:ngrok URL पर अपने Dodo डैशबोर्ड में वेबहुक URL अपडेट करें। सही वेबहुक सत्यापन कुंजी के साथ अपने .env फ़ाइल को अपडेट करना न भूलें।
ग्राहक पोर्टल लिंक काम नहीं कर रहा
ग्राहक पोर्टल लिंक काम नहीं कर रहा
CUSTOMER_ID को src/app/components/Header.tsx में हार्डकोडेड के बजाय अपने Dodo डैशबोर्ड से वास्तविक ग्राहक ID के साथ बदलें।या ग्राहक ID को गतिशील रूप से लाने के लिए अपने प्रमाणीकरण प्रणाली और डेटाबेस को एकीकृत करें।अधिक जानें
सहायता
बुनियाद के साथ मदद चाहिए?- प्रश्नों और चर्चाओं के लिए हमारे Discord समुदाय में शामिल हों
- मुद्दों और अपडेट के लिए GitHub रिपॉजिटरी की जांच करें
- सहायता के लिए हमारी सहायता टीम से संपर्क करें