Orders and subscriptions

Cancel subscription

View as Markdown Raw markdown in a new tab Open in ChatGPT Ask questions about this page Open in Claude Ask questions about this page

POST / v1 / orders / {order_id} / cancel-subscription

Stops the future payments of a subscription or an installment plan. access decides what happens to the access:

period_end (default): a subscription buyer keeps access until the paid period ends and gets an email. An installment buyer keeps access.
now: the buyer also loses access at once, without an email.

This does not refund anything. For a refund, use POST /v1/orders/{order_id}/refund or 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}.

Needs your confirmation MCP tool cancel_subscription

Changes nothing at once. The answer has a link that the account owner confirms in Tentary. Confirmations

curl -X POST "https://api.tentary.com/v1/orders/1002/cancel-subscription" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "access": "period_end"
}'

const response = await fetch("https://api.tentary.com/v1/orders/1002/cancel-subscription", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "access": "period_end"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/orders/1002/cancel-subscription",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "access": "period_end",
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/orders/1002/cancel-subscription');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'access' => 'period_end',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "status": "needs_confirmation",
  "confirmation_id": 6,
  "confirm_url": "https://app.tentary.com/ai/confirm/WD20opF2LF_oQWPWaq0NnMnxainfCvgk",
  "expires_at": "2026-10-27T08:56:48Z",
  "summary": "Cancel subscription P3T8W1N6",
  "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."
}

Authorization

Authorization string header required

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

Path parameters

order_id integer required

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

min 1 Example: 1002

Body application/json

access string

When the access ends. Default period_end.

Allowed values: period_endnow

Response

Fields of the answer with status 200. Errors always have the same format, see Errors.

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.