Riwayat Transaksi PPOB

Endpoint ini digunakan untuk mengambil riwayat transaksi PPOB berdasarkan rentang tanggal dan nomor halaman. Cocok digunakan untuk keperluan pelaporan, audit, serta menampilkan histori pembelian kepada pengguna.

---

🚣️ Endpoint POST

https://sandbox.bisatopup.co.id/api/transaksi/riwayat

---

🔐 Autentikasi

Setiap permintaan harus menyertakan token autentikasi:

Authorization: Bearer <token>

---

📥 Request Body

{
  "page": 1,
  "date_from": "2018-11-24",
  "date_to": "2018-11-24"
}

Parameter

Parameter	Tipe	Wajib	Deskripsi
page	integer	Ya	Halaman data transaksi yang ingin diambil
date_from	string	Ya	Tanggal awal (format: YYYY-MM-DD)
date_to	string	Ya	Tanggal akhir (format: YYYY-MM-DD)

---

📤 Response

{
  "status": "ok",
  "data": [
    {
      "trans_id": 7907561,
      "reff_id": "1103",
      "tanggal": "24 Nov 2018",
      "time": "18:52:16",
      "product_id": 11,
      "is_tagihan": 0,
      "product_name": "TELKOMSEL",
      "product_detail": "TELKOMSEL 2.000",
      "product_detail_id": 1420,
      "no_hp_pelanggan": null,
      "harga": 2705,
      "admin_fee": 0,
      "image_url": "http://bisatopup.co.id/img/operator/telkomsel.png",
      "payment": "E-Wallet",
      "no_pelanggan": "085277677761",
      "expired_date": null,
      "token": null,
      "note": "Gagal, saldo dikembalikan, #7907561 Nomor tidak dapat diproses",
      "status": "Failed",
      "status_id": "14",
      "status_color": "#D91E18",
      "pembayaran": {
        "bank": "E-Wallet",
        "rekening": "",
        "name": "",
        "payment_id": 13,
        "image_url": "http://api.bisatopup.com/images/wallet.png"
      }
    }
  ],
  "total": 8,
  "page": "1",
  "total_page": 1
}

Penjelasan Field:

Field	Tipe	Deskripsi
trans_id	integer	ID transaksi
reff_id	string	ID referensi sistem Anda (jika tersedia)
tanggal	string	Tanggal transaksi
time	string	Waktu transaksi
product_id	integer	ID produk
is_tagihan	integer	Menandakan apakah transaksi adalah tagihan
product_name	string	Nama produk utama
product_detail	string	Nama produk dengan nominal/paket
product_detail_id	integer	ID produk detail
no_hp_pelanggan	string	Nomor HP pelanggan (jika tersedia)
harga	integer	Harga transaksi
admin_fee	integer	Biaya admin transaksi
image_url	string	URL logo produk
payment	string	Jenis metode pembayaran
no_pelanggan	string	Nomor pelanggan tujuan
expired_date	string	Tanggal kedaluwarsa (jika tersedia)
token	string	Kode token atau voucher (jika ada)
note	string	Catatan terkait status atau promo
status	string	Status transaksi (Completed, Failed, dll)
status_id	string	Kode status sistem
status_color	string	Warna status untuk tampilan UI
pembayaran	object	Detail metode pembayaran
├─ bank	string	Nama metode bayar
├─ rekening	string	Nomor rekening (jika relevan)
├─ name	string	Nama pemilik rekening (jika ada)
├─ payment_id	integer	ID metode pembayaran
└─ image_url	string	URL ikon metode pembayaran

---

Catatan:

• Semua objek dalam array data memiliki struktur field yang sama.
• Gunakan filter tanggal untuk mempersempit hasil pencarian.
• Fitur ini sangat berguna untuk backend reporting, pengelolaan saldo, atau validasi.
• Anda bisa mengkombinasikan response ini dengan endpoint Cek Status untuk informasi lebih detail.