अवलोकन
Astro न्यूनतम बॉयलरप्लेट आपके Astro एप्लिकेशन के साथ Dodo Payments को एकीकृत करने के लिए एक तैयार-से-उपयोग प्रारंभिक बिंदु प्रदान करता है। इस टेम्पलेट में चेकआउट सत्र, वेबहुक हैंडलिंग, ग्राहक पोर्टल, और आधुनिक UI घटक शामिल हैं जो आपको जल्दी से भुगतान स्वीकार करने में मदद करते हैं।यह बायलरप्लेट Astro 5 का उपयोग करता है जिसमें TypeScript, Tailwind CSS 4, और
@dodopayments/astro एडेप्टर है।विशेषताएँ
- त्वरित सेटअप - 5 मिनट से कम में शुरू करें
- भुगतान एकीकरण -
@dodopayments/astroका उपयोग करके पूर्व-कॉन्फ़िगर किया गया चेकआउट प्रवाह - आधुनिक UI - Tailwind CSS के साथ साफ, डार्क-थीम वाला मूल्य निर्धारण पृष्ठ
- Webhook हैंडलर - भुगतान घटनाओं के लिए उपयोग के लिए तैयार webhook एंडपॉइंट
- ग्राहक पोर्टल - एक-क्लिक सदस्यता प्रबंधन
- TypeScript - न्यूनतम, केंद्रित प्रकारों के साथ पूरी तरह से टाइप किया गया
- पूर्व-भरा चेकआउट - UX में सुधार के लिए ग्राहक डेटा पास करने का प्रदर्शन
पूर्वापेक्षाएँ
शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:- Node.js LTS संस्करण (Astro 5 के लिए आवश्यक)
- Dodo Payments खाता (डैशबोर्ड से API और वेबहुक कुंजी तक पहुँचने के लिए)
त्वरित प्रारंभ
API क्रेडेंशियल प्राप्त करें
Dodo Payments पर साइन अप करें और डैशबोर्ड से अपने क्रेडेंशियल प्राप्त करें:
- API कुंजी: डैशबोर्ड → डेवलपर → API कुंजी
- वेबहुक कुंजी: डैशबोर्ड → डेवलपर → वेबहुक
पर्यावरण चर कॉन्फ़िगर करें
रूट निर्देशिका में एक अपने Dodo Payments क्रेडेंशियल के साथ मान अपडेट करें:
.env फ़ाइल बनाएं:अपने उत्पाद जोड़ें
src/lib/products.ts को अपने वास्तविक उत्पाद आईडी के साथ अपडेट करें जो Dodo Payments से हैं:विकास सर्वर चलाएँ
परियोजना संरचना
अनुकूलन
उत्पाद जानकारी अपडेट करें
src/lib/products.ts को संपादित करें:
- उत्पाद आईडी (आपके Dodo डैशबोर्ड से)
- मूल्य निर्धारण
- विशेषताएँ
- विवरण
ग्राहक डेटा पूर्व-भरा करें
src/components/ProductCard.astro में, हार्डकोडेड मानों को अपने वास्तविक उपयोगकर्ता डेटा के साथ बदलें:
ग्राहक पोर्टल अपडेट करें
src/components/Header.astro में, हार्डकोडेड ग्राहक आईडी को अपने प्रमाणीकरण प्रणाली या डेटाबेस से वास्तविक ग्राहक आईडी के साथ बदलें:
वेबहुक घटनाएँ
बायलरप्लेटsrc/pages/api/webhook.ts में webhook घटनाओं को संभालने का प्रदर्शन करता है:
onSubscriptionActive- जब एक सदस्यता सक्रिय होती है तो ट्रिगर किया जाता हैonSubscriptionCancelled- जब एक सदस्यता रद्द की जाती है तो ट्रिगर किया जाता है
तैनाती
यह बॉयलरप्लेट API मार्गों के लिए मांग पर रेंडरिंग के साथ स्थैतिक आउटपुट का उपयोग करता है। आपको अपने तैनाती प्लेटफ़ॉर्म के लिए एक एडेप्टर स्थापित करने की आवश्यकता होगी:| प्लेटफ़ॉर्म | गाइड |
|---|---|
| Vercel | Vercel पर तैनात करें |
| Netlify | Netlify पर तैनात करें |
| Cloudflare | Cloudflare पर तैनात करें |
वेबहुक URL अपडेट करें
तैनाती के बाद, अपने वेबहुक URL को Dodo Payments डैशबोर्ड में अपडेट करें:DODO_PAYMENTS_WEBHOOK_KEY पर्यावरण चर को अपडेट करें ताकि यह आपके तैनात डोमेन के लिए webhook साइनिंग कुंजी से मेल खाता हो।
समस्या निवारण
मॉड्यूल नहीं मिला या निर्माण त्रुटियाँ
मॉड्यूल नहीं मिला या निर्माण त्रुटियाँ
node_modules को हटाएं और निर्भरताएँ फिर से स्थापित करें:चेकआउट रीडायरेक्ट विफल होता है
चेकआउट रीडायरेक्ट विफल होता है
सामान्य कारण:
- अमान्य उत्पाद आईडी - सत्यापित करें कि यह आपके Dodo डैशबोर्ड में मौजूद है
- गलत API कुंजी या पर्यावरण सेटिंग
.envमें - त्रुटियों के लिए ब्राउज़र कंसोल और टर्मिनल की जांच करें
वेबहुक घटनाएँ प्राप्त नहीं कर रहे हैं
वेबहुक घटनाएँ प्राप्त नहीं कर रहे हैं
स्थानीय परीक्षण के लिए, अपने सर्वर को उजागर करने के लिए ngrok का उपयोग करें:अपने Dodo डैशबोर्ड में वेबहुक URL को ngrok URL पर अपडेट करें। सही वेबहुक सत्यापन कुंजी के साथ अपने .env फ़ाइल को अपडेट करना न भूलें।
ग्राहक पोर्टल लिंक काम नहीं करता
ग्राहक पोर्टल लिंक काम नहीं करता
CUSTOMER_ID को src/components/Header.astro में हार्डकोडेड के साथ बदलें जो आपके Dodo डैशबोर्ड से वास्तविक ग्राहक आईडी है।या ग्राहक ID को गतिशील रूप से लाने के लिए अपने प्रमाणीकरण प्रणाली और डेटाबेस को एकीकृत करें।बिल्ड एडेप्टर त्रुटि के साथ विफल
बिल्ड एडेप्टर त्रुटि के साथ विफल
यह बॉयलरप्लेट मांग पर API मार्गों के साथ स्थैतिक आउटपुट का उपयोग करता है। तैनाती के लिए आपको एक एडेप्टर स्थापित करने की आवश्यकता है:तथ्यों के लिए Astro के तैनाती गाइड देखें।
अधिक जानें
सहायता
बॉयलरप्लेट के साथ मदद चाहिए?- प्रश्नों और चर्चाओं के लिए हमारे Discord समुदाय में शामिल हों
- मुद्दों और अपडेट के लिए GitHub रिपॉजिटरी की जांच करें
- सहायता के लिए हमारी सहायता टीम से संपर्क करें