Vai al contenuto principale
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:
1

Installa il CLI

Usa npx per eseguire il CLI senza installazione:
npx @billingsdk/cli --help
Oppure installalo globalmente per un uso frequente:
npm install -g @billingsdk/cli
2

Inizializza un Progetto

Esegui la configurazione interattiva per creare un nuovo progetto di fatturazione:
npx @billingsdk/cli init
Ti verrà chiesto di selezionare:
  • Il tuo framework preferito (Next.js, Express.js, Hono, Fastify, React)
  • Il tuo fornitore di pagamento (Dodo Payments)
3

Aggiungi Componenti

Aggiungi componenti di fatturazione individuali al tuo progetto:
npx @billingsdk/cli add pricing-table-one
npx @billingsdk/cli add subscription-management

​
Framework Supportati

Billing SDK supporta più framework con integrazione completa di Dodo Payments:
FrameworkDodo 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: 
npx @billingsdk/cli init

​
@billingsdk/cli add

Aggiungi componenti di fatturazione individuali al tuo progetto esistente utilizzando il sistema di registrazione shadcn/ui. Esempi: 
# 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 components/billingsdk/ directory
  3. Aggiorna la configurazione del tuo 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: 
# 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
Conserva sempre le tue chiavi API in modo sicuro utilizzando variabili ambientali. Non commetterle mai nel controllo di versione.

​
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à
Billing SDK è rilasciato sotto la GNU General Public License (GPL), garantendo che il progetto rimanga aperto e gratuito.

​
Ottenere Aiuto

Hai bisogno di assistenza con Billing SDK?

​
Contribuire

Accogliamo con favore i contributi! Consulta la nostra guida ai contributi per dettagli su:
  • Segnalazione di bug
  • Richiesta di funzionalità
  • Invio di pull request
  • Aggiunta di nuovi componenti
  • Miglioramento della documentazione

​
Scopri di Più

Documentazione Completa

Guida completa a Billing SDK con esempi e migliori pratiche

Riferimento CLI

Documentazione dettagliata del CLI per tutti i comandi e le opzioni

Libreria di Componenti

Sfoglia tutti i componenti disponibili con esempi dal vivo