Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Dodo Payments menyediakan notifikasi webhook waktu nyata untuk menjaga Anda tetap terinformasi tentang peristiwa penting terkait transaksi, langganan, pengembalian dana, sengketa, dan manajemen kunci lisensi. Berikut adalah panduan terperinci tentang peristiwa ini, dikategorikan untuk kejelasan, bersama dengan tips dan pertimbangan implementasi.
Event Pembayaran
| Nama Acara | Jenis Acara | Deskripsi |
|---|
| Payment Succeeded | payment.succeeded | Dipicu ketika pembayaran berhasil diproses. |
| Payment Failed | payment.failed | Terjadi ketika upaya pembayaran gagal karena kesalahan, kartu ditolak, atau masalah lainnya. |
| Payment Processing | payment.processing | Menunjukkan bahwa pembayaran sedang diproses. |
| Payment Cancelled | payment.cancelled | Dipicu ketika pembayaran dibatalkan sebelum selesai. |
Event Pengembalian Dana
| Nama Acara | Jenis Acara | Deskripsi |
|---|
| Refund Succeeded | refund.succeeded | Dipicu ketika pengembalian dana berhasil diproses. |
| Refund Failed | refund.failed | Terjadi ketika upaya pengembalian dana gagal karena kesalahan pemrosesan atau masalah lainnya. |
Event Sengketa
| Nama Acara | Jenis Acara | Deskripsi |
|---|
| Dispute Opened | dispute.opened | Dipicu ketika pelanggan memulai sengketa. |
| Dispute Expired | dispute.expired | Menunjukkan bahwa sengketa telah kedaluwarsa tanpa penyelesaian. |
| Dispute Accepted | dispute.accepted | Dipicu ketika pedagang menerima sengketa. |
| Dispute Cancelled | dispute.cancelled | Terjadi ketika sengketa dibatalkan oleh pelanggan atau sistem. |
| Dispute Challenged | dispute.challenged | Dipicu ketika pedagang menentang sengketa. |
| Dispute Won | dispute.won | Menunjukkan bahwa pedagang berhasil memenangkan sengketa. |
| Dispute Lost | dispute.lost | Terjadi ketika pedagang kalah dalam sengketa. |
Event Langganan
| Nama Acara | Jenis Acara | Deskripsi |
|---|
| Subscription Active | subscription.active | Menunjukkan bahwa langganan sekarang aktif dan tagihan berulang dijadwalkan. |
| Subscription Updated | subscription.updated | Dipicu ketika ada pembaruan pada bidang langganan apa pun (sinkronisasi waktu nyata tanpa polling). |
| Subscription On Hold | subscription.on_hold | Dipicu ketika langganan sementara ditangguhkan karena gagal perpanjangan. |
| Subscription Renewed | subscription.renewed | Terjadi ketika langganan berhasil diperpanjang. |
| Subscription Plan Changed | subscription.plan_changed | Dipicu ketika langganan ditingkatkan, diturunkan, atau dimodifikasi dengan addon berbeda. |
| Subscription Cancelled | subscription.cancelled | Dipicu ketika langganan dibatalkan oleh pedagang atau pelanggan. |
| Subscription Failed | subscription.failed | Menunjukkan langganan gagal. Ini berarti kami tidak dapat membuat mandat. |
| Subscription Expired | subscription.expired | Dipicu ketika langganan mencapai akhir masa berlakunya dan kedaluwarsa. |
Event Kunci Lisensi
| Nama Acara | Jenis Acara | Deskripsi |
|---|
| License Key Created | license_key.created | Dipicu ketika kunci lisensi baru dibuat untuk produk. |
Event Pemberian Hak
| Nama Event | Tipe Event | Deskripsi |
|---|
| Grant Created | entitlement_grant.created | Pemberian hak baru diberikan untuk pelanggan. Pemberian kunci lisensi tiba delivered; pemberian berbasis OAuth (Discord, GitHub, Notion) tiba pending. |
| Grant Delivered | entitlement_grant.delivered | Pemenuhan pemberian selesai — kunci lisensi diterbitkan, tautan file diselesaikan, atau akses platform diberikan. |
| Grant Failed | entitlement_grant.failed | Pemenuhan pemberian gagal; periksa error_code dan error_message. |
| Grant Revoked | entitlement_grant.revoked | Akses ditarik; periksa revocation_reason (status langganan, pengembalian dana, perubahan paket, atau manual). |
Untuk skema payload yang terperinci, sampel event, dan referensi lengkap revocation_reason, lihat Webhook Pemberian Hak.
Event Kredit
| Nama Event | Tipe Event | Deskripsi |
|---|
| Credit Added | credit.added | Dipicu ketika kredit diberikan kepada pelanggan (langganan, satu kali, tambahan, atau API). |
| Credit Deducted | credit.deducted | Terjadi ketika kredit digunakan melalui penggunaan atau debet manual. |
| Credit Expired | credit.expired | Dipicu ketika kredit yang tidak digunakan kedaluwarsa setelah periode kedaluwarsa yang dikonfigurasi. |
| Credit Rolled Over | credit.rolled_over | Terjadi ketika kredit yang tidak digunakan dibawa ke depan ke pemberian baru pada akhir siklus. |
| Rollover Forfeited | credit.rollover_forfeited | Dipicu ketika kredit hangus karena batas rollover maksimum tercapai. |
| Overage Charged | credit.overage_charged | Terjadi ketika biaya kelebihan dikenakan karena penggunaan di luar saldo nol. |
| Manual Adjustment | credit.manual_adjustment | Dipicu ketika penyesuaian kredit atau debet manual dilakukan. |
| Balance Low | credit.balance_low | Dipicu ketika saldo kredit turun di bawah ambang batas yang dikonfigurasi. |
Event Pemulihan
| Nama Event | Tipe Event | Deskripsi |
|---|
| Abandoned Checkout Detected | abandoned_checkout.detected | Dipicu ketika checkout yang tidak selesai atau gagal terdeteksi setelah 60 menit. |
| Abandoned Checkout Recovered | abandoned_checkout.recovered | Terjadi ketika pelanggan menyelesaikan pembayaran melalui tautan pemulihan. |
Untuk skema payload yang terperinci, deskripsi field, dan contoh handler, lihat Recovery Webhooks.
Event Penagihan
| Nama Event | Tipe Event | Deskripsi |
|---|
| Dunning Started | dunning.started | Dipicu ketika upaya penagihan dimulai untuk langganan yang tertahan atau dibatalkan. |
| Dunning Recovered | dunning.recovered | Terjadi ketika pelanggan memperbarui metode pembayaran mereka dan tagihan yang dihasilkan berhasil. |
Untuk skema payload yang terperinci, deskripsi bidang, dan contoh handler, lihat Webhook Pemulihan.
Event webhook ini dirancang untuk memberikan pembaruan kritis kepada merchant agar dapat mengelola operasinya secara efektif. Implementasikan handler yang kuat untuk setiap event yang relevan dalam integrasi webhook Anda guna memastikan fungsionalitas yang lancar dan andal.