--- title: invoices.pay | Doing Work API description: Start paying an invoice (hosted page). Returns the processor checkout URL. Final payment on an Idaho job over the threshold needs the payer to acknowledge. url: https://doingwork.work/docs/reference/invoices-pay/ --- # invoices.pay Start paying an invoice (hosted page). Returns the processor checkout URL. Final payment on an Idaho job over the threshold needs the payer to acknowledge the signed subcontractor list. Always collects on the shop's current active payments account; refused with payments_not_set_up while none is active, and with payments_paused while Stripe restricts the account, and with conflict on a Doing Work deposit invoice whose booking ended or whose no-show is disputed. | | | |---|---| | Who | Hosted page only (a person does it in the browser) | | REST | `POST /v1/invoices/pay` | | MCP tool | Not an MCP tool | | Writes | no | | Area | [Invoices and payments (unlimited)](https://doingwork.work/docs/reference/#invoices-and-payments-unlimited) | ## When to use it Never call it. The customer pays on the hosted page. ## What to tell the owner Your customer pays from the link. ## Input | Field | Type | Required | |---|---|---| | `t` | string | yes | | `n` | string | no | | `subcontractor_ack` | string (one of yes, no) | no | | `tip_minor` | integer | no | | `tip_percent` | string | no | ## Example ```http POST https://doingwork.work/v1/invoices/pay content-type: application/json Idempotency-Key: 3f1c... { "t": "..." } ``` ## Output JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are `{code, message, status}`. ## Errors | Code | Status | What to do | |---|---|---| | `human_only` | 403 | This step happens on a hosted page the person opens themselves. Send them the link; don't try another route. | | `invalid_link` | 400 | The link was used, expired, or replaced by a newer one. Get a new link. | | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |