> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.coperniq.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.coperniq.io/_mcp/server.

## Bill payments

### New: Bill payment endpoints

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

| Method | Path                                   | Description                                  |
| ------ | -------------------------------------- | -------------------------------------------- |
| `POST` | `/bills/{billId}/payments`             | Record a manual payment against a bill       |
| `GET`  | `/bills/{billId}/payments`             | List 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.