Full Example

Integration Process

How to get started.

Push your bills to Bill24 proxy/host follow these steps:

1 Push New Customer 🔗

This step Billers/Businesses can push customer (new , update , remvove) to Bill24 proxy/host, after completed customer can search via Bank channnels.

Sample code for:

PHP

Python

Example Response Payload

{
    "id": "Ny5KzCQ4",
    "code": "12831cd5-0e78-40e7-bba6-6f046d9e5931",
    "operation": "cus.push",
    "note": "",
    "status": "ready",
    "completed": false,
    "created_host": "None",
    "start_date": null,
    "end_date": null,
    "result": null,
    "total_record": "1",
    "created_date": "2024-02-14T14:18:33.775055"
}

2 Push New Bill 🔗

This step Billers/Businesses can push bills to Bill24 proxy/host. After completed this step your customer can pay via Bank channels.

Sample code for:

PHP

Python

Example Response Payload

3 Get Queue 🔗

This step Billers/Businesses can get queue as list. After push customer or bill.

Sampel code for:

PHP

Python

Example Response Payload

4 Get Queue Detail 🔗

You possible get queue detail with this step by using id.

Sample code for:

PHP

Python

Example Response Payload

5 Webhook 🔗

This step required Billers/Businesses implement this endpoint to allow Bill24 push back the online payment transaction to your server.

Sample Request JSON:

Sample Response JSON:

6 Create New Payment 🔗

This step allow Billers/Businesses push bills to clear at Bill24 side. In case customer paid by cash.

Sample code for:

PHP

Python

//change best url to production
var client = new RestClient("https://supplierapi-demo.bill24.net/payment/push");
    client.Timeout = -1;

//change your real credential token.
var request = new RestRequest(Method.POST);
    request.AddHeader("Accept", "application/json");
    request.AddHeader("token", "1603aa00dcc4426ba83298341bab126b");
    request.AddHeader("Content-Type", "application/json");

var body = @"{" + "\n" +
    @"  ""data"": [" + "\n" +
    @"    {" + "\n" +
    @"      ""currency_id"": ""USD""," + "\n" +
    @"      ""customer_sync"": ""CU003035""," + "\n" +
    @"      ""description"": ""pay by cash""," + "\n" +
    @"      ""title"": ""Invoice""," + "\n" +
    @"      ""payment_method"": ""cash""," + "\n" +
    @"      ""sync_code"": ""CU003035""," + "\n" +
    @"      ""tran_date"": ""2024-02-14""," + "\n" +
    @"      ""bill_syncs"": ""INV001""," + "\n" +
    @"      ""total_amount"": 10.0" + "\n" +
    @"    }" + "\n" +
    @"  ]" + "\n" +
@"}";

request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

Sample Response JSON:

7 Get Payment🔗

This step allow Billers/Businesses get payments from Bil24, and we will response payments default, you can filter as well.

Sample code for:

PHP

Python

//change best url to production
var client = new RestClient("https://supplierapi-demo.bill24.net/payment/?d1=2024-01-20&d2=2024-02-14&customer_sync&payment_method&currency_id&source");
    client.Timeout = -1;

//change your real credential token.
var request = new RestRequest(Method.GET);
    request.AddHeader("Accept", "application/json");
    request.AddHeader("token", "1603aa00dcc4426ba83298341bab126b");

IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

Sample Response JSON:

Integration Process#

How to get started.#

Integration Process

How to get started.