Register invoice payment
Register a received payment, full or partial, on a customer invoice.
POST https://cotlet.dev/api/v1/fiken/invoices/{invoice_id}/payment
Registers a payment on one invoice with the bank account, the date and the amount you give, like Registrer ny innbetaling in Fiken. A payment lower than the balance leaves the invoice open for the rest; one that covers it marks the invoice as settled. Read the balance with get_invoice first, and take the bank account from list_bank_accounts. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| invoice_id integer required | integer | Invoice ID from list_invoices or create_invoice. |
| amount number required | number | Amount received, in the invoice currency. |
| payment_date date | date | Date the money arrived. Default: today. |
| bank_account string required | string | Account code from list_bank_accounts, e.g. 1920:10001. |
Request
curl -X POST https://cotlet.dev/api/v1/fiken/invoices/1/payment \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount":1,"bank_account":"bank account"}' result = client.call("fiken", "register_invoice_payment", {"invoice_id":1,"amount":1,"bank_account":"bank account"}) const result = await cotlet.call('fiken', 'register_invoice_payment', {"invoice_id":1,"amount":1,"bank_account":"bank account"}); cotlet call fiken register_invoice_payment --data '{"invoice_id":1,"amount":1,"bank_account":"bank account"}' Example response
{
"invoice_id": 5120301,
"invoice_number": 10037,
"paid_amount": 15000,
"payment_date": "2026-10-13",
"bank_account": "1920:10001",
"balance": 0,
"status": "settled",
"currency": "NOK"
}