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

> Infrastruttura di fatturazione completa per moderne applicazioni web con componenti React, strumenti CLI e integrazione full-stack

<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 è una soluzione open-source completa che fornisce un'infrastruttura di fatturazione completa per moderne applicazioni web. Include componenti React, strumenti CLI e supporto per integrazione full-stack con più framework con Dodo Payments.

## Panoramica

Billing SDK offre:

* **Componenti React**: Componenti di fatturazione pre-costruiti e personalizzabili per applicazioni React
* **Strumenti CLI**: Interfaccia a riga di comando per l'inizializzazione del progetto e la gestione dei componenti
* **Supporto per Framework**: Integrazione con Next.js, Express.js, Hono, Fastify e React
* **Fornitore di Pagamento**: Integrazione completa con Dodo Payments

## Inizio Veloce

Inizia con Billing SDK in pochi minuti:

<Steps>
  <Step title="Install the CLI">
    Usa npx per eseguire la CLI senza installazione:

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

    Oppure installalo globalmente per un uso frequente:

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

  <Step title="Initialize a Project">
    Avvia la configurazione interattiva per creare un nuovo progetto di fatturazione:

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

    Ti verrà chiesto di selezionare:

    * Il framework preferito (Next.js, Express.js, Hono, Fastify, React)
    * Il provider di pagamenti (Dodo Payments)
  </Step>

  <Step title="Add Components">
    Aggiungi componenti di fatturazione individuali al tuo progetto:

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

## Framework Supportati

Billing SDK supporta più framework con integrazione completa di Dodo Payments:

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

## Comandi CLI

### `@billingsdk/cli init`

Inizializza un nuovo progetto di fatturazione con configurazione completa, inclusa la configurazione del framework, integrazione di Dodo Payments e dipendenze essenziali.

**Cosa fa:**

1. **Selezione del Framework**: Scegli il tuo framework preferito
2. **Installazione del Modello**: Scarica e installa modelli specifici per il framework con integrazione di Dodo Payments
3. **Gestione delle Dipendenze**: Installa automaticamente le dipendenze richieste
4. **Generazione di File**: Crea i file di configurazione necessari e il codice boilerplate

**Esempio:**

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

### `@billingsdk/cli add`

Aggiungi componenti di fatturazione individuali al tuo progetto esistente utilizzando il sistema di registrazione shadcn/ui.

**Esempi:**

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

**Cosa succede:**

1. Scarica la configurazione del componente dal registro
2. Installa i file del componente nella tua directory `components/billingsdk/`
3. Aggiorna la configurazione del progetto se necessario
4. Installa eventuali dipendenze aggiuntive

## Struttura dei File Generati

Dopo aver eseguito `init`, otterrai una struttura di progetto completa con:

* **API Routes**: Endpoint completi per checkout, clienti, prodotti, abbonamenti e webhook
* **Hooks**: Hooks React per operazioni di fatturazione (se utilizzi React/Next.js)
* **File di Libreria**: Inizializzazione del client del fornitore di pagamento e utility
* **Configurazione Ambientale**: Esempi di file di variabili ambientali

### Struttura Esempio di 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
```

## Configurazione Ambientale

Configura le tue variabili ambientali dopo l'inizializzazione:

```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>
  Conserva sempre le tue chiavi API in modo sicuro utilizzando variabili d'ambiente. Non commetterle mai nel controllo versione.
</Warning>

## Componenti Disponibili

Billing SDK fornisce una collezione completa di componenti React:

* **Tabelle dei Prezzi**: Più varianti per visualizzare i prezzi dei prodotti
* **Gestione degli Abbonamenti**: Componenti per gestire gli abbonamenti dei clienti
* **Monitoraggio dell'Uso**: Componenti visivi per il monitoraggio della fatturazione basata sull'uso
* **Componenti di Checkout**: Flussi di checkout pre-costruiti
* **Portale Clienti**: Componenti per il self-service dei clienti

## Open Source

Billing SDK è costruito su principi open-source:

* 🔍 **Trasparenza**: Visibilità completa su come funzionano i componenti
* 🤝 **Comunità**: Costruito da sviluppatori, per sviluppatori
* 🔒 **Sicurezza**: Codice aperto significa migliore sicurezza attraverso la revisione tra pari
* 📈 **Innovazione**: Iterazione più rapida grazie ai contributi della comunità

<Info>
  Billing SDK è rilasciato con licenza GNU General Public License (GPL), garantendo che il progetto rimanga aperto e gratuito.
</Info>

## Ottenere Aiuto

Hai bisogno di assistenza con Billing SDK?

* **GitHub Issues**: [Apri un problema](https://github.com/dodopayments/billingsdk/issues)
* **Documentazione**: Visita [billingsdk.com/docs](https://billingsdk.com/docs)
* **Documentazione Completa LLMs**: [billingsdk.com/llms-full.txt](https://billingsdk.com/llms-full.txt)

## Contribuire

Accogliamo con favore i contributi! Consulta la nostra [guida ai contributi](https://billingsdk.com/docs/contribution-open-source) per dettagli su:

* Segnalazione di bug
* Richiesta di funzionalità
* Invio di pull request
* Aggiunta di nuovi componenti
* Miglioramento della documentazione

## Scopri di Più

<CardGroup cols={3}>
  <Card title="Full Documentation" icon="book" href="https://billingsdk.com/docs">
    Guida completa a Billing SDK con esempi e best practice
  </Card>

  <Card title="CLI Reference" icon="terminal" href="https://billingsdk.com/docs/cli">
    Documentazione dettagliata della CLI per tutti i comandi e le opzioni
  </Card>

  <Card title="Component Library" icon="boxes-stacked" href="https://billingsdk.com/docs/components">
    Esplora tutti i componenti disponibili con esempi live
  </Card>
</CardGroup>