Lihat Event

Event webhook merepresentasikan event yang baru saja terjadi secara asinkron, seperti pelanggan telah membayar menggunakan Virtual Account. Xendit menyediakan tab Callback di Dasbor untuk membantu Anda melihat event-event webhook yang telah terjadi beserta rinciannya seperti waktu dan status event.

Setiap kolom pada tab Callback mengandung informasi-informasi berikut:

  • Status: Status event tersebut, yang terdiri dari 4 status:
    • Completed: Pengiriman webhook berhasil
    • Pending: Event telah masuk antrean untuk selanjutnya dikirimkan ke URL destinasi
    • Failed: Pengiriman webhook gagal. Cek alasan kegagalan di rincian respon
    • URL Not Set: Anda tidak menyediakan URL untuk pengiriman webhook
    • Timeout: Xendit tidak menerima tanggapan apa pun dari server Anda dalam waktu 30 detik
  • Waktu Event: Waktu pada saat event tersebut pertama kali dibuat
  • ID Produk: ID dari produk Xendit yang Anda gunakan, contohnya: ID pembayaran VA
  • Tipe Produk: Produk Xendit yang Anda gunakan. Contoh-contoh tipe produk:
  • Pengiriman Selanjutnya: Estimasi waktu pengiriman ulang selanjutnya ketika ada event yang gagal terkirim ke sistem Anda. Lihat Pengiriman Ulang Otomatis untuk rinciannya.

Rincian Event

Setiap event dapat memberikan rincian informasi tambahan dengan membuka event tersebut di tab Callback di Dasbor. Berikut adalah contoh rincian informasi yang Anda dapat akses di tab Callback:

Halaman rincian event terdiri dari 3 bagian:

  • Informasi Transaksi
    • Status: Status event tersebut
    • Tanggal: Waktu pertama kali event tersebut dibuat
    • ID Produk: ID dari produk Xendit yang Anda gunakan, contohnya: ID pembayaran VA
    • Tipe Produk: Produk Xendit yang Anda gunakan
  • Request Payload
  • Rincian Event
    • Waktu: Waktu pengiriman event
    • Pengiriman Selanjutnya: Estimasi waktu pengiriman ulang selanjutnya ketika ada event yang gagal terkirim ke sistem Anda. Lihat Pengiriman Ulang Otomatis untuk rinciannya.
    • Sumber: Mengindikasikan siapa yang mengiriman event tersebut.. Akan menampilkan nama pengguna untuk pengiriman ulang manual dan Automatic untuk pengiriman otomatis
    • Response payload: Data respon webhook yang ditangkap oleh Xendit dari sistem Anda, baik respon sukses ataupun respon gagal. Mengandung informasi seperti kode status HTTP, kode error, durasi respon, dan body respon. Untuk respon gagal, Anda dapat mempelajari Eror Umum untuk membantu Anda melakukan pengecekan lebih lanjut.

Eror Umum

Xendit menampilkan data respon dari sistem Anda untuk membantu Anda melakukan pengecekan lebih lanjut apabila terjadi kesalahan atau eror pada sistem Anda. Data respon mengandung informasi-informasi seperti kode status HTTP, kode eror, durasi respon, dan body respon untuk membantu Anda melakukan diagnosa isu.

Kami mencoba mendokumentasikan semua eror sementara maupun eror fungsional yang kami temui pada pengguna-pengguna Xendit, beserta rekomendasi tindakan yang dapat dilakukan untuk memperbaiki eror-eror tersebut pada tabel berikut. Semua informasi-informasi ini juga dapat Anda temukan di halaman Rincian Event pada bagian Rincian Event dengan menampilkan data respon dan menunjukkan kursor Anda pada ikon informasi di sebelah eror yang Anda temui.

Eror HTTPDeskripsi
4xx Client ErrorClient error mengindikasikan bahwa terjadi isu atau kesalahan penanganan data request pada sisi klien atau sistem Anda . Cek halaman Rincian Event untuk melihat data request yang dikirimkan dan tinjau ulang logika penanangan request Anda untuk menyelesaikan eror ini.
5xx Server ErrorServer error biasanya muncul ketika server Anda tidak dapat dijangkau atau sedang mengalami kendala teknis. Kami merekomendasikan Anda untuk mengaktifkan fitur Pengiriman Ulang Otomatis untuk membantu Anda memudahkan proses rekonsiliasi.
ETIMEDOUTSambungan koneksi gagal atau pengiriman pesan tidak tercapai karena pihak yang terhubung tidak merespons dalam waktu 30 detik. Cek kembali data event di sistem Anda sebelum melakukan pengiriman ulang untuk menghindari pengiriman duplikat dan terapkan penanganan idempoten jika Anda belum melakukannya.
ECONNRESETSambungan koneksi ditutup secara paksa oleh pihak yang terhubung yang mengakibatkan hilangnya koneksi. Cek kembali data event di sistem Anda sebelum melakukan pengiriman ulang untuk menghindari pengiriman duplikat dan terapkan penanganan idempoten jika Anda belum melakukannya.
CERT_HAS_EXPIREDKami tidak dapat menjangkau URL server Anda karena sertifikat yang kedaluwarsa. Anda dapat menggunakan situs diagnosis SSL publik seperti Digicert untuk membantu Anda melakukan investigasi terkait isu ini. Silakan periksa dan perbarui sertifikat SSL Anda untuk menerima webhook secara normal lagi.
EAI_AGAINKami tidak dapat menjangkau server Anda karena timeout pada saat pencarian DNS. Ini bisa terjadi ketika ada masalah pada pengaturan proxy Anda atau masalah jaringan yang tidak stabil. Silakan periksa koneksi internet Anda dan kirim ulang event tersebut hingga berhasil.
ESOCKETTIMEDOUTKami tidak dapat menjangkau server Anda karena timeout pada saat pencarian DNS. Ini bisa terjadi ketika ada masalah pada pengaturan proxy Anda atau masalah jaringan yang tidak stabil. Silakan periksa koneksi internet Anda dan kirim ulang event tersebut hingga berhasil.
ECONNREFUSEDTidak ada koneksi yang dapat dibuat karena mesin target secara aktif menolaknya. Ini biasanya terjadi ketika sistem Xendit mencoba menyambung ke layanan yang sudah tidak aktif lagi di host asing. Silakan mengirimkan ulang event sampai berhasil
UNABLE_TO_VERIFY_LEAF_SIGNATURESertifikat dari pihak yang terhubung tidak tepercaya atau rantai SSL rusak. Anda dapat menggunakan situs diagnosis SSL publik seperti Digicert untuk membantu Anda melakukan investigasi terkait isu ini. Mohon periksa dan perbaiki konfigurasi sertifikat Anda dan coba lagi pengiriman event sampai berhasil.
ECONNABORTEDSambungan koneksi atau request gagal karena pihak terkait tidak dapat merespons dengan baik setelah 30 detik. Mohon untuk memeriksa data di sistem anda sebelum mengulang untuk menghindari pengiriman duplikat dan terapkan penanganan idempoten jika Anda belum melakukannya.
ENOTFOUNDKami tidak dapat menjangkau URL Anda karena pencarian DNS gagal. Ini biasanya dapat terjadi ketika URL yang digunakan tidak valid. Periksa kembali URL webhook Anda untuk memperbaiki kesalahan ini.
ERR_BODY_TOO_LARGEWebhook gagal karena body respons terlalu besar. Mohon kurangi ukuran body respons menjadi kurang dari 5MB.

Last Updated on 2024-07-03