Billing SDK

​

Panoramica

• Componenti React: componenti di fatturazione predefiniti e personalizzabili per applicazioni React.
• Strumenti CLI: un’interfaccia a riga di comando che inizializza i progetti e aggiunge componenti.
• Supporto per i framework: template per Next.js, Express.js, Hono, Fastify, NestJS e React.
• Provider di pagamento: integrazione completa con Dodo Payments.

​

Inizio Veloce

npx @billingsdk/cli --help

npm install -g @billingsdk/cli

npx @billingsdk/cli init

npx @billingsdk/cli add pricing-table-one
npx @billingsdk/cli add subscription-management

​

Framework Supportati

​

Comandi CLI

​

@billingsdk/cli init

1. Selezione del framework: scegli il framework e il provider di pagamento.
2. Installazione del template: la CLI scarica il template per il tuo framework e provider dal registry di Billing SDK e ne installa i file.
3. Gestione delle dipendenze: la CLI installa le dipendenze del template, come dodopayments, standardwebhooks e zod, con npm, pnpm, Yarn o Bun.
4. Generazione dei file: la CLI scrive i file di configurazione e il codice boilerplate. Per Express.js, Fastify, Hono e NestJS, li scrive in src/.

npx @billingsdk/cli init

​

@billingsdk/cli add

# 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. La CLI shadcn scarica la configurazione del componente dal registry.
2. Installa i file del componente nella directory components/billingsdk/.
3. Aggiorna la configurazione del progetto, se necessario.
4. Installa le dipendenze aggiuntive.

​

Struttura dei file generati

• Route API: endpoint per checkout, clienti, pagamenti dei clienti, prodotti, abbonamenti e webhook. Il template React non include route API.
• Hook: un hook React useBilling per le operazioni di fatturazione, per React e Next.js.
• File della libreria: la configurazione del client Dodo Payments e le funzioni helper, in lib/dodopayments.ts.
• Configurazione dell’ambiente: un file di ambiente di esempio, .env.example.

​

Struttura di esempio per Next.js

your-project/
├── app/api/
│   ├── 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 dell’ambiente

# 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

​

Componenti disponibili

• Tabelle dei prezzi: otto varianti, da pricing-table-one a pricing-table-eight, per visualizzare i prezzi dei prodotti.
• Gestione degli abbonamenti: subscription-management, oltre a card e dialog per annullare un abbonamento o aggiornare un piano.
• Monitoraggio dell’utilizzo: contatori di utilizzo circolari e lineari e tabelle di utilizzo per la fatturazione basata sull’utilizzo.
• Componenti di checkout: un selettore del metodo di pagamento, form dei dettagli di pagamento e una card per i pagamenti non riusciti.
• Customer Portal: impostazioni di fatturazione, schermata di fatturazione, cronologia delle fatture e addebiti imminenti, per consentire ai clienti di gestire autonomamente il servizio.

​

Open source

• Trasparenza: puoi leggere come funziona ogni componente.
• Community: gli sviluppatori lo realizzano per altri sviluppatori.
• Sicurezza: chiunque può esaminare il codice alla ricerca di problemi di sicurezza.
• Innovazione: i contributi della community accelerano lo sviluppo.

​

Ricevere assistenza

• Issue su GitHub: Apri una issue
• Documentazione: visita billingsdk.com/docs
• Documentazione completa per LLM: billingsdk.com/llms-full.txt

​

Contribuire

• Segnalare bug
• Richiedere funzionalità
• Inviare pull request
• Aggiungere nuovi componenti
• Migliorare la documentazione

​

Approfondisci