Notification Handle

Praktik Terbaik untuk Menangani Notifikasi:

1. Gunakan endpoint HTTPS setiap saat. Karena kami memverifikasi bahwa sertifikat cocok dengan host, sertifikat tersebut aman dan tidak dapat menjadi target serangan Man-in-the-Middle (MITM). Self-signed certificates tidak boleh digunakan.
2. Notifikasi harus selalu dilaksanakan secara idempoten. Kami mungkin sesekali mengirimkan dua atau lebih notifikasi untuk transaksi yang sama. Menggunakan Order ID sebagai kunci untuk melacak entri adalah metode langsung untuk memastikan bahwa tidak ada entri duplikat di pihak merchant.
3. Meskipun kami berupaya keras untuk mengirimkan pemberitahuan segera setelah transaksi selesai, jika terjadi penundaan yang tidak biasa, harap gunakan Check Status API untuk mengetahui status transaksi saat ini. Untuk melihat status transaksi terkini, Anda juga dapat menggunakan Check Status API untuk kasus apa pun.
4. HTTP timeout yang telah kami tetapkan adalah 30 detik. Umumnya disarankan untuk menjaga waktu respons notifikasi HTTP Anda kurang dari 5 detik.
5. Isi notifikasi dikirim sebagai JSON; gunakan parser JSON untuk menafsirkan JSON. Disarankan untuk mengurai isi notifikasi dalam format yang tidak ketat, karena kemungkinan besar field baru akan ditambahkan. Ini akan memastikan bahwa parser tidak mengeluarkan pengecualian ketika menemukan kolom baru. Ini harus dengan baik mengabaikan fields yang baru ditambahkan. Hal ini menjaga klien lama kami tetap utuh sekaligus memperluas sistem notifikasi kami untuk kasus penggunaan yang lebih baru.
6. Bila memungkinkan, balas notifikasi dengan kode Status HTTP yang sesuai. Percobaan ulang untuk skenario kesalahan ditangani secara berbeda tergantung pada kode status:
   • untuk 2xx : Tidak perlu dicoba, sudah dianggap berhasil
   • untuk 5xx : Kami akan mencoba lagi 5 kali dengan interval 1 menit, 5 menit, 15 menit, 30 menit dan 1 jam