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

> Komplett faktureringsinfrastruktur för moderna webbapplikationer med React-komponenter, CLI-verktyg och fullstackintegration

<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 är en omfattande öppen källkods-lösning som tillhandahåller komplett faktureringsinfrastruktur för moderna webbapplikationer. Den inkluderar React-komponenter, CLI-verktyg och fullstackintegrationsstöd för flera ramverk med Dodo Payments.

## Översikt

Billing SDK erbjuder:

* **React-komponenter**: Förbyggda, anpassningsbara faktureringskomponenter för React-applikationer
* **CLI-verktyg**: Kommandoradsgränssnitt för projektinitiering och komponenthantering
* **Ramverksstöd**: Integration med Next.js, Express.js, Hono, Fastify och React
* **Betalningsleverantör**: Full integration med Dodo Payments

## Snabbstart

Kom igång med Billing SDK på några minuter:

<Steps>
  <Step title="Install the CLI">
    Använd npx för att köra CLI utan installation:

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

    Eller installera det globalt för frekvent användning:

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

  <Step title="Initialize a Project">
    Kör den interaktiva konfigurationen för att skapa ett nytt faktureringsprojekt:

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

    Du ombeds välja:

    * Ditt föredragna ramverk (Next.js, Express.js, Hono, Fastify, React)
    * Din betalningsleverantör (Dodo Payments)
  </Step>

  <Step title="Add Components">
    Lägg till enskilda faktureringskomponenter i ditt projekt:

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

## Stödda ramverk

Billing SDK stöder flera ramverk med omfattande Dodo Payments-integration:

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

## CLI-kommandon

### `@billingsdk/cli init`

Initiera ett nytt faktureringsprojekt med komplett installation inklusive ramverkskonfiguration, Dodo Payments-integration och nödvändiga beroenden.

**Vad det gör:**

1. **Ramverksval**: Välj ditt föredragna ramverk
2. **Mallinstallation**: Laddar ner och installerar ramverkspecifika mallar med Dodo Payments-integration
3. **Beroendehantering**: Installerar automatiskt nödvändiga beroenden
4. **Filgenerering**: Skapar nödvändiga konfigurationsfiler och grundkod

**Exempel:**

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

### `@billingsdk/cli add`

Lägg till individuella faktureringskomponenter i ditt befintliga projekt med hjälp av shadcn/ui-registersystemet.

**Exempel:**

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

**Vad som händer:**

1. Hämtar komponentkonfigurationen från registret
2. Installerar komponentfilerna i din `components/billingsdk/`-katalog
3. Uppdaterar din projektkonfiguration vid behov
4. Installerar eventuella ytterligare beroenden

## Genererad filstruktur

Efter att ha kört `init` får du en komplett projektstruktur med:

* **API-rutter**: Omfattande slutpunkter för kassa, kunder, produkter, prenumerationer och webhooks
* **Hooks**: React-hooks för faktureringsoperationer (om du använder React/Next.js)
* **Biblioteksfiler**: Betalningsleverantörens klientinitialisering och verktyg
* **Miljökonfiguration**: Exempel på miljövariabelfiler

### Next.js exempelstruktur

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

## Miljökonfiguration

Konfigurera dina miljövariabler efter initiering:

```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>
  Spara alltid dina API-nycklar säkert med hjälp av miljövariabler. Låt dem aldrig ingå i versionskontrollen.
</Warning>

## Tillgängliga komponenter

Billing SDK tillhandahåller en omfattande samling av React-komponenter:

* **Prissättningsbord**: Flera varianter för att visa produktpriser
* **Prenumerationshantering**: Komponenter för att hantera kundprenumerationer
* **Användningsövervakning**: Visuella komponenter för att spåra användningsbaserad fakturering
* **Kassakomponenter**: Förbyggda kassaflöden
* **Kundportal**: Komponenter för kundsjälvbetjäning

## Öppen källkod

Billing SDK är byggt på principer för öppen källkod:

* 🔍 **Transparens**: Full insyn i hur komponenter fungerar
* 🤝 **Gemenskap**: Byggt av utvecklare, för utvecklare
* 🔒 **Säkerhet**: Öppen kod innebär bättre säkerhet genom peer review
* 📈 **Innovation**: Snabbare iteration genom gemenskapsbidrag

<Info>
  Billing SDK släpps under GNU General Public License (GPL) för att säkerställa att projektet förblir öppet och kostnadsfritt.
</Info>

## Få hjälp

Behöver du hjälp med Billing SDK?

* **GitHub Issues**: [Öppna ett ärende](https://github.com/dodopayments/billingsdk/issues)
* **Dokumentation**: Besök [billingsdk.com/docs](https://billingsdk.com/docs)
* **LLMs Full Documentation**: [billingsdk.com/llms-full.txt](https://billingsdk.com/llms-full.txt)

## Bidra

Vi välkomnar bidrag! Se vår [bidragsguide](https://billingsdk.com/docs/contribution-open-source) för detaljer om:

* Rapportera buggar
* Begära funktioner
* Skicka pull requests
* Lägga till nya komponenter
* Förbättra dokumentationen

## Lär dig mer

<CardGroup cols={3}>
  <Card title="Full Documentation" icon="book" href="https://billingsdk.com/docs">
    Komplett guide till Billing SDK med exempel och bästa praxis
  </Card>

  <Card title="CLI Reference" icon="terminal" href="https://billingsdk.com/docs/cli">
    Detaljerad CLI-dokumentation för alla kommandon och alternativ
  </Card>

  <Card title="Component Library" icon="boxes-stacked" href="https://billingsdk.com/docs/components">
    Bläddra bland alla tillgängliga komponenter med liveexempel
  </Card>
</CardGroup>