invoices.refund
Refund part or all of a payment (owner or office). The refund shows up once the processor confirms it.
| Who | A person's own sign-in only (agent tokens are refused) |
| REST | POST /v1/invoices/refund |
| MCP tool | Not an MCP tool |
| Writes | yes, send an Idempotency-Key |
| Area | Invoices and payments (unlimited) |
When to use it
Agents can't call this. The owner or office refunds with their own sign-in.
What to tell the owner
Do the refund yourself with your own sign-in. It shows once Stripe confirms it.
Input
| Field | Type | Required |
|---|---|---|
charge_id | string | yes |
amount_minor | integer | yes |
Example
POST https://doingwork.work/v1/invoices/refund
content-type: application/json
Idempotency-Key: 3f1c...
{
"charge_id": "00000000-0000-4000-8000-000000000000",
"amount_minor": 50000
}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 |
|---|---|---|
forbidden | 403 | This 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. |
conflict | 409 | The record is in the wrong state for this, for example sending a quote that's already signed. Read it again and pick the next step. |
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |