Record invoice payment
Register and book a customer payment on an invoice.
POST https://cotlet.dev/api/v1/bokio/invoices/{invoice_id}/payment
write Confirm
Registers a payment with its date and amount on the account you name and books it, which clears the receivable. An amount below the total leaves the invoice open as a partial payment. It changes the books and the invoice status. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| invoice_id string required | string | Invoice ID from list_invoices or create_invoice. |
| date string required | string | Date the money arrived, YYYY-MM-DD. |
| amount number required | number | Amount paid, in the company's base currency. |
| account string required | string | Bookkeeping account the payment went to, for example 1930. |
Request
curl -X POST https://cotlet.dev/api/v1/bokio/invoices/f2d84b1a-6c30-4e97-8a5b-1d9c7e3a40b2/payment \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-10-13","amount":13125,"account":"1930"}'result = client.call("bokio", "record_invoice_payment", {"invoice_id":"f2d84b1a-6c30-4e97-8a5b-1d9c7e3a40b2","date":"2026-10-13","amount":13125,"account":"1930"})const result = await cotlet.call('bokio', 'record_invoice_payment', {"invoice_id":"f2d84b1a-6c30-4e97-8a5b-1d9c7e3a40b2","date":"2026-10-13","amount":13125,"account":"1930"});cotlet call bokio record_invoice_payment --data '{"invoice_id":"f2d84b1a-6c30-4e97-8a5b-1d9c7e3a40b2","date":"2026-10-13","amount":13125,"account":"1930"}'Example response
{
"invoice_id": "f2d84b1a-6c30-4e97-8a5b-1d9c7e3a40b2",
"payment_id": "a8e2c5f1-9d40-4b73-b6a2-0c7f3d18e594",
"amount": 13125,
"date": "2026-10-13",
"account": "1930",
"booked": true,
"invoice_status": "paid",
"paid_amount": 13125
}