> ## 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.

# Billing SDK

> Vollständige Abrechnungsinfrastruktur für moderne Webanwendungen mit React-Komponenten, CLI-Tools und Full-Stack-Integration

<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>

Billing SDK ist eine umfassende Open-Source-Lösung, die eine vollständige Abrechnungsinfrastruktur für moderne Webanwendungen bereitstellt. Es umfasst React-Komponenten, CLI-Tools und Unterstützung für die Full-Stack-Integration mit mehreren Frameworks von Dodo Payments.

## Übersicht

Billing SDK bietet:

* **React-Komponenten**: Vorgefertigte, anpassbare Abrechnungskomponenten für React-Anwendungen
* **CLI-Tools**: Befehlszeilenschnittstelle zur Projektinitialisierung und Komponentenverwaltung
* **Framework-Unterstützung**: Integration mit Next.js, Express.js, Hono, Fastify und React
* **Zahlungsanbieter**: Vollständige Integration mit Dodo Payments

## Schnellstart

Starten Sie mit Billing SDK in wenigen Minuten:

<Steps>
  <Step title="Install the CLI">
    Verwende npx, um die CLI ohne Installation auszuführen:

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

    Oder installieren Sie sie global für häufige Nutzung:

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

  <Step title="Initialize a Project">
    Führe das interaktive Setup aus, um ein neues Abrechnungsprojekt zu erstellen:

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

    Du wirst aufgefordert, Folgendes auszuwählen:

    * Dein bevorzugtes Framework (Next.js, Express.js, Hono, Fastify, React)
    * Deinen Zahlungsanbieter (Dodo Payments)
  </Step>

  <Step title="Add Components">
    Füge deinem Projekt einzelne Abrechnungskomponenten hinzu:

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

## Unterstützte Frameworks

Billing SDK unterstützt mehrere Frameworks mit umfassender Dodo Payments-Integration:

| Framework  | Dodo Payments |
| ---------- | ------------- |
| Next.js    | ✅ Ja          |
| Express.js | ✅ Ja          |
| Hono       | ✅ Ja          |
| React      | ✅ Ja          |
| Fastify    | ✅ Ja          |

## CLI-Befehle

### `@billingsdk/cli init`

Initialisieren Sie ein neues Abrechnungsprojekt mit vollständiger Einrichtung, einschließlich Framework-Konfiguration, Dodo Payments-Integration und wesentlichen Abhängigkeiten.

**Was es tut:**

1. **Framework-Auswahl**: Wählen Sie Ihr bevorzugtes Framework
2. **Template-Installation**: Lädt und installiert frameworkspezifische Templates mit Dodo Payments-Integration
3. **Abhängigkeitsmanagement**: Installiert automatisch erforderliche Abhängigkeiten
4. **Dateigenerierung**: Erstellt notwendige Konfigurationsdateien und Boilerplate-Code

**Beispiel:**

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

### `@billingsdk/cli add`

Fügen Sie einzelne Abrechnungskomponenten zu Ihrem bestehenden Projekt mit dem shadcn/ui-Registrierungssystem hinzu.

**Beispiele:**

```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
```

**Was passiert:**

1. Lädt die Komponenten-Konfiguration aus dem Register herunter
2. Installiert die Komponenten-Dateien in deinem `components/billingsdk/` Verzeichnis
3. Aktualisiert deine Projektkonfiguration bei Bedarf
4. Installiert alle zusätzlichen Abhängigkeiten

## Struktur der generierten Dateien

Nachdem du `init` ausgeführt hast, erhältst du eine vollständige Projektstruktur mit:

* **API-Routen**: Umfassende Endpunkte für Checkout, Kunden, Produkte, Abonnements und Webhooks
* **Hooks**: React-Hooks für Abrechnungsoperationen (bei Verwendung von React/Next.js)
* **Bibliotheksdateien**: Initialisierung des Zahlungsanbieter-Clients und Dienstprogramme
* **Umgebungs-Konfiguration**: Beispiel-Umgebungsvariablen-Dateien

### Next.js Beispielstruktur

```
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
```

## Umgebungs-Konfiguration

Konfigurieren Sie Ihre Umgebungsvariablen nach der Initialisierung:

```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>
  Bewahre deine API-Schlüssel stets sicher in Umgebungsvariablen auf. Kommittiere sie niemals in die Versionskontrolle.
</Warning>

## Verfügbare Komponenten

Billing SDK bietet eine umfassende Sammlung von React-Komponenten:

* **Preistabellen**: Mehrere Varianten zur Anzeige von Produktpreisen
* **Abonnementverwaltung**: Komponenten zur Verwaltung von Kundenabonnements
* **Nutzungsüberwachung**: Visuelle Komponenten zur Verfolgung der nutzungsbasierten Abrechnung
* **Checkout-Komponenten**: Vorgefertigte Checkout-Flows
* **Kundenportal**: Komponenten für den Selbstservice der Kunden

## Open Source

Billing SDK basiert auf Open-Source-Prinzipien:

* 🔍 **Transparenz**: Volle Sichtbarkeit, wie Komponenten funktionieren
* 🤝 **Gemeinschaft**: Entwickelt von Entwicklern für Entwickler
* 🔒 **Sicherheit**: Offener Code bedeutet bessere Sicherheit durch Peer-Review
* 📈 **Innovation**: Schnellere Iteration durch Beiträge der Gemeinschaft

<Info>
  Das Billing SDK wird unter der GNU General Public License (GPL) veröffentlicht, wodurch sichergestellt ist, dass das Projekt offen und kostenlos bleibt.
</Info>

## Hilfe erhalten

Benötigen Sie Unterstützung mit Billing SDK?

* **GitHub Issues**: [Ein Problem melden](https://github.com/dodopayments/billingsdk/issues)
* **Dokumentation**: Besuchen Sie [billingsdk.com/docs](https://billingsdk.com/docs)
* **LLMs Vollständige Dokumentation**: [billingsdk.com/llms-full.txt](https://billingsdk.com/llms-full.txt)

## Mitwirken

Wir freuen uns über Beiträge! Siehe unseren [Beitragsleitfaden](https://billingsdk.com/docs/contribution-open-source) für Details zu:

* Fehlerberichten
* Funktionsanfragen
* Einreichung von Pull-Requests
* Hinzufügen neuer Komponenten
* Verbesserung der Dokumentation

## Mehr erfahren

<CardGroup cols={3}>
  <Card title="Full Documentation" icon="book" href="https://billingsdk.com/docs">
    Vollständige Anleitung zum Billing SDK mit Beispielen und Best Practices
  </Card>

  <Card title="CLI Reference" icon="terminal" href="https://billingsdk.com/docs/cli">
    Detaillierte CLI-Dokumentation für alle Befehle und Optionen
  </Card>

  <Card title="Component Library" icon="boxes-stacked" href="https://billingsdk.com/docs/components">
    Durchsuche alle verfügbaren Komponenten mit Live-Beispielen
  </Card>
</CardGroup>