cancel-subscription

POST /api/{team}/gateway/cancel-subscription

Aboneliği iptal eder. İade yapılmaz ve bundan sonra tahsilat yapılmaz.

İptal anındaki durum	Sonuç	Gönderilen webhook olayları
Ödenmiş ve bitmemiş bir dönemin içinde	status active kalır, cancelled_at dolar. Dönem bitince status cancelled olur.	Hemen cancelled; dönem bitince ended.
Ödenmiş bir dönemin içinde değil (pending, past_due)	status hemen cancelled olur.	cancelled ve ended.
Zaten iptal edilmiş	Değişiklik yapılmaz; güncel hâl döner.	Yok.

Webhook'lar yalnızca abonelik webhook_url ile açıldıysa gönderilir. Bkz. Abonelik webhook'u.

Kimlik doğrulama

X-Api-Key, X-Signature, Content-Type: application/json. Ayrıntılar: Kimlik Doğrulama ve İmza.

İstek

{
  "subscription": {
    "token": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d"
  }
}

Alan	Tip	Zorunlu	Açıklama
subscription.token	string (UUID)	evet	Aboneliğin token'ı. Çalışma alanınıza ait olmalıdır.

SDK örnekleri

PHP

use Gurmehub\Odemehub\Request\CancelSubscription;

$subscription = $client->cancelSubscription(new CancelSubscription(subscriptionToken: $token));

$subscription->cancelledAt;   // iptal anı
$subscription->endsAt;        // ödenmiş dönemin bitişi
$subscription->isCancelled(); // ödenmiş dönem sürüyorsa false

Node.js

const subscription = await client.cancelSubscription({ subscriptionToken: token });

subscription.cancelledAt;   // iptal anı
subscription.endsAt;        // ödenmiş dönemin bitişi
subscription.isCancelled(); // ödenmiş dönem sürüyorsa false

Python

from odemehub.request import CancelSubscription

subscription = client.cancel_subscription(CancelSubscription(subscription_token=token))

subscription.cancelled_at    # iptal anı
subscription.ends_at         # ödenmiş dönemin bitişi
subscription.is_cancelled()  # ödenmiş dönem sürüyorsa False

Java

import com.odemehub.request.CancelSubscription;

var subscription = client.cancelSubscription(new CancelSubscription(token));

subscription.getCancelledAt(); // iptal anı
subscription.getEndsAt();      // ödenmiş dönemin bitişi
subscription.isCancelled();    // ödenmiş dönem sürüyorsa false

cURL

BODY='{"subscription":{"token":"5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d"}}'
SIGNATURE=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$ODEMEHUB_API_SECRET" | sed 's/^.* //')

curl -X POST "https://odeme.gurmehub.com/api/$ODEMEHUB_TEAM/gateway/cancel-subscription" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Api-Key: $ODEMEHUB_API_KEY" \
  -H "X-Signature: $SIGNATURE" \
  --data-raw "$BODY"

Yanıt

Ödenmiş dönemin içinde iptal:

{
  "result": {
    "successful": true,
    "message": null
  },
  "subscription": {
    "token": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d",
    "channel_token": "6f1c2e7a-4b3d-4c8e-9a61-2f5d7b0c3e14",
    "channel_reference": "UYELIK-4471",
    "status": "active",
    "period": "monthly",
    "items": [
      { "channel_reference": "PREMIUM-AYLIK", "name": "Premium üyelik", "quantity": 1, "unit_amount": "149.90", "tax_rate": "20.00" }
    ],
    "amount": "149.90",
    "currency": "TRY",
    "is_test": false,
    "starts_at": "2026-09-29T10:15:00.000000Z",
    "ends_at": "2026-10-29T10:15:00.000000Z",
    "paid_at": "2026-09-29T10:15:00.000000Z",
    "cancelled_at": "2026-10-05T08:00:00.000000Z",
    "checkout_url": null
  }
}

Alanlar: Abonelik nesnesi.

HTTP durum kodları

Kod	Durum
200	İptal işlendi ya da abonelik zaten iptal edilmişti.
401	API anahtarı ya da imza geçersiz.
403	Çalışma alanı işlem yapamıyor.
422	subscription.token eksik, UUID değil ya da çalışma alanınıza ait değil.

Hatalar

Alan	Mesaj
subscription.token	Bu abonelik bulunamadı.