v1

latestOpenAPI 3.1.02026-07-24111224223.3 KB
Bill Payments

Creates a bill payment

Books a cash or scheduled disbursement that settles all or part of a bill, updating the outstanding payable and linking treasury activity. Provide funding source details consistent with your configured payment rails so downstream bank reconciliation stays accurate.

IMPORTANT: Notice this operation has a redundancy between the bill_id path parameter and the billId attribute in the request body, which takes precedence and is used in internal logic. When executing this operation, both IDs must match, otherwise the request will be rejected. This is a legacy redundancy and will be removed in future versions of this operation.

post/bills/{bill_id}/payments

Path parameters

bill_idstring required

UUID of the bill to be used in this operation. Must match the billId provided in the request body.

Request body

datestring date required
account_codestring required

The account code found in the Chart of Accounts

Example request

{
  "amount": {
    "amount": "1.01",
    "currency": "USD"
  },
  "account_code": "11112"
}

Response

OK

idstring uuid required
status'CLEARED' | 'UNCLEARED' required
bill_idstring uuid required
datestring date
account_codestring

The account code found in the Chart of Accounts

Example response

{
  "amount": {
    "amount": "1.01",
    "currency": "USD"
  },
  "account_code": "11112"
}