Callback Transaction - Payment Gateway

Endpoint Callback Transaction adalah URL yang disediakan oleh pihak mitra (client) dan dimasukkan ke sistem Bisabiller melalui pengaturan mitra. Setelah transaksi memiliki status Completed, sistem Bisabiller akan secara otomatis melakukan HTTP POST ke URL callback tersebut dengan payload data transaksi.

Callback ini memungkinkan sistem mitra untuk menerima notifikasi secara real-time tanpa perlu polling status transaksi secara manual.

---

🔄 Mekanisme Callback

• Callback akan dikirim otomatis oleh server Bisabiller ke endpoint yang didaftarkan oleh mitra.
• Callback hanya terjadi ketika status transaksi berubah menjadi PAID (Completed).
• Format data dikirim dalam bentuk JSON dengan method POST.

---

🔔 Contoh Callback Request

{
  "id": 1,
  "transaction_id": "4",
  "transaction_total": "10000",
  "signature": "testing",
  "payment_id": 33,
  "payment": "QRIS",
  "status_id": 4,
  "status": "Completed",
  "expired_date": "2022-07-24 12:10:10"
}

Penjelasan Field:

Field	Tipe	Deskripsi
id	integer	ID transaksi internal
transaction_id	string	ID unik transaksi yang sama dengan yang dikirim saat pembuatan
transaction_total	string	Total nilai transaksi
signature	string	Tanda tangan digital untuk verifikasi
payment_id	integer	ID metode pembayaran
payment	string	Nama metode pembayaran (mis. QRIS, VA, OVO, dll)
status_id	integer	ID status transaksi (4 = Completed)
status	string	Status transaksi saat callback (Completed)
expired_date	string	Waktu kadaluarsa transaksi

---

📌 Tips Implementasi

• Pastikan URL callback Anda aktif dan dapat menerima method POST.
• Validasi signature jika Anda menggunakan metode verifikasi tambahan.
• Tanggapi callback dengan status HTTP 200 OK untuk menghindari retry otomatis.

---

Catatan:

• Sistem Bisabiller akan mengirimkan ulang callback apabila status HTTP bukan 200.
• Simpan transaction_id dan status dari callback sebagai referensi status transaksi akhir.
• Anda dapat menggunakan status_id = 4 sebagai penanda bahwa transaksi berhasil dan dana telah diterima.