Skip to main content
Agar coding agent Anda menulis integrasinya, instal Dodo Agent Plugin. Plugin ini menambahkan skill Dodo Payments dan server MCP ke Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro, dan OpenCode.
Anda akan membuat aplikasi chat AI yang menagih pelanggan untuk token yang mereka gunakan. Anda membuat meter penagihan, produk, dan kode aplikasi yang menjalankan percakapan serta melaporkan penggunaan token saat berlangsung.
Tutorial ini membuat aplikasi lengkap dengan backend dan frontend. Aplikasi chat menggunakan Google Gemini, dan LLM Blueprint melaporkan penggunaan token untuk setiap respons, sehingga Anda tidak perlu menghitung token sendiri.
Setelah selesai, Anda akan memiliki aplikasi chat yang:
  • Menjalankan percakapan AI dengan Google Gemini melalui AI SDK.
  • Melacak penggunaan token secara otomatis tanpa kode penghitung.
  • Menagih pelanggan untuk token yang benar-benar mereka gunakan.
  • Menyertakan antarmuka chat yang menyimpan riwayat percakapan.
Antarmuka chat dari aplikasi chat AI yang telah selesai, menampilkan percakapan dengan jumlah token di bawah setiap respons

Apa yang Akan Kita Bangun

Layanan chat bekerja seperti ini:
  • Service: Chat AI dengan Google Gemini melalui AI SDK
  • Pricing Model: Bayar per token ($0.01 per 1.000 token)
  • Free Tier: 10.000 token gratis per pelanggan per bulan
  • Features: Riwayat percakapan dan pelacakan token otomatis
Sebelum memulai, Anda memerlukan:

Langkah 1: Buat Usage Meter Anda

Buat meter di dashboard Dodo Payments untuk melacak penggunaan token AI.
Yang akan Anda buat: Meter bernama โ€œAI Token Usage Meterโ€ yang menjumlahkan token yang digunakan dalam percakapan chat.
1

Open the Meters Section

  1. Masuk ke dashboard Dodo Payments.
  2. Klik Products di sidebar.
  3. Klik Meters.
  4. Klik Create Meter.
Halaman Meters di dashboard Dodo Payments dengan tombol Create Meter
Form meter akan terbuka.
2

Enter the Meter Details

Masukkan detail untuk layanan chat:Meter Name โ†’ AI Token Usage MeterDescription โ†’ Tracks token consumption from AI chat conversations using AI SDKEvent Name โ†’ ai_chat_usage
Nama event ai_chat_usage harus sesuai dengan nama event yang dikirim oleh kode aplikasi. Nama event peka huruf besar-kecil.
3

Configure How Tokens Are Counted

Atur agregasi, yang menentukan cara meter menggabungkan event:Aggregation Type: SumOver Property: totalTokensMeasurement Unit: tokens
Sum menjumlahkan token dari setiap pesan chat. LLM Blueprint mengirim inputTokens, outputTokens, dan totalTokens dalam metadata setiap event, dan meter ini menjumlahkan totalTokens.
4

Create the Meter

  1. Pastikan setiap pengaturan sesuai dengan nilai di atas. Anda tidak dapat mengedit meter setelah membuatnya.
  2. Klik Create Meter.
Form meter yang diisi dengan nama AI Token Usage Meter, event ai_chat_usage, dan agregasi Sum
Meter dibuat. โ€œAI Token Usage Meterโ€ siap menghitung token. Selanjutnya, hubungkan meter tersebut ke produk penagihan.

Langkah 2: Dapatkan API Key Anda

Kumpulkan dua kunci API yang diperlukan aplikasi.
1

Get a Dodo Payments API Key

  1. Di dashboard Dodo Payments, buka Developer โ†’ API Keys.
  2. Klik Add API Key.
  3. Salin kunci API.
Buat kunci dalam test mode: kunci test mode hanya berfungsi dengan test mode. Anda menambahkan kunci tersebut ke file .env pada Langkah 5.
2

Get a Google AI API Key

  1. Buka aistudio.google.com.
  2. Klik Get API Key.
  3. Buat kunci API atau gunakan kunci yang sudah ada.
  4. Salin kuncinya.
Jaga kerahasiaan kunci ini. Anda menambahkannya ke file .env pada Langkah 5.

Langkah 3: Buat Produk Penagihan Anda

Buat produk yang menentukan harga: $0.01 per 1.000 token, dengan 10.000 token gratis. Produk ini menghubungkan meter ke penagihan.
Yang akan Anda buat: Produk bernama โ€œAI Chat Serviceโ€ yang menagih penggunaan token di atas batas gratis.
1

Navigate to Products

  1. Di dashboard Dodo Payments, klik Products di sidebar.
  2. Klik Add Product.
  3. Pada Pricing Type, pilih Usage Based Billing.
Dengan jenis harga ini, Dodo Payments menagih berdasarkan penggunaan meter, bukan harga subscription tetap.
2

Enter Product Details

Isi detail yang diperlukan:Product Name: โ†’ AI Chat ServiceDescription: โ†’ AI-powered chat service with automatic token-based billingProduct Image: Unggah gambar yang relevan.
Nama dan deskripsi akan muncul pada invoice pelanggan.
3

Connect Your Meter

Pastikan jenis harga produk adalah Usage Based Billing.Atur Price ke 0 agar pelanggan hanya membayar penggunaan, tanpa biaya dasar.Selanjutnya, tautkan meter yang telah Anda buat:
  1. Gulir ke bagian Associated Meters.
  2. Klik Add meters.
  3. Pilih โ€œAI Token Usage Meterโ€ dari dropdown.
  4. Pastikan meter muncul dalam konfigurasi produk.
Meter telah terhubung ke produk.
4

Set Your Pricing

Tentukan harga per token dan batas gratis:Price per unit: โ†’ 0.00001. Itu berarti $0.00001 per token, atau $0.01 per 1.000 token.Free Threshold: โ†’ 10000. Setiap pelanggan mendapatkan 10.000 token gratis per bulan.
Harga meter pada produk AI Chat Service, dengan harga per unit dan batas gratis yang telah diisi
Cara kerja penagihan: Pelanggan yang menggunakan 25.000 token dalam sebulan membayar 15.000 token (25.000 โˆ’ 10.000 gratis). 15.000 ร— $0.00001 = $0.15.
5

Save Your Product

  1. Tinjau pengaturan:
    • Nama: AI Chat Service
    • Meter: AI Token Usage Meter
    • Harga: $0.01 per 1.000 token
    • Batas gratis: 10.000 token
  2. Klik Save Changes.
Produk dibuat. Penagihan telah dikonfigurasi, dan pelanggan akan ditagih untuk token yang mereka gunakan.

Langkah 4: Lakukan Pembelian Uji Coba

Buat pelanggan pengujian dengan membeli produk. Aplikasi akan mengirim event penggunaan untuk pelanggan ini.
1

Get Your Payment Link

  1. Di dashboard Dodo Payments, buka Products.
  2. Cari produk โ€œAI Chat Serviceโ€.
  3. Klik Share di samping produk.
  4. Salin payment link.
2

Complete a Test Purchase

  1. Buka payment link di tab browser baru.
  2. Masukkan detail pembayaran pengujian dan selesaikan pembelian.
Setelah pembayaran berhasil, pembelian akan membuat pelanggan. Kode aplikasi menggunakan ID pelanggan tersebut.
3

Find Your Customer ID

  1. Kembali ke dashboard Dodo Payments.
  2. Buka Sales โ†’ Customers di sidebar.
  3. Cari pelanggan yang Anda buat berdasarkan alamat email pengujiannya.
  4. Salin customer ID. ID tersebut dimulai dengan cus_.
Simpan customer ID ini. Anda akan menggunakannya saat menguji aplikasi chat.

Langkah 5: Bangun Aplikasi Chat

Setelah penagihan siap dan pelanggan pengujian dibuat, bangun aplikasi chat.
1

Set Up Your Project

Buat direktori dan inisialisasi proyek:
2

Install Dependencies

Instal package:
3

Configure TypeScript

Buat tsconfig.json:
tsconfig.json
Perbarui package.json untuk menambahkan module type dan scripts:
package.json
4

Create the Project Structure

Buat folder source dan static-file:
5

Set Up Environment Variables

Buat file .env di root proyek:
.env
Ganti nilai placeholder dengan kunci API dari Langkah 2. Provider Google untuk AI SDK membaca GOOGLE_GENERATIVE_AI_API_KEY secara default.
6

Create the Backend Server

Buat src/server.ts dan tempelkan kode server di bawah ini.
Server chat lengkap dengan penagihan, beserta .env dan package.json yang sesuai:

Langkah 6: Tambahkan Antarmuka Chat

Tambahkan antarmuka chat yang menyimpan seluruh riwayat percakapan. Buat public/index.html:
public/index.html

Langkah 7: Uji Aplikasi Chat Anda

Uji aplikasi chat secara menyeluruh dan pantau penggunaan sampai masuk ke Dodo Payments.
Yang Anda uji: Anda mengobrol dengan AI, memastikan event token sampai ke Dodo Payments, dan memeriksa perhitungan penagihan.
1

Start the Server

  1. Pastikan file .env memiliki kedua kunci API dari Langkah 2.
  2. Jalankan development server:
Log server:
Server sedang berjalan.
2

Open the Chat Interface

  1. Buka browser.
  2. Buka http://localhost:3000. Antarmuka chat akan dimuat.
Sebelum mengobrol, atur CUSTOMER_ID di server.ts ke customer ID pengujian dari Langkah 4, lalu mulai ulang server.
3

Have Your First Conversation

Kirim pesan berikut:
  1. โ€œApa itu kecerdasan buatan?โ€
  2. โ€œBagaimana cara kerja machine learning?โ€
  3. โ€œBisakah Anda menjelaskan neural network?โ€
Setiap respons menampilkan jumlah token yang digunakannya.
Jika AI merespons dan jumlah token muncul, aplikasi berfungsi.
4

Check Your Dodo Payments Dashboard

Pastikan Dodo Payments menerima event tersebut:
  1. Buka dashboard Dodo Payments.
  2. Buka Products โ†’ Meters dan buka AI Token Usage Meter.
  3. Pilih tab Events.
  4. Temukan event chat Anda dalam daftar.
Yang perlu dicari:
  • Nama event: ai_chat_usage
  • Customer ID: customer ID pengujian Anda
Tab Events pada AI Token Usage Meter yang menampilkan event ai_chat_usage
Daftar tersebut memiliki satu event untuk setiap pesan yang Anda kirim.
5

Verify Token Counting

Kirim beberapa pesan lagi, lalu periksa agregasinya:
  1. Di meter, pilih tab Customers.
  2. Cari pelanggan pengujian Anda.
  3. Periksa kolom Consumed Units. Kolom ini menampilkan total token yang digunakan.
Tab Customers pada meter yang menampilkan unit terpakai untuk pelanggan pengujian
Meter menjumlahkan nilai totalTokens dari setiap event.
6

Test the Free Tier

Gunakan token yang cukup untuk melewati batas gratis:
  1. Lakukan beberapa percakapan lagi sampai totalnya melewati sekitar 15.000 token.
  2. Buka kembali tab Customers pada meter.
  3. Periksa nilainya:
    • Consumed Units: 15.000+ token
    • Chargeable Units: 5.000 (10.000 token gratis diterapkan)
    • Total Price: ~$0.05
Tab Customers pada meter yang menampilkan unit terpakai, unit yang dapat ditagih, dan harga total setelah batas gratis
Penagihan berbasis penggunaan berfungsi. Pelanggan ditagih untuk token yang mereka gunakan.

Pemecahan Masalah

Masalah umum dan solusinya:
Kemungkinan penyebab:
  • Nama event tidak sama persis dengan konfigurasi meter
  • Customer ID tidak ada di akun Anda
  • Kunci API tidak valid atau sudah kedaluwarsa
  • Masalah konektivitas jaringan
Solusi:
  1. Pastikan nama event sama persis dengan meter. Nama ini peka huruf besar-kecil: ai_chat_usage.
  2. Pastikan customer ID ada di dashboard Dodo Payments.
  3. Uji kunci API dengan panggilan API sederhana.
  4. Periksa log server untuk mencari error.
Kemungkinan penyebab:
  • Model tidak mengembalikan informasi penggunaan
  • Versi SDK tidak sesuai
Solusi:
  1. Periksa apakah model mengembalikan penggunaan:
  1. Perbarui package Blueprints: npm install @dodopayments/ingestion-blueprints@latest
Kemungkinan penyebab:
  • Kunci API berasal dari mode lain.
  • File .env memiliki spasi atau tanda kutip tambahan.
Solusi:
  • Kunci hanya berfungsi dalam mode tempat kunci tersebut dibuat. Gunakan kunci test mode dengan DODO_PAYMENTS_ENVIRONMENT=test_mode, dan kunci live mode dengan live_mode.
  • Hapus tanda kutip di sekitar kunci dalam file .env.
  • Buat kunci baru jika diperlukan.
Butuh bantuan?

Selamat! Anda Telah Membuat Aplikasi Chat AI

Anda kini memiliki aplikasi chat AI yang berfungsi, melacak penggunaan token, dan menagih pelanggan melalui Dodo Payments.

Pelajari Lebih Lanjut

LLM Blueprint

Lacak penggunaan token LLM dengan LLM Ingestion Blueprint.

Ingestion Blueprints SDK

Lihat contoh lainnya di repositori GitHub.

Join Community

Dapatkan bantuan dan bagikan proyek Anda di Discord.
Terakhir diubah pada 26 September 2026