Bestellungen und Abos

Refund order

Als Markdown anzeigen Rohes Markdown in neuem Tab In ChatGPT öffnen Zu dieser Seite befragen In Claude öffnen Zu dieser Seite befragen

POST / v1 / orders / {order_id} / refund

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}.

Braucht deine Bestätigung MCP-Werkzeug refund_order

Ändert nichts sofort. Die Antwort enthält einen Link, den die Kontoinhaberin oder der Kontoinhaber in Tentary bestätigt. Bestätigungen

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

const response = await fetch("https://api.tentary.com/v1/orders/1003/refund", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/orders/1003/refund",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/orders/1003/refund');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Antwort

{
  "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."
}

Autorisierung

Authorization string Header erforderlich

Bearer tnt_… · A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Einführung

Pfad-Parameter

order_id integer erforderlich

The id from list_orders or get_order (not the order number).

min. 1 Beispiel: 1003

Antwort

Felder der Antwort mit Status 200. Fehler haben immer dasselbe Format, siehe Fehler.

The action waits for the seller's confirmation.

status string

Nothing happened yet.

Mögliche Werte: 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.