Bill payments

New: Bill payment endpoints

Record and retrieve payments against a bill, mirroring the existing invoice payment endpoints.

MethodPathDescription
POST/bills/{billId}/paymentsRecord a manual payment against a bill
GET/bills/{billId}/paymentsList all payment records for a bill
GET/bills/{billId}/payments/{paymentId}Get a single payment on a bill by payment id

Notes

  • The request body matches invoice payments: amount (positive, in dollars), paymentDate (ISO 8601), paymentMethod (CASH, ACH, CREDIT_CARD, KLARNA, AFFIRM, or CHECK), and optional notes / paymentReference. Amounts are returned in dollars.
  • Bill payment responses expose the payment display number as billNumber (invoice payments continue to use invoiceNumber).
  • This makes it possible to move a bill to PAID through the API — previously a bill’s status could not be changed without an associated payment.