Callback Notifikasi Transaksi

Sistem Bisabiller akan secara otomatis mengirimkan notifikasi (callback) ke URL yang Anda sediakan setiap kali ada perubahan status transaksi, seperti sukses, gagal, atau refund. Callback ini dikirim menggunakan metode POST dan berfungsi untuk menjaga sinkronisasi status antara server Bisabiller dan sistem Anda secara real-time.

Callback biasanya dikirim:

Segera setelah transaksi diproses.
Setelah status transaksi berubah (misal: dari pending menjadi completed).
Untuk memastikan keandalan, sistem bisa mengirim ulang callback jika respons dari server Anda gagal.

Anda perlu menyediakan URL endpoint (misalnya /api/callback/ppob) dan memastikan endpoint tersebut menerima JSON POST.

📥 Contoh Payload (Callback Request)

{
  "trans_id": 7960192,
  "sn": "0041003089631248",
  "msisdn": "081381114352",
  "status": 4,
  "code": 0,
  "note": "Catatan dari produk",
  "harga": 10125,
  "reff_id": 111
}

📖 Penjelasan Field:

Field	Tipe	Deskripsi
`trans_id`	integer	ID transaksi dari sistem Bisabiller
`sn`	string	Serial number / kode isi ulang (jika produk mendukung)
`msisdn`	string	Nomor pelanggan (HP, rekening, ID pelanggan)
`status`	integer	ID status transaksi (lihat referensi status ID)
`code`	integer	Kode status (0: sukses, 1: gagal, 2: refund)
`note`	string	Catatan dari server terkait hasil transaksi
`harga`	integer	Total harga transaksi (dalam satuan rupiah)
`reff_id`	string	ID referensi transaksi dari sistem Anda

✅ Tindakan dari Server Anda

Sistem Anda wajib:

Menerima data JSON POST.
Memvalidasi trans_id dan reff_id dengan sistem internal Anda.
Memberikan respons HTTP 200 OK jika data diterima dengan baik.
Mencatat log jika terjadi masalah agar bisa dilacak kembali.

Contoh respons dari sistem Anda:

HTTP/1.1 200 OK

Catatan:

Endpoint callback bersifat penting dalam menjaga integritas transaksi.

Pastikan URL callback yang Anda daftarkan aktif, aman, dan mendukung HTTPS.

Jika server Anda tidak merespons atau error, Bisabiller dapat mencoba mengirim ulang beberapa kali.

Tidak semua produk memiliki sn atau serial number.

Callback adalah jembatan penting antara sistem PPOB dan server Anda untuk menjamin update status transaksi berjalan lancar.