Add invoice payment
Record a payment received on an invoice, in full or in part.
POST https://cotlet.dev/api/v1/holded/invoices/{invoice_id}/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. |
Request
curl -X POST https://cotlet.dev/api/v1/holded/invoices/invoice_8c41d2/payment \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount":1,"payment_method":"payment method"}'result = client.call("holded", "add_invoice_payment", {"invoice_id":"invoice_8c41d2","amount":1,"payment_method":"payment method"})const result = await cotlet.call('holded', 'add_invoice_payment', {"invoice_id":"invoice_8c41d2","amount":1,"payment_method":"payment method"});cotlet call holded add_invoice_payment --data '{"invoice_id":"invoice_8c41d2","amount":1,"payment_method":"payment method"}'Example response
{
"invoice_id": "inv_7d31",
"payment_id": "pay_90e1",
"amount": 500,
"date": "2026-10-14",
"payment_method": "Bank transfer",
"open": 468
}