Panduan Event Webhook - Dodo Payments Documentation

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.

​Event Pembayaran

​Event Pengembalian Dana

​Event Sengketa

​Event Langganan

​Event Kunci Lisensi

​Event Pemberian Hak

​Event Kredit

​Event Pemulihan

​Event Penagihan