Panduan Webhook Events

Dodo Payments mengeluarkan webhook events pada setiap tahap siklus pembayaran, subscription, dispute, payout, credit, atau license key. Halaman ini mencantumkan setiap event berdasarkan resource. Untuk schema payload dan contoh handler yang lebih detail, lihat halaman khusus resource yang ditautkan di bawah.

Payment Events

Event	Dipicu ketika
`payment.succeeded`	Pembayaran berhasil diproses.
`payment.failed`	Upaya pembayaran gagal karena kartu ditolak, dana tidak mencukupi, atau error lainnya.
`payment.processing`	Pembayaran sedang diproses.
`payment.cancelled`	Pembayaran dibatalkan sebelum selesai.

Untuk schema payload lengkap, lihat Payment Webhooks.

Refund Events

Event	Dipicu ketika
`refund.succeeded`	Refund berhasil diproses.
`refund.failed`	Upaya refund gagal karena error pemrosesan atau masalah lainnya.

Untuk schema payload lengkap, lihat Refund Webhooks.

Dispute Events

Event	Dipicu ketika
`dispute.opened`	Pemegang kartu mengajukan dispute atas pembayaran.
`dispute.challenged`	Bukti telah dikirimkan untuk membantah dispute.
`dispute.accepted`	Dispute diterima tanpa dibantah.
`dispute.cancelled`	Dispute ditarik kembali atau dibatalkan.
`dispute.expired`	Batas waktu respons berlalu tanpa penyelesaian.
`dispute.won`	Dispute diselesaikan untuk kepentingan Anda.
`dispute.lost`	Dispute diselesaikan untuk kepentingan pemegang kartu.

Untuk schema payload dan contoh handler yang lebih detail, lihat Dispute Webhooks.

Subscription Events

Event	Dipicu ketika
`subscription.active`	Subscription berhasil diaktifkan dan recurring charges dijadwalkan.
`subscription.updated`	Field subscription apa pun berubah (sinkronisasi real-time tanpa polling).
`subscription.past_due`	Renewal gagal dan grace period dimulai; customer tetap memiliki akses hingga batas waktu.
`subscription.on_hold`	Subscription ditangguhkan sementara karena renewal gagal.
`subscription.paused`	Subscription dijeda.
`subscription.unpaused`	Subscription yang dijeda dilanjutkan kembali.
`subscription.renewed`	Subscription berhasil diperpanjang untuk periode billing berikutnya.
`subscription.plan_changed`	Subscription di-upgrade, di-downgrade, atau diubah dengan add-on yang berbeda.
`subscription.update_payment_method`	Payment method subscription diperbarui.
`subscription.cancelled`	Subscription dibatalkan oleh merchant atau customer.
`subscription.failed`	Pembuatan subscription gagal selama pembuatan mandate.
`subscription.expired`	Subscription mencapai akhir masa berlakunya dan kedaluwarsa.

Untuk schema payload dan contoh handler yang lebih detail, lihat Subscription Webhooks.

License Key Events

Event	Dipicu ketika
`license_key.created`	License key baru dibuat untuk suatu produk.

Untuk schema payload lengkap, lihat License Key Webhooks.

Entitlement Grant Events

Event	Dipicu ketika
`entitlement_grant.created`	Entitlement grant baru dibuat untuk customer. Grant license key yang dipenuhi secara otomatis dan grant feature flag hadir bersama `status: "Delivered"` dan tidak memicu event `delivered` terpisah. Grant lainnya, termasuk license key yang dipenuhi secara manual, hadir sebagai `Pending`. Lihat Entitlement Grant.
`entitlement_grant.delivered`	Pemenuhan grant selesai — license key diterbitkan, link file diselesaikan, atau akses platform diberikan.
`entitlement_grant.failed`	Pemenuhan grant gagal. Periksa `error_code` dan `error_message` dalam payload.
`entitlement_grant.revoked`	Akses dicabut. Periksa `revocation_reason` dalam payload.

Untuk schema payload yang lebih detail, contoh event, dan referensi lengkap revocation_reason, lihat Entitlement Grant Webhooks.

Credit Events

Event	Dipicu ketika
`credit.added`	Credit diberikan kepada customer (melalui subscription, pembelian satu kali, add-on, atau API).
`credit.deducted`	Credit digunakan melalui penggunaan atau debit manual.
`credit.expired`	Credit yang tidak digunakan kedaluwarsa setelah periode kedaluwarsa yang dikonfigurasi.
`credit.rolled_over`	Credit yang tidak digunakan dibawa ke grant baru pada akhir siklus.
`credit.rollover_forfeited`	Credit hangus karena jumlah rollover maksimum telah tercapai.
`credit.overage_charged`	Biaya overage diterapkan untuk penggunaan setelah saldo mencapai nol.
`credit.overage_reset`	Biaya overage yang terakumulasi di-reset (misalnya, pada awal billing cycle baru).
`credit.manual_adjustment`	Penyesuaian credit atau debit manual dilakukan.
`credit.balance_low`	Saldo credit turun di bawah threshold yang dikonfigurasi.

Untuk schema payload dan contoh handler yang lebih detail, lihat Credit-Based Billing Webhooks.

Recovery Events

Event	Dipicu ketika
`abandoned_checkout.detected`	Checkout yang belum selesai atau gagal terdeteksi setelah 60 menit.
`abandoned_checkout.recovered`	Customer menyelesaikan pembayaran melalui recovery link.

Untuk schema payload, deskripsi field, dan contoh handler yang lebih detail, lihat Recovery Webhooks.

Dunning Events

Event	Dipicu ketika
`dunning.started`	Upaya dunning dimulai untuk subscription yang telah melewati jatuh tempo atau ditangguhkan, atau telah dibatalkan.
`dunning.recovered`	Customer memperbarui payment method mereka dan charge yang dihasilkan berhasil.

Untuk schema payload, deskripsi field, dan contoh handler yang lebih detail, lihat Recovery Webhooks.

Payout Events

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

Event	Dipicu ketika
`payout.created`	Payout dibuat, baik melalui siklus payout otomatis maupun di luar siklus.
`payout.in_progress`	Tanggal jatuh tempo payout tiba dan pemrosesan dimulai.
`payout.on_hold`	Payout dijeda atau ditempatkan dalam peninjauan.
`payout.success`	Payout ke rekening bank Anda diselesaikan.
`payout.failed`	Payout gagal. Dana dan biaya dikreditkan kembali ke wallet Anda.

Payout events bukan event terminal dan tidak selalu mengikuti urutan tertentu. payout.failed dapat tiba setelah payout.success ketika bank mengembalikan transfer, dan payout.success dapat tiba setelah payout.failed ketika payout yang gagal kemudian dipulihkan. status dalam payload selalu sesuai dengan jenis event, jadi gunakan timestamp tingkat teratas dari setiap event untuk menemukan status terbaru.

payout.created sebelumnya dikeluarkan sebagai payout.not_initiated. Jika endpoint yang ada memfilter berdasarkan payout.not_initiated, perbarui filter tersebut menjadi payout.created agar tetap cocok.

Untuk schema payload, deskripsi field, dan contoh handler yang lebih detail, lihat Payout Webhooks.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Payment Events

Refund Events

Dispute Events

Subscription Events

License Key Events

Entitlement Grant Events

Credit Events

Recovery Events

Dunning Events

Payout Events

​Payment Events

​Refund Events

​Dispute Events

​Subscription Events

​License Key Events

​Entitlement Grant Events

​Credit Events

​Recovery Events

​Dunning Events

​Payout Events

Payment Events

Refund Events

Dispute Events

Subscription Events

License Key Events

Entitlement Grant Events

Credit Events

Recovery Events

Dunning Events

Payout Events