License Keys
Digital Delivery
Payment Webhooks
Refunds API
Apa Itu Pembayaran Sekali?
Pembayaran sekali bayar adalah pembelian di muka dengan harga tetap yang ideal untuk:- Lisensi software: Akses seumur hidup atau pembukaan versi utama.
- Unduhan digital: E-book, template, grafik, atau plugin.
- Layanan: Audit, paket onboarding, atau konsultasi satu kali.
- Kursus dan tiket: Kursus, lokakarya, atau sesi langsung.
Manfaat Utama
- Checkout sederhana: Tanpa perpanjangan atau logika prorata.
- Pemenuhan instan: Kirim lisensi atau file segera.
- Harga fleksibel: Mendukung diskon dan pajak.
- Berorientasi developer: API yang jelas untuk pembuatan, pengembalian dana, dan webhook.
Membuat Produk Sekali
Buat produk di dasbor Dodo Payments Anda, lalu jual melalui checkout yang dihosting, tautan pembayaran, atau API Anda.
Konfigurasi Produk
Konfigurasikan bidang di dasbor untuk mendefinisikan bagaimana produk Anda muncul dan dijual.Detail Produk
- Nama Produk (wajib): Nama tampilan yang ditampilkan di checkout dan invoice.
- Deskripsi Produk: Pernyataan nilai yang jelas dan dilihat pelanggan sebelum membayar.
- Gambar Produk: PNG, JPG, atau WebP hingga 3 MB.
- Brand: Kaitkan produk dengan brand tertentu untuk pengaturan tema dan email.
- Kategori Pajak (wajib): Pilih kategori yang tepat untuk menentukan aturan pajak.
Harga
- Jenis Harga: Pilih Sekali Waktu.
- Harga (wajib): Biaya tetap dengan mata uang.
- Diskon yang Berlaku (%): Diskon persentase opsional yang ditampilkan saat checkout dan pada invoice. Anda dapat memasukkan hingga dua angka desimal, seperti
10.5. Di API, gunakandiscount_bps(basis poin, sehingga1050adalah 10,5%).
Pengaturan Lanjutan
Pengaturan opsional ini terdapat di bagian Pricing, Entitlements, dan Meta Data pada formulir produk:- Tax Inclusive Pricing (di Pricing): Tampilkan harga yang sudah termasuk pajak yang berlaku.
- License key (di Entitlements): Terbitkan kunci unik setelah pembelian. Lihat License Keys.
- Digital Files (di Entitlements): Kirimkan file atau konten secara otomatis. Lihat Digital Product Delivery.
- Meta Data: Lampirkan pasangan nilai kunci khusus untuk penandaan internal atau integrasi. Lihat Metadata.
Manajemen API
Create Payments
Create Payments
Gunakan
POST /checkouts untuk membuat sesi checkout yang mengumpulkan pembayaran sekali bayar untuk produk Anda.API Reference
Refund Payments
Refund Payments
Gunakan
POST /refunds untuk membuat pengembalian dana penuh atau sebagian.API Reference
List and Retrieve Payments
List and Retrieve Payments
Gunakan
GET /payments untuk mencantumkan pembayaran dan GET /payments/{payment_id} untuk mengambil salah satunya. Ambil item baris dengan GET /payments/{payment_id}/line-items.List Payments
Get Payment Detail
Retrieve Line Items
Payment Webhooks
Payment Webhooks
Tanggapi event seperti payment.succeeded atau payment.failed di backend Anda.
Webhook Guide
Kasus Penggunaan Umum
- Alat berbasis lisensi: Buka fitur dengan kunci sekali bayar.
- Aset digital: Tema, template, set ikon, atau media.
- Layanan profesional: Implementasi atau penyiapan dengan biaya tetap.
- Pendidikan: Tiket kursus dan lokakarya satu kali.
Contoh Integrasi
Sesi Checkout (Pembayaran Tunggal)
Buat sesi checkout dengan produk sekali bayar di keranjang:Praktik Terbaik
- Perjelas hasil yang diterima: Beri tahu pembeli dengan tepat apa yang mereka dapatkan dan bagaimana cara pengirimannya.
- Kirim secara instan: Gunakan kunci lisensi atau pengiriman digital untuk akses segera.
- Lacak dengan metadata: Simpan ID Anda agar pencocokan lebih mudah.