Overview

The On Boarding Sub Biller API helps Sub billers register and connect their bank account to a payment platform. This connection allows them to receive customer payments easy, quickly and securely.

---

Customer Journey

Example Drivers Use the App to Charge at Station:

1 Driver opens the mobile charging app.

2 Driver loc ates the nearest charging point.

3 Driver chooses a payment method (Bank, KHQR, Wallet, Card, etc).

4 Driver enters kWh or battery % to charge their vehicle.

5 Driver pays and starts charging immediately.

---

Authorization

Process authorization to get access token

---

On boarding for new Sub biller Flow

This section is for register a Sub biller and allows them to link an account for settlement.

1.0 The Sub Biller initiates the onboarding process.

1.1 The Biller sends a request to Bill24 to create a Sub Biller account.

1.2 Bill24 requests the Bank to generate an Add Account link.

1.3 The Bank responds to Bill24 with a WebAccountUrl.

1.4 Bill24 return the WebAccountUrl to the Biller.

1.5 The Biller displays the bank's website to the Sub Biller.

2.0 The Sub Biller input their bank account details on the Bank's website.

2.1The Bank Redirects the Sub Biller back to the Biller’s Return URL.

2.2The Biller Shows the Sub Biller the Account Linking Result.

3.0 The Bank sends a webhook notification to Bill24 to confirm that the account linking was successful.

---

Add Link Account Flow

This section is used to allow Sub Biller to link their account for settlement

1.0 The Sub Biller clicks add link buttonon the Biller’s platform to link their bank account.

1.1 The Biller requests Bill24 about the link for connect bank Account.

1.2 Bill24 requests the Bank to generate an Add Account link

1.3 The Bank responds to Bill24 with a WebAccountUrl.

1.4 Bill24 return the WebAccountUrl to the Biller.

1.5 The Biller displays the bank's website to the Sub Biller.

2.0 The Sub Biller input their bank account details on the Bank's website.

2.1The Bank Redirects the Sub Biller back to the Biller’s Return URL.

2.2The Biller Shows the Sub Biller the Account Linking Result.

3.0 The Bank sends a webhook notification to Bill24 to confirm that the account linking was successful.

---

Get Available Bank Flow

This section used to retrieve all banks that have activated the wallet service.

1.0 Biller sends a request to retrieve all banks that have activated the wallet service.

1.1 Bill24 system processes the request and responds with a list of available banks.

---