# Refund order

`POST https://api.tentary.com/v1/orders/{order_id}/refund`

Source: https://tentary.com/de/help/api/refund-order/
Area: Bestellungen und Abos
MCP tool: `refund_order`. Changes nothing at once. The answer has a link that the account owner confirms in Tentary.

---

Refunds a paid one-time order in full through its payment provider (Stripe, PayPal or Mollie). The buyer gets the money back, loses access and gets an email with a credit note if the order has an invoice. A checkout with order bumps is refunded as a whole.

Not possible for:

- subscriptions and installment plans (single payments are refunded in the Tentary app)
- free orders
- orders older than 179 days
- orders with a dispute

Partial refunds are only possible in the Tentary app.

**After the call:** the account owner confirms at the `confirm_url` within 5 minutes. Then check the result with [`GET /v1/confirmations/{confirmation_id}`](https://tentary.com/de/help/api/get-confirmation/).

## Authorization

`Authorization: Bearer <API key>`

A personal API key (tnt_...). Create it in the Tentary app on the page AI & API.

## Path parameters

- `order_id` (integer, required, path): The id from list_orders or get_order (not the order number). Limits: min 1.

## Response

The action waits for the seller's confirmation.

- `status` (string): Nothing happened yet. Allowed values: `needs_confirmation`.
- `confirmation_id` (integer): For get_confirmation.
- `confirm_url` (string<uri>): The seller opens it while logged in to Tentary and confirms.
- `expires_at` (string<date-time>): UTC, like 2026-01-31T14:05:00Z. The link works until then.
- `summary` (string): What the seller confirms.
- `message` (string): Next steps for the AI app.

## Example request

```bash
curl -X POST "https://api.tentary.com/v1/orders/1003/refund" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

## Example response

```json
{
  "status": "needs_confirmation",
  "confirmation_id": 7,
  "confirm_url": "https://app.tentary.com/ai/confirm/FTV_RV2Il93wZ8CXa00684Ce63-iyM-C",
  "expires_at": "2026-10-27T08:56:48Z",
  "summary": "Refund order R5D7H2B8 (31.20 EUR)",
  "message": "Nothing happened yet. Give the seller the confirm_url: they open it while logged in to Tentary and confirm within 5 minutes. Then call get_confirmation to see the result. If the link expired, call this tool again."
}
```