मुख्य सामग्री पर जाएं
बिलिंग SDK एक व्यापक ओपन-सोर्स समाधान है जो आधुनिक वेब अनुप्रयोगों के लिए पूर्ण बिलिंग अवसंरचना प्रदान करता है। इसमें React घटक, CLI उपकरण, और डोडो पेमेंट्स के लिए कई ढांचों के साथ पूर्ण-स्टैक एकीकरण समर्थन शामिल है।

अवलोकन

बिलिंग SDK प्रदान करता है:
  • React घटक: React अनुप्रयोगों के लिए पूर्व-निर्मित, अनुकूलन योग्य बिलिंग घटक
  • CLI उपकरण: परियोजना प्रारंभ और घटक प्रबंधन के लिए कमांड-लाइन इंटरफ़ेस
  • ढांचा समर्थन: Next.js, Express.js, Hono, Fastify, और React के साथ एकीकरण
  • भुगतान प्रदाता: डोडो पेमेंट्स के साथ पूर्ण एकीकरण

त्वरित प्रारंभ

बिलिंग SDK के साथ कुछ ही मिनटों में शुरू करें:
1

Install the CLI

npx का उपयोग CLI को बिना इंस्टाल किए चलाने के लिए करें:
npx @billingsdk/cli --help
या इसे बार-बार उपयोग के लिए वैश्विक रूप से स्थापित करें:
npm install -g @billingsdk/cli
2

Initialize a Project

एक नया बिलिंग प्रोजेक्ट बनाने के लिए इंटरैक्टिव सेटअप चलाएँ:
npx @billingsdk/cli init
आपसे चुनने के लिए कहा जाएगा:
  • आपकी पसंदीदा फ्रेमवर्क (Next.js, Express.js, Hono, Fastify, React)
  • आपका पेमेंट प्रोवाइडर (Dodo Payments)
3

Add Components

अपने प्रोजेक्ट में व्यक्तिगत बिलिंग कंपोनेंट्स जोड़ें:
npx @billingsdk/cli add pricing-table-one
npx @billingsdk/cli add subscription-management

समर्थित ढांचे

बिलिंग SDK कई ढांचों का समर्थन करता है जिसमें डोडो पेमेंट्स का व्यापक एकीकरण है:
ढांचाडोडो पेमेंट्स
Next.js✅ हाँ
Express.js✅ हाँ
Hono✅ हाँ
React✅ हाँ
Fastify✅ हाँ

CLI कमांड

@billingsdk/cli init

पूर्ण सेटअप के साथ एक नया बिलिंग प्रोजेक्ट प्रारंभ करें जिसमें ढांचा कॉन्फ़िगरेशन, डोडो पेमेंट्स का एकीकरण, और आवश्यक निर्भरताएँ शामिल हैं। यह क्या करता है:
  1. ढांचा चयन: अपने पसंदीदा ढांचे का चयन करें
  2. टेम्पलेट स्थापना: डोडो पेमेंट्स के एकीकरण के साथ ढांचा-विशिष्ट टेम्पलेट डाउनलोड और स्थापित करें
  3. निर्भरता प्रबंधन: आवश्यक निर्भरताएँ स्वचालित रूप से स्थापित करें
  4. फाइल निर्माण: आवश्यक कॉन्फ़िगरेशन फ़ाइलें और प्रारंभिक कोड बनाएं
उदाहरण:
npx @billingsdk/cli init

@billingsdk/cli add

shadcn/ui रजिस्ट्रि प्रणाली का उपयोग करके अपने मौजूदा प्रोजेक्ट में व्यक्तिगत बिलिंग घटक जोड़ें। उदाहरण:
# Add a pricing table
npx @billingsdk/cli add pricing-table-one

# Add subscription management
npx @billingsdk/cli add subscription-management

# Add usage monitoring
npx @billingsdk/cli add usage-meter-circle
क्या होता है:
  1. रजिस्ट्री से कंपोनेंट कॉन्फ़िगरेशन डाउनलोड करता है
  2. आपके components/billingsdk/ निर्देशिका में कंपोनेंट फ़ाइलें इंस्टॉल करता है
  3. आवश्यक होने पर आपके प्रोजेक्ट कॉन्फ़िगरेशन को अपडेट करता है
  4. किसी भी अतिरिक्त निर्भरताओं को इंस्टॉल करता है

उत्पन्न फ़ाइलों की संरचना

init चलाने के बाद, आपको पूरा प्रोजेक्ट स्ट्रक्चर मिलेगा जिसमें:
  • API रूट: चेकआउट, ग्राहकों, उत्पादों, सदस्यताओं, और वेबहुक के लिए व्यापक एंडपॉइंट
  • हुक: बिलिंग संचालन के लिए React हुक (यदि React/Next.js का उपयोग कर रहे हैं)
  • पुस्तकालय फ़ाइलें: भुगतान प्रदाता क्लाइंट प्रारंभिककरण और उपयोगिताएँ
  • पर्यावरण कॉन्फ़िगरेशन: उदाहरण पर्यावरण चर फ़ाइलें

Next.js उदाहरण संरचना

your-project/
├── app/api/
│   └── (dodopayments)/
│       ├── checkout/route.ts
│       ├── customer/route.ts
│       ├── customer/payments/route.ts
│       ├── customer/subscriptions/route.ts
│       ├── product/route.ts
│       ├── products/route.ts
│       └── webhook/route.ts
├── hooks/
│   └── useBilling.ts
├── lib/
│   └── dodopayments.ts
└── .env.example

पर्यावरण कॉन्फ़िगरेशन

प्रारंभ के बाद अपने पर्यावरण चर को कॉन्फ़िगर करें:
# DodoPayments
DODO_PAYMENTS_API_KEY=your_api_key_here
DODO_PAYMENTS_ENVIRONMENT=test_mode
DODO_PAYMENTS_WEBHOOK_KEY=your_webhook_key_here

# App URL
NEXT_PUBLIC_APP_URL=http://localhost:3000
हमेशा अपने API कीज़ को सुरक्षित रूप से पर्यावरण चर (environment variables) का उपयोग करके स्टोर करें। उन्हें संस्करण नियंत्रण में कभी भी कमिट न करें।

उपलब्ध घटक

बिलिंग SDK एक व्यापक React घटकों का संग्रह प्रदान करता है:
  • मूल्य निर्धारण तालिकाएँ: उत्पाद मूल्य निर्धारण प्रदर्शित करने के लिए कई प्रकार
  • सदस्यता प्रबंधन: ग्राहक सदस्यताओं का प्रबंधन करने के लिए घटक
  • उपयोग निगरानी: उपयोग-आधारित बिलिंग को ट्रैक करने के लिए दृश्य घटक
  • चेकआउट घटक: पूर्व-निर्मित चेकआउट प्रवाह
  • ग्राहक पोर्टल: ग्राहक आत्म-सेवा के लिए घटक

ओपन सोर्स

बिलिंग SDK ओपन-सोर्स सिद्धांतों पर आधारित है:
  • 🔍 पारदर्शिता: घटकों के काम करने के तरीके पर पूर्ण दृश्यता
  • 🤝 समुदाय: डेवलपर्स द्वारा, डेवलपर्स के लिए बनाया गया
  • 🔒 सुरक्षा: ओपन कोड का मतलब बेहतर सुरक्षा है जो सहकर्मी समीक्षा के माध्यम से होती है
  • 📈 नवाचार: सामुदायिक योगदान के माध्यम से तेज़ पुनरावृत्ति
Billing SDK को GNU जनरल पब्लिक लाइसेंस (GPL) के अंतर्गत जारी किया गया है, जिससे यह प्रोजेक्ट खुला और मुफ़्त बना रहता है।

सहायता प्राप्त करना

बिलिंग SDK के साथ सहायता की आवश्यकता है?

योगदान

हम योगदान का स्वागत करते हैं! विवरण के लिए हमारे योगदान गाइड को देखें:
  • बग रिपोर्ट करना
  • सुविधाओं का अनुरोध करना
  • पुल अनुरोध सबमिट करना
  • नए घटक जोड़ना
  • दस्तावेज़ीकरण में सुधार करना

अधिक जानें