Balance History

POST

/user/balance/history

Retrieves a paginated history of a user's balance (saldo) transactions within a specified date range, with optional filtering and search capabilities.

Property Name	Data Type	Required	Notes
`start_date`	Date `(yyyy-mm-dd)`	No	Start date filter for balance history. Defaults to 1 month ago if not provided. Example: `"2025-08-01"`.
`end_date`	Date `(yyyy-mm-dd)`	No	End date filter for balance history. Defaults to the current date/time if not provided. Example: `"2025-08-16"`.
`filter_status`	String	No	Filter by transaction type. Allowed values: `"order"`, `"tarik_tunai"`, `"dana_cod"`, `"bonus_referal"`, `"topup"`.
`search`	String	No	Keyword to search in `kd_pesanan`, `saldo_masuk`, `saldo_keluar`, or `keterangan`. Supports partial matches. Example: `"PSN-250814IVPVF"`.
`limit`	Number	No	Maximum number of records to return. Example: `10`.
`offset`	Number	No	Number of records to skip for pagination. Example: `0`.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/user/balance/history' \
--header 'Content-Type: application/json' \
--data-raw '{
    "limit": 2,
    "offset": 1,
    "end_date": "2025-08-16",
    "start_date": "2025-08-01"
}'

Response Example

200 - success

{
    "success": true,
    "message": "success",
    "data": {
        "saldo": "19909915",
        "saldo_pending": "66878",
        "data_saldo": [
            {
                "idLogSaldo": 495,
                "saldoMasuk": null,
                "saldoKeluar": "447180",
                "kdPesanan": "PSN-250812ZJTUF",
                "keterangan": "Order pesanan PSN-250812ZJTUF",
                "hashUser": "20250526LQvjU9xhur",
                "idCustomer": null,
                "status": "1",
                "jenis": "1",
                "ket_jenis": "Transaksi pengiriman",
                "createdAt": "2025-08-12T16:57:38.000Z",
                "updatedAt": null
            },
            {
                "idLogSaldo": 494,
                "saldoMasuk": "447180",
                "saldoKeluar": "0",
                "kdPesanan": "PSN-250812WDPH3",
                "keterangan": "Cancel pesanan PSN-250812WDPH3",
                "hashUser": "20250526LQvjU9xhur",
                "idCustomer": 0,
                "status": "1",
                "jenis": "1",
                "ket_jenis": "Transaksi pengiriman",
                "createdAt": "2025-08-12T16:56:17.000Z",
                "updatedAt": null
            }
        ],
        "total": 35
    },
    "timestamp": "2025-08-18T03:17:26.140Z"
}

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Examples

Responses

🟢200success

application/json

Body

🟠401error

Modified at 2025-08-18 03:48:30

Get Webhook