Skip to main content

​
Overview

Bill payments follow an approval workflow. This page covers all workflow-related actions.

​
Submit for Approval

POST /service/general-ledger/bill-payments/{bill_payment_id}/submit-for-approval

curl -X POST https://kube.acho.io/service/general-ledger/bill-payments/BP-2024-001/submit-for-approval \
  -H "Authorization: jwt YOUR_TOKEN"

​
Approve Payment

POST /service/general-ledger/bill-payments/{bill_payment_id}/approve

​
Body Parameters

​
comments
string
Optional approval comments
curl -X POST https://kube.acho.io/service/general-ledger/bill-payments/BP-2024-001/approve \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"comments": "Approved - payment authorized"}'

​
Reject Payment

POST /service/general-ledger/bill-payments/{bill_payment_id}/reject

​
Body Parameters

​
reason
string
required
Reason for rejection
curl -X POST https://kube.acho.io/service/general-ledger/bill-payments/BP-2024-001/reject \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Insufficient funds in payment account"}'

​
Request Change

POST /service/general-ledger/bill-payments/{bill_payment_id}/request-change

​
Body Parameters

​
comments
string
required
Description of requested changes
curl -X POST https://kube.acho.io/service/general-ledger/bill-payments/BP-2024-001/request-change \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"comments": "Please update the payment method and verify bank account details"}'

​
Place on Hold

POST /service/general-ledger/bill-payments/{bill_payment_id}/hold

​
Body Parameters

​
reason
string
required
Reason for placing on hold
curl -X POST https://kube.acho.io/service/general-ledger/bill-payments/BP-2024-001/hold \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Pending bank verification"}'

​
Remove from Hold

POST /service/general-ledger/bill-payments/{bill_payment_id}/unhold

curl -X POST https://kube.acho.io/service/general-ledger/bill-payments/BP-2024-001/unhold \
  -H "Authorization: jwt YOUR_TOKEN"

​
Get Audit Trail

GET /service/general-ledger/bill-payments/{bill_payment_id}/audit-trail

curl -X GET https://kube.acho.io/service/general-ledger/bill-payments/BP-2024-001/audit-trail \
  -H "Authorization: jwt YOUR_TOKEN"