Full Example

Integration Process

Process flow how to integrate with Bill24 SDKs

How to get started.

1 Autorization 🔗

In this section, you will initiate an authorization request. Upon successful authorization, Bill24 will provide a token key. This key grants you access to the API.

Sample code for:

PHP

Python

Sample response json data.

{
    "issuer": "http://192.168.197.7:40107",
    "token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjZCOUY3RDZBMjA2MTQxQz....",
    //The token will expire in 1 hour.
    "refreshToken": "7DFB50A51E1B2CE420B154DE041FD1D3BC5777C07F43D427D328EB37E9A7C112",
    "tokenExpireTime": "2023-08-24T16:42:21.9110603+07:00",
    "userId": "0b2e17be-d225-4f79-b6a9-98fa811a769c",
    "email": "admin@ubill24.com",
    "fullname": "Administrator",
    "permissions": null,
    "isNeedChangePassword": false,
    "passwordNeverExpire": false,
    "passwordExpireIn": 2147483647,
    "isPasswordExpire": false
}

2 Transaction Initiation 🔗

In this section, you will call Transaction Initiation to get tran_id & payment_link.

Sample code for:

PHP

Python

Sample response json data.

{
    "code": "SUCCESS",
    "message": "Transaction init successful",
    "message_kh": "បង្កើតប្រតិបត្តិការជោគជ័យ",
    "data": {
        "tran_id": "7B9807BB3854",
        "identity_code": "test001dfdfA",
        "payment_link": "https://checkout-demo.bill24.io/checkout/7B9807BB3854",
        "khqr_string": "00020101021230400016amkbkhppxxx@amkb010477770208TESTKHQR..."
    }
}

3 Transaction Verification 🔗

In this section, you will call Transaction Verification to verify payment status.

Sample code for:

PHP

Python

Sample response json data.

{
    "code": "SUCCESS",
    "message": "Transaction found",
    "message_kh": "ប្រតិបត្តិការបានរកឃើញ",
    "data": {
        "device_code": "1113",
        "channel_code": "CH1",
        "customers": [
            {
                "branch_code": "GB",
                "branch_name": "BBB",
                "customer_code": "C01",
                "customer_name": "BOT",
                "customer_name_latin": "BOT",
                "bill_no": "123",
                "amount": 10000
            }
        ],
        "tran_id": "5DD2B215208D",
        "tran_date": "2023-12-27T17:09:50.253174",
        "tran_amount": 10000,
        "fee_amount": 800,
        "total_amount": 10800,
        "currency": "KHR",
        "identity_code": "0000012",
        "bank_code": "",
        "bank_ref": "",
        "purpose_of_transaction": "INV0000012",
        "status": "pending",
        "description": ""
    }
}

Integration Process#

How to get started.#

Integration Process

How to get started.