Push Bill With Auto Payment

POST

https://merchantapi-demo.bill24.io/bill_payment/push_bill_with_payment

Request

Header Params

Content-Type

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer {token get from endpoint (Authorization)}

Body Params application/json

ref_id

string

required

Reference ID of bill

date

string

required

Bill date

due_date

string

required

Bill due date

currency

string

required

Currency code ex: USD or KHR

total_amount

integer

required

Total amount of Bill that already included tax

customer_sync_code

string

required

Sync code of customer

total_tax

integer

required

Total tax in that invoice

payment_method_token

string

required

Specific payment method that want to payment from
If not specify it's will payment from default payment method

settlement_to

string

required

Linked biller sync code that want to settle to

description

string

required

Description

exchange_rate_khr

string

required

Exchange rate from base currency to KHR currency ( example : $1 = 4100 )

total_amount_khr

string

required

Total amount in KHR currency ( base currency x exchange rate )

hash

string

required

Hash calculation
Base64(HMAC_SHA-512(ref_id + date(yyyyMMddHHmmss) + currency + total_amount

customer_sync_code + settlement_to , hash_token)) Bill24 will provide
hash_token

details

array [object {7}]

optional

Detail for this bill

item_name

string

optional

description

string

optional

quantity

integer

optional

price

number

optional

amount

number

optional

tax_amount

number

optional

tax_name

string

optional

Example

{
  "ref_id": "101",
  "date": "2024-06-22T02:41:55.350Z",
  "due_date": "2024-06-30T06:50:55.350Z",
  "currency": "USD",
  "total_amount": 10,
  "customer_sync_code": "xxxxxxxxx",
  "total_tax": 0,
  "payment_method_token": "",
  "settlement_to": "xxxxxxxxxxxxxxx",
  "description": "upload bills",
  "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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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.350Z",
    "due_date": "2024-06-30T06:50:55.350Z",
    "currency": "USD",
    "total_amount": 10,
    "customer_sync_code": "xxxxxxxxx",
    "total_tax": 0,
    "payment_method_token": "",
    "settlement_to": "xxxxxxxxxxxxxxx",
    "description": "upload bills",
    "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

code

string

optional

message

string

optional

message_kh

string

optional

data

object

optional

bill

object

optional

payment

object

optional

Example

{
  "code": "000",
  "message": "Push bill and capture payment successfully !",
  "message_kh": "បញ្ជូនវិក័យ្យបត្រនិងធ្វើការទូទាត់រួចរាល់ !",
  "data": {
    "bill": {
      "status": "success"
    },
    "payment": {
      "status": "success"
    }
  }
}

Modified at 2025-04-04 02:59:20

Get Payment Methods

Get List bills