This document outlines the API specifications for billers integrating with Bill24. Billers have two integration options to provide bill amounts, and pending bills.

Sample - Bank App

This mockup illustrates the Pending Bills feature in the bank app. It allows consumers to conveniently review their past and current bills, ensuring transparency and easy access to payment records.

Preview

Example Pending Bills

Date	Amount	Balance	Digital Bill Url
`01/09/2025`	5,000	50,000	www.example.com/digital_bill1
`01/08/2025`	5,000	45,000	www.example.com/digital_bill2
`01/07/2025`	5,000	40,000	www.example.com/digital_bill3
`15/06/2025`	5,000	35,000	www.example.com/digital_bill4
`01/06/2025`	5,000	30,000	www.example.com/digital_bill5
`20/05/2025`	5,000	25,000	www.example.com/digital_bill6

📌 Opening Balance: 20,000 KHR

(-)before amount is use for payment .

Integration

The biller creates an endpoint for pending bills. Bill24 uses the existing proxy for bill amounts.

1.0 - Customer inputs consumer code or bill code.

1.1 - Bank calls to inquiry bill amount.

1.2 - Bill24 calls to biller to get bill amount.

1.3 - Biller responds with bill amount.

1.4 - Bill24 respone bill amount.

1.5 - Bank display bill amount to the customer.

2.0 - Customer click pending bills.

2.1 - Bank calls to pending bills from Bill24.

2.2 - Bill24 calls to biller to get pending bills.

2.3 - Biller responds with pending bills.

2.4 - Bill24 responds to Bank with pending bills.

2.5 - Bank displays pending bills on screen to customer.

1. Balance Inquiry

Bill24 calls the existing (old) proxy API for bill amounts.

2. Pending bills

Bill24 calls this endpoint to retrieve the pending bills for a consumer.

2.1 Operation

Description	Value
URL	{biller_domain}/pending_bills
Method	`POST`

2.2 Headers

Key	Value	Remark
Content-Type	`application/json`
token	biller token	Token auth from biller.

2.3 Request Payload

Field	Type	Require	Remark
`consumer_code`	String	Yes	Consumer code or invoice number at biller side.

2.4 Example Request Payload

{
  "consumer_code": "CU003035"
}

2.5 Response Payload

Field	Type	Remark
`code`	Integer	Response code.
`message`	String	Message in English.
`message_kh`	String	Message in Khmer.
`data`	Json	Data Object.

2.5.1 Response Payload For “data” item

Field	Type	Remark
`opening_balance`	Decimal	The total due amount before the earliest bill in last_transactions.
`pending_bills`	List Json	Pending bills.

2.5.2 Response Payload For “last_transactions” item

Field	Type	Remark
`date`	String	Transaction date (`dd/MM/yyyy`).
`amount`	Decimal	Bill amount or Payment amount.
`balance`	Decimal	Running total due at end of that bill period.
`digital_bill_url`	String	The link of digital bill

2.6 Example Response Payload

{
  "code": 0,
  "message": "Success",
  "message_kh": "",
  "data": {
    "opening_balance": 20000,
    "pending_bills": [
      {
        "date": "01/09/2025",
        "amount": 5000,
        "balance": 50000,
        "digital_bill_url": "http://www.example.com/digital_bill6"
      },
      {
        "date": "01/08/2025",
        "amount": 5000,
        "balance": 45000,
        "digital_bill_url": "http://www.example.com/digital_bill5"
      },
      {
        "date": "01/07/2025",
        "amount": 5000,
        "balance": 40000,
        "digital_bill_url": "http://www.example.com/digital_bill4"
      },
      {
        "date": "15/06/2025",
        "amount": 5000,
        "balance": 35000,
        "digital_bill_url": "http://www.example.com/digital_bill3"
      },
      {
        "date": "01/06/2025",
        "amount": 5000,
        "balance": 30000,
        "digital_bill_url": "http://www.example.com/digital_bill2"
      },
      {
        "date": "20/05/2025",
        "amount": 5000,
        "balance": 25000,
        "digital_bill_url": "http://www.example.com/digital_bill1"
      }
    ]
  }
}

Retrieve Pending Invoices & Digital Bill

Sample - Bank App#

Example Pending Bills#

Integration#

1. Balance Inquiry#

2. Pending bills#

2.1 Operation#

2.2 Headers#

2.3 Request Payload#

2.4 Example Request Payload#

2.5 Response Payload#

2.5.1 Response Payload For “data” item#

2.5.2 Response Payload For “last_transactions” item#

2.6 Example Response Payload#

Sample - Bank App

Example Pending Bills

Integration

1. Balance Inquiry

2. Pending bills

2.1 Operation

2.2 Headers

2.3 Request Payload

2.4 Example Request Payload

2.5 Response Payload

2.5.1 Response Payload For “data” item

2.5.2 Response Payload For “last_transactions” item

2.6 Example Response Payload