APIs for Businesses
Home
APIs
  • Checkout/ Deeplink
  • Merchant Proxy
  • Bill24 Hosted
  • Auto Direct Debit
  • KHQR Integration Specification for API
  • Notification API
  • On Boarding Sub Biller API
Home
APIs
  • Checkout/ Deeplink
  • Merchant Proxy
  • Bill24 Hosted
  • Auto Direct Debit
  • KHQR Integration Specification for API
  • Notification API
  • On Boarding Sub Biller API
  1. Settle Payment
  • 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
    • Settle Payment
      • Settle Payment
        POST
    • 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
  1. Settle Payment

Settle Payment

POST
https://merchantapi-demo.bill24.io/bill_payment/push_bill_with_payment
This endpoint use for settle money from Main account to Sub biller account.

Request

Header Params

Body Params application/json

Example
{
    "ref_id": "101",
    "date": "2024-06-22T02:41:55.350",
    "due_date": "2024-06-30T06:50:55.350",
    "currency": "KHR",
    "total_amount": 100,
    "customer_sync_code": "xxxxxxxxx",
    "total_tax": 0,
    "payment_method_token": "",
    "payment_to": "xxxxxxxxxxxxxxx",
    "description": "Charge testing",
    "exchange_rate_khr": "",
    "total_amount_khr": "",
    "hash": "xxxxxxxxxxxxxxx",
    "details": [
        {
            "item_mame": "A001",
            "description": "Hello",
            "quantity": 2,
            "price": 5,
            "amount": 10,
            "tax_amount": 0,
            "tax_name": "Charge tax"
        }
    ]
}

Request 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 --request POST 'https://merchantapi-demo.bill24.io/bill_payment/push_bill_with_payment' \
--header 'Content-Type:  application/json' \
--header 'Authorization:  Bearer {token get from endpoint (Authorization)}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ref_id": "101",
    "date": "2024-06-22T02:41:55.350",
    "due_date": "2024-06-30T06:50:55.350",
    "currency": "KHR",
    "total_amount": 100,
    "customer_sync_code": "xxxxxxxxx",
    "total_tax": 0,
    "payment_method_token": "",
    "payment_to": "xxxxxxxxxxxxxxx",
    "description": "Charge testing",
    "exchange_rate_khr": "",
    "total_amount_khr": "",
    "hash": "xxxxxxxxxxxxxxx",
    "details": [
        {
            "item_mame": "A001",
            "description": "Hello",
            "quantity": 2,
            "price": 5,
            "amount": 10,
            "tax_amount": 0,
            "tax_name": "Charge tax"
        }
    ]
}'

Responses

🟢200Success
application/json
Body

Example
{
    "code": "000",
    "message": "Push bill and capture payment successfully !",
    "message_kh": "បញ្ជូនវិក័យ្យបត្រនិងធ្វើការទូទាត់រួចរាល់​​ !",
    "data": {
        "bill": {
            "status": "success"
        },
        "payment": {
            "status": "success"
        }
    }
}
Modified at 2025-08-05 07:14:56
Previous
Get Wallet Balance
Next
Get list bills