Retrieve Balance History

Access a record of past balance changes over time.

GET [BASE_URL]/v1/balance-histories?startDate={startDate}&endDate={endDate}&accountType={balanceType}

Query Parameter

Detail Query Parameter

Parameter
Data Type
Requirement
Description

startDate

String

M

Filter start date (ISO 8601 format) :

  • Max Back Date = 6 Months

  • Max Range = 31 Days

endDate

String

M

Filter end date (ISO 8601 format)

  • Max Back Date = 6 Months

  • Max Range = 31 Days

accountType

String

O

Response

Response Body

{
  "code": "00",
  "message": "Success",
  "data": [
    {
      "referenceId": "1748603636",
      "date": "2025-05-30T11:14:24.352687Z",
      "settlementDate": "2025-05-30T11:14:24Z",
      "settlementStatus": "SUCCESS",
      "balanceType": "Payment Balance",
      "channel": "Virtual Account",
      "transactionType": "VA Payment",
      "amount": {
        "value": 10000,
        "currency": "IDR"
      },
      "fee": {
        "value": 4000,
        "currency": "IDR"
      },
      "createdBy": "Reforza Pivot",
      "transactionId": "e89e6584-d25d-4ccf-ac50-a95369fe2ae0"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 1,
    "totalItems": 89,
    "totalPages": 89
  }
}

Detail Parameter Response

Parameter
Data Type
Requirement
Description

data

Array of Objects

O

Object consisting of Merchant’s balance history

  • referenceId

String

M

Same data as in Merchant Dashboard - Balance History

  • date

String

M

Transaction date

  • settlementDate

String

O

Same data as in Merchant Dashboard - Balance History

  • settlementStatus

String

M

Same data as in Merchant Dashboard - Balance History

  • balanceType

String

M

Same data as in Merchant Dashboard - Balance History

  • channel

String

O

Same data as in Merchant Dashboard - Balance History

  • transactionType

String

M

Same data as in Merchant Dashboard - Balance History

  • amount

Object

O

Same data as in Merchant Dashboard - Balance History

>> value

Float

M

The amount value

>> currency

String

M

The amount currency

  • fee

Object

O

Same data as in Merchant Dashboard - Balance History

>> value

Float

M

The amount value

>> currency

String

M

The amount currency

  • createdBy

String

M

Same data as in Merchant Dashboard - Balance History

  • transactionId

String

M

Same data as in Merchant Dashboard - Balance History

List of Account Types

Balance Type
Transaction Type

PAYMENT

BALANCE_ADJUSTMENT

PAYMENT

TRANSFER

PAYMENT

PAYMENT_WITHDRAWAL

PAYMENT

CARD_PAYMENT

PAYMENT

VA_PAYMENT

PAYMENT

QRIS_PAYMENT

PAYMENT

PLATFORM_TRANSACTION_FEE

PAYMENT

REFUND

PAYMENT

REFUND_FEE

PAYMENT

PAYMENT_FEE

DISBURSEMENT

VA_TOP_UP

DISBURSEMENT

MANUAL_TOP_UP

DISBURSEMENT

BALANCE_ADJUSTMENT

DISBURSEMENT

TRANSFER

DISBURSEMENT

DISBURSEMENT_WITHDRAWAL

DISBURSEMENT

DISBURSEMENT

DISBURSEMENT

BULK_DISBURSEMENT

DISBURSEMENT

ACCOUNT_INQUIRY_FEE

DISBURSEMENT

INTERNATIONAL_PAYOUT

DISBURSEMENT

PLATFORM_ACTIVITY_FEE

DISBURSEMENT

PLATFORM_TRANSACTION_FEE

DISBURSEMENT

DISBURSEMENT_FEE

WALLET

VA_TOP_UP

WALLET

MANUAL_TOP_UP

WALLET

BALANCE_ADJUSTMENT

WALLET

WALLET_WITHDRAWAL

WALLET

MERCHANT_PAYMENT

WALLET

FEE_TOP_UP

WALLET

FEE_BANK_TRANSFER

WALLET

FEE_WALLET_TRANSACTION

WALLET

FEE_TRANSFER

Last updated