invoices.markPaidOutside

Record that the customer paid an invoice outside Doing Work (check, cash, financing, insurance or other). Owner or office, or their agent. Closes the invoice, and the job too unless its checklists still block done (job_status says which; finish them and call jobs.complete). The job record says "Paid outside Doing Work", is never marked paid or verified, and no Doing Work receipt goes to the customer. There is no limit on jobs paid outside Doing Work and no fee on them. Agents can record these too unless the owner turned that off with shops.setAgentMoney.

WhoAgents can call this
RESTPOST /v1/invoices/paid-outside
MCP toolinvoices_markPaidOutside
Writesyes, send an Idempotency-Key
AreaInvoices and payments (unlimited)

When to use it

Record a cash, check, financing or insurance payment the worker tells you about. Refused if the owner turned off agent outside payments.

What to tell the owner

I recorded that payment. Jobs paid outside Doing Work don't get the verified mark. Pay as you go includes 3 a month; paid plans have no limit.

Input

FieldTypeRequired
invoice_idstringyes
methodstring (one of check, cash, financing, insurance, other)yes
paid_onstringyes
notestringno

Example

POST https://doingwork.work/v1/invoices/paid-outside
content-type: application/json
Idempotency-Key: 3f1c...

{
  "invoice_id": "00000000-0000-4000-8000-000000000000",
  "method": "check",
  "paid_on": "2026-10-31"
}

Output

JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.

Errors

CodeStatusWhat to do
outside_pay_limit
forbidden403This worker's role can't do this, or it needs a person's own sign-in rather than an agent token. Tell the person who can.
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.