Panduan Event Webhook

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 Event	Tipe Event	Deskripsi
Subscription Aktif	`subscription.active`	Menunjukkan bahwa subscription kini aktif dan tagihan berulang telah dijadwalkan.
Subscription Diperbarui	`subscription.updated`	Dipicu ketika bidang subscription apa pun diperbarui (sinkronisasi real-time tanpa polling).
Subscription Ditangguhkan	`subscription.on_hold`	Dipicu ketika subscription ditangguhkan sementara karena perpanjangan gagal.
Subscription Dijeda	`subscription.paused`	Dipicu ketika subscription dijeda.
Subscription Dilanjutkan	`subscription.unpaused`	Dipicu ketika subscription yang dijeda dilanjutkan kembali.
Subscription Diperpanjang	`subscription.renewed`	Terjadi ketika subscription berhasil diperpanjang.
Paket Subscription Diubah	`subscription.plan_changed`	Dipicu ketika subscription di-upgrade, di-downgrade, atau diubah dengan addon yang berbeda.
Metode Pembayaran Subscription Diperbarui	`subscription.update_payment_method`	Dikirim ketika metode pembayaran subscription diperbarui. Membawa payload Subscription.
Subscription Dibatalkan	`subscription.cancelled`	Dipicu ketika subscription dibatalkan oleh merchant atau customer.
Subscription Gagal	`subscription.failed`	Menunjukkan subscription yang gagal. Artinya, kami tidak dapat membuat mandate.
Subscription Kedaluwarsa	`subscription.expired`	Dipicu ketika subscription 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 Payout

Event ini melacak perpindahan dana Anda dari Dodo Payments ke rekening bank, dengan mencerminkan status payout yang ditampilkan di dashboard. Payload-nya adalah objek payout dengan struktur yang sama seperti entri dari GET /payouts.

Nama Event	Jenis Event	Deskripsi
Payout Created	`payout.created`	Dipicu saat payout dibuat, baik oleh siklus payout otomatis maupun di luar siklus.
Payout In Progress	`payout.in_progress`	Terjadi saat tanggal jatuh tempo payout tiba dan payout mulai diproses.
Payout On Hold	`payout.on_hold`	Dipicu saat payout dijeda atau ditempatkan dalam peninjauan.
Payout Successful	`payout.success`	Terjadi saat payout ke rekening bank Anda berhasil diproses.
Payout Failed	`payout.failed`	Dipicu saat payout gagal. Dana dan biaya dikreditkan kembali ke wallet Anda.

Jangan mengasumsikan bahwa event payout bersifat final atau selalu berurutan. payout.failed dapat tiba secara valid setelah payout.success ketika bank mengembalikan transfer, dan payout.success dapat tiba setelah payout.failed ketika payout yang gagal kemudian dipulihkan. Selalu perlakukan status pada payload sebagai keadaan saat ini.

payout.created sebelumnya dikirim sebagai payout.not_initiated. Jika Anda memiliki endpoint yang sudah ada dan memfilter pada payout.not_initiated, perbarui filter tersebut ke payout.created agar tetap cocok.

Untuk skema payload yang terperinci, deskripsi field, dan contoh handler, lihat Payout Webhooks. Event webhook ini dirancang untuk memberikan pembaruan penting kepada merchant agar dapat mengelola operasional secara efektif. Implementasikan handler yang tangguh untuk setiap event yang relevan dalam integrasi webhook Anda guna memastikan fungsionalitas yang lancar dan andal.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Event Pembayaran

Event Pengembalian Dana

Event Sengketa

Event Langganan

Event Kunci Lisensi

Event Pemberian Hak

Event Kredit

Event Pemulihan

Event Penagihan

Event Payout

​Event Pembayaran

​Event Pengembalian Dana

​Event Sengketa

​Event Langganan

​Event Kunci Lisensi

​Event Pemberian Hak

​Event Kredit

​Event Pemulihan

​Event Penagihan

​Event Payout

Event Pembayaran

Event Pengembalian Dana

Event Sengketa

Event Langganan

Event Kunci Lisensi

Event Pemberian Hak

Event Kredit

Event Pemulihan

Event Penagihan

Event Payout