APIs for Businesses
Home
APIs
APIs
  • Checkout/ Deeplink
  • Merchant Proxy
  • Bill24 Hosted
  • Auto Direct Debit
  • KHQR Integration Specification for API
  • Notification API
  • On Boarding Sub Biller API
Home
APIs
APIs
  • Checkout/ Deeplink
  • Merchant Proxy
  • Bill24 Hosted
  • Auto Direct Debit
  • KHQR Integration Specification for API
  • Notification API
  • On Boarding Sub Biller API
  1. Wallet History
  • Payment Method API
    • Overview
    • Response Code
    • MOBILE SDKS
      • iOS SDK
      • Android SDK
    • Authorization
      • Authorization
    • Customer
      • Get Customer Details
      • Update Customer
      • Delete Customer
      • Create Customer
    • Get Payment Methods
      • Get Payment Methods
    • Get Wallet Balance
      • Get Wallet Balance
    • Wallet History
      • Get Wallet History
        POST
    • Settle Payment
      • Settle Payment
    • Get Bills
      • Get list bills
      • Get single bill
    • Get transaction Details
      • Get Transaction Detail
  • Activate Sub Biller API
    • Overview
    • Response Code
    • Authorization
      POST
    • Onboarding
      POST
    • Get Available Banks
      GET
    • Add Link Account
      POST
    • Verify Linked Bank Account
      POST
    • Sub-Biller Portal
      POST
  1. Wallet History

Get Wallet History

POST
https://merchantapi-demo.bill24.io/instant_payment/get_wallet_histories
Get Wallet Transaction Histories
Retrieve wallet transaction history with optional filters such as
Wallet
Transaction type
Pagination
Date range

Request

Header Params

Body Params application/jsonRequired

Example
{
    "customer_sync_code": "C01",
    "wallet_id": "",
    "pagination": {
        "page_index": 1,
        "page_size": 30
    },
    "tran_type": "",
    "d1": "2025-01-01T10:13:58",
    "d2": "2026-05-12T13:13:58"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://merchantapi-demo.bill24.io/instant_payment/get_wallet_histories' \
--header 'Authorization: Bearer Token' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "customer_sync_code": "C01",
    "wallet_id": "",
    "pagination": {
        "page_index": 1,
        "page_size": 30
    },
    "tran_type": "",
    "d1": "2025-01-01T10:13:58",
    "d2": "2026-05-12T13:13:58"
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": "000",
    "message": "Success",
    "message_kh": "ជោគជ័យ",
    "data": {
        "transactions": [
            {
                "tran_type": "wallet_payment",
                "tran_id": "6637d051-c63d-4a19-9c4a-6cd65117e7dc",
                "wallet_id": "8316ca66-0ae0-4490-8415-2afaaa551063",
                "wallet_name": "Sae Veasna",
                "amount": 100.0000,
                "amount_display": "100 KHR",
                "currency": "KHR",
                "tran_date": "2025-09-04T15:38:38.366532+07:00",
                "description_en": "Payment",
                "description_km": "បង់ប្រាក់",
                "bank_ref": null,
                "status": "success"
            },
            {
                "tran_type": "wallet_payment",
                "tran_id": "48ba0f24-3b2a-466e-90f8-000e990ccddf",
                "wallet_id": "8316ca66-0ae0-4490-8415-2afaaa551063",
                "wallet_name": "Sae Veasna",
                "amount": 100.0000,
                "amount_display": "100 KHR",
                "currency": "KHR",
                "tran_date": "2025-09-03T15:08:46.792725+07:00",
                "description_en": "Payment",
                "description_km": "បង់ប្រាក់",
                "bank_ref": null,
                "status": "success"
            },
            {
                "tran_type": "wallet_topup",
                "tran_id": "a7c5637a-d012-4ba8-b8e8-6a9f0f40622e",
                "wallet_id": "8316ca66-0ae0-4490-8415-2afaaa551063",
                "wallet_name": "Sae Veasna",
                "amount": 200.0000,
                "amount_display": "200 KHR",
                "currency": "KHR",
                "tran_date": "2025-08-25T12:03:09.473488+07:00",
                "description_en": "Top up",
                "description_km": "បញ្ចូលប្រាក់",
                "bank_ref": "2BFD9036EF77",
                "status": "success"
            },
            {
                "tran_type": "wallet_topup",
                "tran_id": "bd853009-159c-44c3-8749-2476564b07f2",
                "wallet_id": "8316ca66-0ae0-4490-8415-2afaaa551063",
                "wallet_name": "Sae Veasna",
                "amount": 1000.0000,
                "amount_display": "1,000 KHR",
                "currency": "KHR",
                "tran_date": "2025-08-25T12:01:39.521933+07:00",
                "description_en": "Top up",
                "description_km": "បញ្ចូលប្រាក់",
                "bank_ref": "5F12157AD88A",
                "status": "success"
            }
        ],
        "pagination": {
            "page_size": 30,
            "total_page": 1,
            "page_index": 1
        },
        "statistics": [
            {
                "total_topup": 1200.0000,
                "total_payment": 200.0000,
                "total_topup_count": 2,
                "total_payment_count": 2,
                "currency": "KHR"
            }
        ]
    }
}
🟢200Customer not found
Modified at 2026-05-26 08:32:59
Previous
Get Wallet Balance
Next
Settle Payment