Transaction

Balance History

Pantau riwayat saldo masuk dan saldo keluar customer mitra.

Terakhir diperbarui: 25 September 2026.

Balance History digunakan untuk menampilkan riwayat saldo masuk dan saldo keluar customer yang sedang login. Endpoint ini membantu mitra melakukan rekonsiliasi saldo, audit pembayaran transaksi, pengecekan refund, penarikan saldo, top up saldo, transfer saldo, dan konversi saldo/koin.

Endpoint

GET /client/v2/transaction/balance?type=all&search=&page=1&pageSize=25&startDate=2025-09-03&endDate=2026-09-03
Authorization: Bearer o8coocg8k0ss4wcgk0o8........
X-SECRET-KEY: {partner_secret_key}

Query

Query	Wajib	Keterangan
`type`	Tidak	Filter tipe mutasi saldo. Default `all`.
`search`	Tidak	Cari berdasarkan nomor transaksi, nama produk, atau nomor tujuan.
`startDate`	Tidak	Tanggal awal format `YYYY-MM-DD`.
`endDate`	Tidak	Tanggal akhir format `YYYY-MM-DD`.
`page`	Tidak	Nomor halaman. Default `1`.
`pageSize`	Tidak	Jumlah data per halaman. Default `25`, maksimal `100`.

Filter tanggal menggunakan tanggal mutasi saldo. Jika menggunakan range, kirim startDate dan endDate bersamaan.

Type Filter

Value	Keterangan
`all`	Semua mutasi saldo.
`transaction`	Pembayaran transaksi menggunakan saldo.
`refund`	Pengembalian dana transaksi atau penarikan saldo.
`withdraw`	Penarikan saldo.
`topup`	Penambahan saldo, transfer masuk, atau konversi saldo.

Type Values

Type Response	Keterangan
`TRANSACTION`	Pembayaran transaksi menggunakan saldo.
`REFUND`	Pengembalian dana transaksi.
`REFUND_GTIX`	Pengembalian dana tiket hiburan.
`WITHDRAW`	Penarikan saldo.
`WITHDRAW_REJECTED`	Pengembalian dana penarikan saldo.
`ADMIN_TOPUP`	Penambahan saldo oleh admin.
`ADMIN_CUT`	Pengurangan saldo oleh admin.
`TRANSFER_IN`	Transfer saldo masuk.
`TRANSFER_OUT`	Transfer saldo keluar.
`CONVERT_SALDO`	Konversi koin ke saldo.
`CONVERT_COIN`	Konversi saldo ke koin.

Success Response

{
  "status": true,
  "data": [
    {
      "id": 5053,
      "transaction_number": "PAY/KFI/8/2026/199",
      "date": "2026-08-31 14:38:54",
      "type": "TRANSACTION",
      "type_label": "Pembayaran SALDO DANA 50.000",
      "direction": "OUT",
      "amount": 51000,
      "balance_after": 876900,
      "description": ""
    },
    {
      "id": 5046,
      "transaction_number": null,
      "date": "2026-08-27 15:42:25",
      "type": "ADMIN_TOPUP",
      "type_label": "Penambahan Saldo oleh Admin",
      "direction": "IN",
      "amount": 1000000,
      "balance_after": 1029000,
      "description": "for testing development feature"
    }
  ],
  "pagination": {
    "total": 2,
    "page": 1,
    "perPage": 25,
    "totalPages": 1
  },
  "message": "OK"
}

Field Notes

Field	Keterangan
`transaction_number`	Nomor transaksi terkait. Bernilai `null` jika mutasi saldo tidak terhubung ke transaksi produk atau penarikan saldo.
`type`	Kode tipe mutasi saldo.
`type_label`	Label yang sudah dirapikan dari sudut pandang customer.
`direction`	`IN` untuk saldo masuk, `OUT` untuk saldo keluar.
`amount`	Nominal mutasi saldo.
`balance_after`	Saldo customer setelah mutasi tercatat.
`description`	Catatan mutasi saldo. Nomor transaksi tidak ditampilkan ulang pada field ini agar tidak duplikatif.

Response Codes

HTTP	Kondisi	Message
`200`	Riwayat saldo berhasil dimuat.	`OK`
`400`	`type` tidak valid.	`type tidak valid.`
`400`	`pageSize` lebih dari 100.	`pageSize maksimal 100.`
`400`	Format tanggal salah atau range tanggal tidak lengkap.	`startDate/endDate wajib menggunakan format YYYY-MM-DD.`
`401`	Secret key/token salah.	`Akses ditolak...`, `Token wajib diisi.`, atau `Token tidak valid.`
`500`	Gangguan sistem.	`Riwayat saldo belum dapat dimuat.`

Previous Transaction HistoryRiwayat transaksi produk customer, filter status, dan pagination. Next Balance Topup RequestBuat dan pantau pengajuan topup saldo customer mitra.