Record invoice payment
Register and book a customer payment on an invoice.
MCP tool bokio_write → record_invoice_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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bokio_write",
"arguments": {
"operation": "record_invoice_payment",
"arguments": {
"invoice_id": "f2d84b1a-6c30-4e97-8a5b-1d9c7e3a40b2",
"date": "2026-10-13",
"amount": 13125,
"account": "1930"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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
},
"isError": false
}