Add invoice payment
Record a payment received on an invoice, in full or in part.
MCP tool holded_write → add_invoice_payment
write Confirm
Records one payment on an invoice with an amount, a date and a payment method. An invoice can have as many partial payments as you need, and open in the response shows what is left. Holded creates an accounting entry for each payment and adds it to the payments and collections list of the bank account or gateway. 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. |
| amount number required | number | Amount received, in the invoice currency. |
| date date | date | Payment date. Default: today. |
| payment_method string required | string | Payment method name as shown in Holded. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "holded_write",
"arguments": {
"operation": "add_invoice_payment",
"arguments": {
"invoice_id": "invoice_8c41d2",
"amount": 1,
"payment_method": "payment method"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoice_id": "inv_7d31",
"payment_id": "pay_90e1",
"amount": 500,
"date": "2026-10-14",
"payment_method": "Bank transfer",
"open": 468
},
"isError": false
}