Wallet Module

Modul Wallet merupakan bagian dari Core Service API Bisabiller yang berfungsi untuk menampilkan informasi saldo dompet digital milik pengguna. Modul ini sangat penting dalam memastikan pengguna dapat memantau saldo yang tersedia, jumlah yang sedang dikunci, serta data nomor HP yang terasosiasi dengan wallet tersebut.

Endpoint ini hanya tersedia bagi pengguna yang telah terautentikasi, dan setiap permintaan harus menyertakan header Authorization: Bearer <access_token>.

Modul Wallet ini terdiri dari satu endpoint utama:

1. User Wallet – Menampilkan informasi detail riwayat transaksi saldo dompet pengguna.

---

🔐 Keamanan dan Autentikasi

Semua permintaan ke modul wallet harus dilindungi oleh token autentikasi yang valid. Token ini didapatkan melalui proses login atau refresh token. Pastikan Anda menyimpan dan mengelola token dengan aman agar tidak disalahgunakan oleh pihak lain.

---

📌 Manfaat Modul Wallet

• Menampilkan riwayat mutasi saldo pengguna.
• Memberikan transparansi transaksi dengan rincian nominal dan waktu transaksi.
• Menyediakan informasi lengkap mengenai perubahan saldo.
• Digunakan sebagai referensi laporan atau histori transaksi keuangan pengguna.

---

📄 Endpoint GET

GET https://api.bisabiller.com/api/wallet/history

Header:

Authorization: Bearer <access_token>

Query Parameters:

{
  "limit": 10,
  "current_page": 1,
  "date_from": "2022-09-01",
  "date_to": "2023-05-23"
}

---

✅ Contoh Response

{
  "date_from": "2022-09-01",
  "date_to": "2023-05-23",
  "pagination": {
    "total_found": 32,
    "limit": "10",
    "current_page": "1",
    "total_page": 4
  },
  "error": false,
  "message": "no message",
  "data": [
    {
      "wallet_history_id": 38978255,
      "walet_id": 3753,
      "order_id": 43783806,
      "user_id": 122,
      "no_hp": "08561205976",
      "type": 2,
      "jumlah": -20355,
      "saldo_sebelumnya": 84400307,
      "sisa_saldo": 84379952,
      "note": "[43783806] - Pembelian TOKEN PLNPRA 20.000 Ke nomor 45002527385",
      "bank_note": null,
      "created_date": "2023-05-22 01:20:40",
      "updated_at": "2023-05-21T18:20:40.000000Z",
      "created_at": "2023-05-21T18:20:40.000000Z"
    }
    // ...data lainnya
  ]
}

---

Penjelasan Field Penting:

Field	Tipe	Deskripsi
wallet_history_id	integer	ID unik untuk catatan riwayat dompet
jumlah	integer	Jumlah perubahan saldo (positif atau negatif)
saldo_sebelumnya	integer	Saldo pengguna sebelum transaksi
sisa_saldo	integer	Saldo pengguna setelah transaksi
note	string	Catatan terkait transaksi
type	integer	Tipe transaksi (contoh: 2 = pembelian, 91 = pemesanan hotel, dst.)
created_date	string	Tanggal dan waktu saat transaksi tercatat dalam sistem

---

Catatan:

• Gunakan parameter date_from dan date_to untuk memfilter periode transaksi.
• Pastikan pengguna sudah login dan menyertakan token pada setiap request.
• Format response akan mengikuti pagination untuk memudahkan integrasi skala besar.