> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# बिलिंग SDK

> आधुनिक वेब अनुप्रयोगों के लिए पूर्ण बिलिंग अवसंरचना जिसमें React घटक, CLI उपकरण और पूर्ण-स्टैक एकीकरण शामिल हैं

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/32RVbEllEi0" title="Billing SDK | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

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

## अवलोकन

बिलिंग SDK प्रदान करता है:

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

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

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

<Steps>
  <Step title="Install the CLI">
    npx का उपयोग CLI को बिना इंस्टाल किए चलाने के लिए करें:

    ```bash theme={null}
    npx @billingsdk/cli --help
    ```

    या इसे बार-बार उपयोग के लिए वैश्विक रूप से स्थापित करें:

    ```bash theme={null}
    npm install -g @billingsdk/cli
    ```
  </Step>

  <Step title="Initialize a Project">
    एक नया बिलिंग प्रोजेक्ट बनाने के लिए इंटरैक्टिव सेटअप चलाएँ:

    ```bash theme={null}
    npx @billingsdk/cli init
    ```

    आपसे चुनने के लिए कहा जाएगा:

    * आपकी पसंदीदा फ्रेमवर्क (Next.js, Express.js, Hono, Fastify, React)
    * आपका पेमेंट प्रोवाइडर (Dodo Payments)
  </Step>

  <Step title="Add Components">
    अपने प्रोजेक्ट में व्यक्तिगत बिलिंग कंपोनेंट्स जोड़ें:

    ```bash theme={null}
    npx @billingsdk/cli add pricing-table-one
    npx @billingsdk/cli add subscription-management
    ```
  </Step>
</Steps>

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

बिलिंग SDK कई ढांचों का समर्थन करता है जिसमें डोडो पेमेंट्स का व्यापक एकीकरण है:

| ढांचा      | डोडो पेमेंट्स |
| ---------- | ------------- |
| Next.js    | ✅ हाँ         |
| Express.js | ✅ हाँ         |
| Hono       | ✅ हाँ         |
| React      | ✅ हाँ         |
| Fastify    | ✅ हाँ         |

## CLI कमांड

### `@billingsdk/cli init`

पूर्ण सेटअप के साथ एक नया बिलिंग प्रोजेक्ट प्रारंभ करें जिसमें ढांचा कॉन्फ़िगरेशन, डोडो पेमेंट्स का एकीकरण, और आवश्यक निर्भरताएँ शामिल हैं।

**यह क्या करता है:**

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

**उदाहरण:**

```bash theme={null}
npx @billingsdk/cli init
```

### `@billingsdk/cli add`

shadcn/ui रजिस्ट्रि प्रणाली का उपयोग करके अपने मौजूदा प्रोजेक्ट में व्यक्तिगत बिलिंग घटक जोड़ें।

**उदाहरण:**

```bash theme={null}
# 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
```

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

प्रारंभ के बाद अपने पर्यावरण चर को कॉन्फ़िगर करें:

```bash theme={null}
# 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
```

<Warning>
  हमेशा अपने API कीज़ को सुरक्षित रूप से पर्यावरण चर (environment variables) का उपयोग करके स्टोर करें। उन्हें संस्करण नियंत्रण में कभी भी कमिट न करें।
</Warning>

## उपलब्ध घटक

बिलिंग SDK एक व्यापक React घटकों का संग्रह प्रदान करता है:

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

## ओपन सोर्स

बिलिंग SDK ओपन-सोर्स सिद्धांतों पर आधारित है:

* 🔍 **पारदर्शिता**: घटकों के काम करने के तरीके पर पूर्ण दृश्यता
* 🤝 **समुदाय**: डेवलपर्स द्वारा, डेवलपर्स के लिए बनाया गया
* 🔒 **सुरक्षा**: ओपन कोड का मतलब बेहतर सुरक्षा है जो सहकर्मी समीक्षा के माध्यम से होती है
* 📈 **नवाचार**: सामुदायिक योगदान के माध्यम से तेज़ पुनरावृत्ति

<Info>
  Billing SDK को GNU जनरल पब्लिक लाइसेंस (GPL) के अंतर्गत जारी किया गया है, जिससे यह प्रोजेक्ट खुला और मुफ़्त बना रहता है।
</Info>

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

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

* **GitHub मुद्दे**: [एक मुद्दा खोलें](https://github.com/dodopayments/billingsdk/issues)
* **दस्तावेज़ीकरण**: [billingsdk.com/docs](https://billingsdk.com/docs) पर जाएं
* **LLMs पूर्ण दस्तावेज़ीकरण**: [billingsdk.com/llms-full.txt](https://billingsdk.com/llms-full.txt)

## योगदान

हम योगदान का स्वागत करते हैं! विवरण के लिए हमारे [योगदान गाइड](https://billingsdk.com/docs/contribution-open-source) को देखें:

* बग रिपोर्ट करना
* सुविधाओं का अनुरोध करना
* पुल अनुरोध सबमिट करना
* नए घटक जोड़ना
* दस्तावेज़ीकरण में सुधार करना

## अधिक जानें

<CardGroup cols={3}>
  <Card title="Full Documentation" icon="book" href="https://billingsdk.com/docs">
    उदाहरणों और सर्वोत्तम प्रथाओं के साथ Billing SDK के लिए पूर्ण मार्गदर्शिका
  </Card>

  <Card title="CLI Reference" icon="terminal" href="https://billingsdk.com/docs/cli">
    सभी कमांड और विकल्पों के लिए विस्तृत CLI दस्तावेज़
  </Card>

  <Card title="Component Library" icon="boxes-stacked" href="https://billingsdk.com/docs/components">
    लाइव उदाहरणों के साथ सभी उपलब्ध कंपोनेंट्स ब्राउज़ करें
  </Card>
</CardGroup>