Langsung ke konten utama
Billing SDK adalah solusi open-source yang komprehensif yang menyediakan infrastruktur penagihan lengkap untuk aplikasi web modern. Ini mencakup komponen React, alat CLI, dan dukungan integrasi full-stack untuk berbagai framework dengan Dodo Payments.

​
Ikhtisar

Billing SDK menawarkan:
  • Komponen React: Komponen penagihan yang sudah dibangun sebelumnya dan dapat disesuaikan untuk aplikasi React
  • Alat CLI: Antarmuka baris perintah untuk inisialisasi proyek dan manajemen komponen
  • Dukungan Framework: Integrasi dengan Next.js, Express.js, Hono, Fastify, dan React
  • Penyedia Pembayaran: Integrasi penuh dengan Dodo Payments

​
Memulai dengan Cepat

Mulai dengan Billing SDK dalam beberapa menit:
1

Instal CLI

Gunakan npx untuk menjalankan CLI tanpa instalasi:
npx @billingsdk/cli --help
Atau instal secara global untuk penggunaan yang sering:
npm install -g @billingsdk/cli
2

Inisialisasi Proyek

Jalankan pengaturan interaktif untuk membuat proyek penagihan baru:
npx @billingsdk/cli init
Anda akan diminta untuk memilih:
  • Framework pilihan Anda (Next.js, Express.js, Hono, Fastify, React)
  • Penyedia pembayaran Anda (Dodo Payments)
3

Tambahkan Komponen

Tambahkan komponen penagihan individu ke proyek Anda:
npx @billingsdk/cli add pricing-table-one
npx @billingsdk/cli add subscription-management

​
Framework yang Didukung

Billing SDK mendukung berbagai framework dengan integrasi Dodo Payments yang komprehensif:
FrameworkDodo Payments
Next.js✅ Ya
Express.js✅ Ya
Hono✅ Ya
React✅ Ya
Fastify✅ Ya

​
Perintah CLI

​
@billingsdk/cli init

Inisialisasi proyek penagihan baru dengan pengaturan lengkap termasuk konfigurasi framework, integrasi Dodo Payments, dan dependensi penting. Apa yang dilakukan:
  1. Pemilihan Framework: Pilih framework pilihan Anda
  2. Instalasi Template: Mengunduh dan menginstal template spesifik framework dengan integrasi Dodo Payments
  3. Manajemen Dependensi: Secara otomatis menginstal dependensi yang diperlukan
  4. Generasi File: Membuat file konfigurasi dan kode boilerplate yang diperlukan
Contoh: 
npx @billingsdk/cli init

​
@billingsdk/cli add

Tambahkan komponen penagihan individu ke proyek yang sudah ada menggunakan sistem registri shadcn/ui. Contoh: 
# 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
Apa yang terjadi:
  1. Mengunduh konfigurasi komponen dari registri
  2. Menginstal file komponen di direktori components/billingsdk/ Anda
  3. Memperbarui konfigurasi proyek Anda jika diperlukan
  4. Menginstal dependensi tambahan

​
Struktur File yang Dihasilkan

Setelah menjalankan init, Anda akan mendapatkan struktur proyek lengkap dengan:
  • Rute API: Titik akhir komprehensif untuk checkout, pelanggan, produk, langganan, dan webhook
  • Hooks: React hooks untuk operasi penagihan (jika menggunakan React/Next.js)
  • File Perpustakaan: Inisialisasi klien penyedia pembayaran dan utilitas
  • Konfigurasi Lingkungan: Contoh file variabel lingkungan

​
Contoh Struktur 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

​
Konfigurasi Lingkungan

Konfigurasikan variabel lingkungan Anda setelah inisialisasi: 
# 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
Selalu simpan kunci API Anda dengan aman menggunakan variabel lingkungan. Jangan pernah mengkomitnya ke kontrol versi.

​
Komponen yang Tersedia

Billing SDK menyediakan koleksi komprehensif komponen React:
  • Tabel Harga: Beberapa varian untuk menampilkan harga produk
  • Manajemen Langganan: Komponen untuk mengelola langganan pelanggan
  • Pemantauan Penggunaan: Komponen visual untuk melacak penagihan berbasis penggunaan
  • Komponen Checkout: Alur checkout yang sudah dibangun sebelumnya
  • Portal Pelanggan: Komponen untuk layanan mandiri pelanggan

​
Open Source

Billing SDK dibangun berdasarkan prinsip open-source:
  • 🔍 Transparansi: Visibilitas penuh tentang cara kerja komponen
  • 🤝 Komunitas: Dibangun oleh pengembang, untuk pengembang
  • 🔒 Keamanan: Kode terbuka berarti keamanan yang lebih baik melalui tinjauan sejawat
  • 📈 Inovasi: Iterasi lebih cepat melalui kontribusi komunitas
Billing SDK dirilis di bawah Lisensi Umum GNU (GPL), memastikan proyek tetap terbuka dan gratis.

​
Mendapatkan Bantuan

Butuh bantuan dengan Billing SDK?

​
Berkontribusi

Kami menyambut kontribusi! Lihat panduan kontribusi kami untuk detail tentang:
  • Melaporkan bug
  • Meminta fitur
  • Mengajukan permintaan tarik
  • Menambahkan komponen baru
  • Meningkatkan dokumentasi

​
Pelajari Lebih Lanjut

Dokumentasi Lengkap

Panduan lengkap untuk Billing SDK dengan contoh dan praktik terbaik

Referensi CLI

Dokumentasi CLI terperinci untuk semua perintah dan opsi

Perpustakaan Komponen

Telusuri semua komponen yang tersedia dengan contoh langsung