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

write Confirm

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

Parameters: register_invoice_payment
NameTypeDescription
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
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"}'
Python
result = client.call("fiken", "register_invoice_payment", {"invoice_id":1,"amount":1,"bank_account":"bank account"})
Node.js
const result = await cotlet.call('fiken', 'register_invoice_payment', {"invoice_id":1,"amount":1,"bank_account":"bank account"});
CLI
cotlet call fiken register_invoice_payment --data '{"invoice_id":1,"amount":1,"bank_account":"bank account"}'

Example response

JSON

{
  "invoice_id": 5120301,
  "invoice_number": 10037,
  "paid_amount": 15000,
  "payment_date": "2026-10-13",
  "bank_account": "1920:10001",
  "balance": 0,
  "status": "settled",
  "currency": "NOK"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.