Transaction
Transaction History
Pantau riwayat transaksi produk customer mitra.
Terakhir diperbarui: 25 September 2026.
Transaction History digunakan untuk menampilkan transaksi produk milik customer yang sedang login. Endpoint ini membantu mitra memantau status pembayaran, status transaksi, produk yang dibeli, nomor tujuan, nominal pembayaran, dan serial number jika transaksi sudah selesai.
Customer Transaction History
GET /client/v2/transaction/history?status=all&page=1&pageSize=10&search=S20&startDate=2026-08-01&endDate=2026-08-18
Authorization: Bearer o8coocg8k0ss4wcgk0o8........
X-SECRET-KEY: {partner_secret_key}
Query
| Query | Wajib | Keterangan |
|---|---|---|
status | Tidak | Filter status transaksi. Default all. Gunakan value text pada tabel Status Filter. |
page | Tidak | Nomor halaman. Default 1. |
pageSize | Tidak | Jumlah data per halaman. Maksimal 100. |
search | Tidak | Cari berdasarkan nomor transaksi, nomor tujuan, nama produk, atau kode produk. |
startDate | Tidak | Tanggal awal format YYYY-MM-DD. |
endDate | Tidak | Tanggal akhir format YYYY-MM-DD. |
Filter tanggal menggunakan tanggal transaksi. Jika menggunakan range, kirim startDate dan endDate bersamaan. |
Status Filter
| Value | Arti |
|---|---|
all | Semua transaksi. |
success | Payment sudah selesai dan transaksi sukses. |
processing | Payment sudah selesai dan transaksi masih diproses. |
failed | Transaksi gagal atau payment expired. |
unpaid | Payment belum selesai. |
Beberapa kondisi status internal dapat tetap dipetakan oleh sistem untuk kompatibilitas. Untuk integrasi mitra, gunakan value text pada tabel ini agar implementasi lebih mudah dibaca dan stabil.
Success Response
{
"status": true,
"data": [
{
"id": 9410,
"transaction_number": "PAY/KFI/8/2026/86",
"msisdn": "082340378657",
"payment_status": "PAID",
"transaction_status": "SUCCESS",
"serial_number": "0214027100001032312531",
"reference_number": null,
"product": {
"id": 15676,
"code": "S20",
"name": "TELKOMSEL REGULER 20.000",
"image": {
"operator_logo": "https://dev-asset.miharogames.co.id/uploads/files/m_operator_logo/telkomsel.svg",
"product_icon": null,
"product_banner": null
}
},
"operator": {
"id": 1,
"name": "Telkomsel",
"logo": "https://dev-asset.miharogames.co.id/uploads/files/m_operator_logo/telkomsel.svg"
},
"amount": {
"total": 20000,
"balance_used": 20000,
"coin_used": 0,
"coin_value_used": 0,
"gateway_payment": 0
},
"payment_method": {
"gateway": "SALDO",
"type": "SALDO"
},
"created_at": "2026-08-18 11:15:20",
"updated_at": "2026-08-18 11:15:25"
}
],
"pagination": {
"total": 1,
"page": 1,
"perPage": 10,
"totalPages": 1
},
"message": "OK"
}
Gunakan payment_status, transaction_status, serial_number, dan reference_number sebagai informasi utama untuk ditampilkan di sistem mitra. serial_number dapat bernilai null jika provider tidak mengirim SN/token, misalnya pada PLN Pascabayar dan PLN Non-Taglis. Field lain dapat digunakan sebagai informasi pendukung pada halaman detail transaksi.
Response Codes
| HTTP | Kondisi | Message |
|---|---|---|
200 | History berhasil dimuat. | OK |
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 transaksi belum dapat dimuat. |