Sign inGet Started

Billing & penggunaan

Billing berskala organisasi: paket, wallet, dan aliran invoice Anda milik organisasi. Halaman ini membahas bagaimana billing memengaruhi integrasi: bagaimana penggunaan diukur, cara membaca gambaran terkini, dan bagaimana tier paket Anda menentukan batas operasional yang berlaku bagi integrasi Anda. Untuk operasi akun (detail harga, metode pembayaran, pajak), lihat Knowledge base: Paket & harga dan Penggunaan, pengeluaran & invoice.
Billing dikelola oleh orang, bukan oleh integrasi. Setiap operasi billing dibatasi oleh scope org:billing, yaitu scope peran organisasi yang tidak dapat diberikan ke kunci API workspace, sehingga tidak ada kunci bk_* yang dapat membaca penggunaan, mengisi ulang wallet, atau mengubah paket. Owner dan admin billing melakukan pekerjaan tersebut di bagian Billing and payments pada dashboard; lihat Users, teams & roles untuk mengetahui siapa yang memegang peran tersebut. Katalog paket, produk, dan harga adalah pengecualian: katalog ini tidak memerlukan autentikasi, mempublikasikan harga di situs ini, dan CLI serta MCP dapat membaca katalog paket secara langsung. Oleh karena itu, panduan ini menjelaskan dampak billing terhadap integrasi Anda, dan menyebutkan halaman dashboard yang menampilkan setiap angka. Halaman-halaman tersebut (Overview, Usage, Invoices, Spend, dan Settings) dibahas dalam artikel Knowledge base yang ditautkan di sepanjang halaman ini.

Paket dan tier

Organisasi Anda berlangganan satu paket. Langganan aktif, upgrade, dan pembatalan Anda tersedia di Billing overview. Setiap paket memiliki tier (free, startup, growth, atau enterprise), dan tier inilah yang memengaruhi integrasi Anda secara operasional:
  • Volume pengiriman yang disertakan. Setiap paket menyertakan kuota bulanan pengiriman email, diukur per penerima: pesan ke tiga penerima mengonsumsi tiga. Pada paket berbayar, pengiriman melebihi kuota diukur sebagai overage hingga batas atas; melewati batas atas, pengiriman ditolak dengan error limit sampai periode direset. Paket Free tidak memiliki overage sama sekali: pengiriman berhenti di batas bulanan dan hariannya. Kuota, batas, dan batas atas overage ada di Paket & harga.
  • Batas rate-limit meningkat sesuai paket. Rate limit dimulai dari nilai dasar, paket Anda menggantinya dengan nilai lebih tinggi, dan override per organisasi menggantikan keduanya, sehingga paket yang lebih tinggi menaikkan batas pengiriman dan pembacaan. Model, rate dasar setiap grup, dan header-nya dijelaskan di Rate limit.
  • Batas resource. Batas seperti jumlah sending domain, IP pool, dan dedicated IP yang dapat dimiliki organisasi Anda ditetapkan per paket dan dapat disesuaikan per organisasi. Jika Anda mencapai salah satunya, hubungi support daripada mencari solusi sendiri.
Upgrade berlaku segera, membuat seluruh kuota baru tersedia untuk sisa periode berjalan. Downgrade dan pembatalan berlaku di akhir periode billing berjalan. Lihat Perubahan paket & perpanjangan untuk urutan pembayaran gagal dan aturan waktu lainnya. Rancang integrasi untuk menangani error saat akun melebihi kuotanya.

Pengukuran penggunaan

Setiap pengiriman diukur terhadap periode billing aktif organisasi Anda. Halaman Usage di dashboard menampilkan gambaran langsung untuk setiap produk, dalam jendela waktu pengukuran produk tersebut: periode paket untuk email terukur, bulan kalender untuk bayar-sesuai-pemakaian. Produk ditagih dengan salah satu dari dua cara, dan perbedaannya terasa pada integrasi Anda:
  • Produk terukur memiliki kuota yang disertakan dalam paket Anda (pengiriman email). Halaman ini menampilkan berapa banyak kuota yang telah Anda gunakan dan seberapa jauh Anda melampauinya, sehingga Anda dapat melihat kelebihan pemakaian yang menumpuk sebelum ditagih.
  • Produk bayar-sesuai-pemakaian ditagih per penggunaan berdasarkan kartu tarif (SMS, WhatsApp). Satu pesan dapat mendebit wallet dua kali: biaya Bird sendiri saat pengiriman diproses, dan biaya pihak ketiga (surcharge operator pada SMS, bagian Meta pada WhatsApp) saat pesan terkirim. Baca rincian biaya per pesan dari cost pada pesan SMS atau WhatsApp: transaction_amount adalah biaya Bird dan passthrough_amount adalah biaya pihak ketiga.
Halaman ini mencakup setiap produk yang memiliki langganan atau penggunaan dalam periode berjalan, dan menampilkan grafik pemecahan per hari, per negara, dan per domain pengirim untuk setiap produk.
Halaman Usage di dashboard Bird: total pengeluaran dengan proyeksi, jumlah pengiriman per kanal, dan grafik penggunaan harian

Wallet

Setiap organisasi memiliki wallet: saldo prabayar bersama yang dilalui oleh setiap tagihan. Perpanjangan paket, kelebihan pemakaian, dan pengiriman bayar-sesuai-pemakaian semuanya mendebit wallet; kartu tersimpan berfungsi untuk mengisinya (top-up, auto top-up, dan menutupi perpanjangan yang tidak tercukupi oleh saldo). Halaman Spend di dashboard adalah buku besar lengkap kredit dan tagihan, sehingga setiap pergerakan wallet tercatat di satu tempat, dan setiap pembayaran top-up yang telah diselesaikan menghasilkan tanda terima permanen yang dapat Anda unduh sebagai PDF dari bagian yang sama.
Secara operasional, wallet adalah dependensi pengiriman bayar-sesuai-pemakaian: pengiriman SMS dan WhatsApp ditolak jika saldo tidak dapat menutupinya. SMS ditolak di API dengan 402; pengiriman WhatsApp diterima lalu ditolak setelah Bird mencoba menagihnya. Biaya saat pengiriman yang tidak dapat ditanggung saldo akan dilewati alih-alih ditolak, sehingga pesan tetap sampai ke penerima. Untuk volume transaksional, konfigurasikan auto top-up dan peringatan saldo rendah di Billing overview, atau pantau dan buat peringatan dari sisi Anda. Payment methods and wallet membahas kedua kontrol dashboard tersebut. Peringatan saldo rendah dan pemberitahuan kegagalan pembayaran dikirim ke owner organisasi. Email invoice dikirim ke daftar notifikasi billing organisasi jika sudah diatur, dan dialihkan ke owner organisasi jika belum. Atur daftar tersebut di Settings > Organization. Gunakan alias tim yang terpantau agar email billing tidak bergantung pada kotak masuk satu orang.

Invoice

Invoice diterbitkan per organisasi, satu per bulan kalender, dan tercantum di halaman Invoices pada dashboard, tempat Anda dapat membuka satu invoice untuk melihat rincian pos atau mengunduhnya sebagai PDF. Invoice mencerminkan pengukuran yang sama dengan yang ditampilkan halaman Usage: biaya berulang paket Anda ditambah kelebihan pemakaian terukur dan pengeluaran bayar-sesuai-pemakaian untuk periode tersebut. Untuk struktur invoice, status, dan waktu pembayaran, lihat Usage, spend & invoices di Knowledge base.

Langkah selanjutnya

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Dapatkan ringkasan implementasi