Skip to main content
POST
/
service
/
general-ledger
/
bills
/
{bill_id}
/
pay
curl -X POST https://kube.acho.io/service/general-ledger/bills/BILL-2024-001/pay \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_date": "2024-02-10",
    "payment_amount": 550,
    "payment_account_id": "a3-cash-xxx",
    "payment_method": "Check",
    "reference": "CHK-001"
  }'

{
  "bill_id": "BILL-2024-001",
  "payment_id": "BP-2024-001",
  "payment_date": "2024-02-10",
  "payment_amount": 550,
  "payment_account_id": "a3-cash-xxx",
  "payment_method": "Check",
  "reference": "CHK-001",
  "bill_status": "Paid",
  "amount_paid_total": 550,
  "amount_due": 0
}

​
Request

Record a payment against a posted bill. This creates a payment record and updates the bill’s amount due.

​
Headers

​
Authorization
string
required
JWT authentication token. Format: jwt YOUR_TOKEN
​
Content-Type
string
required
Must be application/json

​
Path Parameters

​
bill_id
string
required
The unique identifier of the bill

​
Body Parameters

​
payment_date
string
required
Date of payment (YYYY-MM-DD)
​
payment_amount
number
required
Amount being paid
​
payment_account_id
string
required
Cash/bank account ID for the payment
​
payment_method
string
Payment method (e.g., Check, ACH, Wire, Credit Card)
​
reference
string
Payment reference number (e.g., check number)
For more complex payment scenarios with multiple bills, use the Bill Payments API.
curl -X POST https://kube.acho.io/service/general-ledger/bills/BILL-2024-001/pay \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_date": "2024-02-10",
    "payment_amount": 550,
    "payment_account_id": "a3-cash-xxx",
    "payment_method": "Check",
    "reference": "CHK-001"
  }'

{
  "bill_id": "BILL-2024-001",
  "payment_id": "BP-2024-001",
  "payment_date": "2024-02-10",
  "payment_amount": 550,
  "payment_account_id": "a3-cash-xxx",
  "payment_method": "Check",
  "reference": "CHK-001",
  "bill_status": "Paid",
  "amount_paid_total": 550,
  "amount_due": 0
}

​
Accounting Impact

When a bill payment is recorded:
  • Debit: Accounts Payable (reduces liability)
  • Credit: Cash/Bank Account (reduces asset)