Mark as paid

## Mark a CASH invoice as paid Manually settles the invoice `:id` when it was collected in **cash**. It moves the invoice to `Paid`, runs the whole paid-invoice pipeline (notifications, webhooks, settlement) and broadcasts the change over the websocket gateway. ### Auth `x-api-key` header with **`Merchant.invoice.patch`**. Also accepts JWT user, POS JWT and limited JWT tokens. ### Path params - `id` (required): the invoice id. ### Errors - **400** `Invoice is already in a paid status.` - **403** `You do not have permission to modify this invoice.` — the invoice belongs to another store. - **400** — the invoice's resolved payment method is not `CASH`. There is **no request body**. ### Side effects Sets the status to `Paid`, records a `MANUALLY_MARKED_AS_PAID` invoice event with the acting user id and runs `handlePaidInvoice`. Response: `{ status: "marked-as-paid" }`. --- **Notas:** Handler: statusService.markAsPaid(user, id, body?.storeId). Only invoices whose resolved payment method is CASH can be marked as paid. MarkAsPaidDto exposes an optional `storeId`, but getValidStoreId ignores it for non-POS callers (API key included) and always uses the store resolved from the credentials — so it is not documented as a body field. Replaces the deprecated PATCH /v1/invoice/:id/mark-as-paid, which took storeId as a query param.