KM UPDATE - Panduan Pengecekan Notifikasi Transaksi (Non CC Non QRIS)
Kendala: Notifikasi transaksi tidak diterima di sisi merchant baik dengan status sukses atau failed.
Berikut langkah pengecekan dan penanganan keluhan tersebut:
1. Cek status transaksi pada metabase pada menu Find Transaction untuk melakukan pengecekan, apakah status transaksi tercatat sukses atau gagal (failed)
2. Cek status notifikasi transaksi pada metabase pada menu Notification Center Status Notify dengan memasukkan tanggal pada field Date, client id dan Nomor invoice (https://buayo.doku.com/metabase/question/16329-notification-center-status-notify?ClientID=&InvoiceNumber=)
Pada Notification center status notify terdapat beberapa kolom dengan deskripsi berikut:
- Created date : Waktu notifikasi pertama kali dikirim oleh sistem.
- Notify status : Status pengiriman notifikasi (contoh: Success, Failed).
- Response from merchant : Balasan/respons yang diterima dari server merchant setelah notifikasi dikirim.
- Notify http response : Kode respons HTTP dari server merchant (contoh: 200 = sukses, 500 = error server, 400 = timeout).
- Retry date : Waktu percobaan pengiriman ulang notifikasi (jika gagal pada percobaan pertama).
- Url notify : Alamat endpoint (webhook) tujuan pengiriman notifikasi dari sistem ke merchant
Untuk pengecekan notifikasi transaksi OCO, cek terlebih dahulu URL Notifynya.
Jika URL Notifynya terdapat keterangan mid-oco-jokul-payment seperti http://private-api.doku.com/mid-oco-jokul-payment/virtual-account dan https://pay.doku.com, maka Notifikasi transaksi terkirim melalui V1 dan Jika ada permintaan dari merchant untuk melakukan renotifikasi, maka Agent dapat melakukan renotifikasi transaksi di DOKU MIS dengan klik N. Setelah melakukan renotify transaksi di DOKU MIS, informasikan ke sisi merchant dan lakukan Konfirmasi ke merchant: apakah notifikasi sudah diterima
Jika URL Notifynya adalah url merchant selain dari http://private-api.doku.com/mid-oco-jokul-payment/virtual-account, maka informasikan status notifikasi, respons dari merchant, notify http response, dan url notify ke sisi merchant, kemudian sarankan ke sisi merchant untuk melakukan renotifikasi melalui dashboard pada menu settings > http notification
Berikut beberapa skenario notifikasi transaksi:
- Skenario 1: Notifikasi Berhasil (Success)
Berdasarkan pengecekan di sistem kami, notifikasi transaksi telah berhasil dikirim ke server Anda pada tanggal 12 Juli 2025 pukul 10:30 WIB. Status notifikasi tercatat sebagai Success dengan respons HTTP 200. Server merchant merespons dengan pesan: SUCCESS. Mohon dapat dilakukan pengecekan kembali di sisi Anda.
- Skenario 2: Notifikasi Gagal, Bisa Dilakukan Renotifikasi
Kami mencatat bahwa notifikasi transaksi gagal dikirim ke sistem Anda dengan respons HTTP 500 Internal Server Error. Notifikasi pertama dikirim pada 11 Juli 2025 pukul 15:20 WIB, dan sistem telah melakukan retry namun belum berhasil.
Sebagai solusi, Anda dapat melakukan renotifikasi (resend notification) dari sisi merchant melalui dashboard. Jika setelah renotifikasi data masih belum muncul atau terjadi error kembali, mohon dicek konfigurasi endpoint dan pastikan URL callback aktif serta dapat menerima data.
- Skenario 3: Notifikasi Gagal karena Timeout, Akan Ada Retry Otomatis
Notifikasi transaksi gagal pada percobaan pertama karena koneksi ke server Anda mengalami timeout (HTTP 400 Gateway Timeout), dikirim pada 10 Juli 2025 pukul 08:15 WIB. Sistem kami akan secara otomatis melakukan retry hingga 3 kali dalam rentang waktu beberapa jam. Jika semua percobaan gagal, Anda tetap dapat melakukan renotifikasi melalui Dashboard pada menu settings > http notification
Source: https://doku.freshdesk.com/a/solutions/articles/66000531997?lang=en&portalId=66000064270