Lewati ke konten utama

Callback partner (notifikasi hasil transaksi)

Untuk transaksi yang belum langsung selesai (menunggu supplier), R1 akan menghubungi sistem Anda begitu transaksi settle — sukses atau gagal.

  • R1 mengirim POST ke URL Callback yang Anda daftarkan (diatur admin pada data mitra).
  • Body-nya adalah data transaksi (bentuk sama seperti respons transaksi).
  • Header autentikasi mengikuti mode akun Anda: rqid (berisi api_key) atau sign.

Yang harus dilakukan sistem Anda​

  1. Terima POST pada URL callback Anda.
  2. Balas HTTP 200 secepatnya (dalam batas waktu singkat).
  3. Perbarui status transaksi di sistem Anda berdasarkan data yang diterima.

Jika sistem Anda tidak membalas 2xx, R1 akan mengulang pengiriman callback beberapa kali. Pastikan endpoint callback Anda idempoten (aman menerima notifikasi yang sama lebih dari sekali).

tip

Anda juga bisa menarik status kapan saja dengan endpoint Status (/V1/api/status) memakai ref_1 transaksi.