> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tahsilat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Abonelik İptali

> Bir aboneliği API üzerinden iptal edin

Bir aboneliği kendi sisteminizden iptal etmek için bu ucu kullanın. Sonuç, panelden yapılan iptalle aynıdır: abonelik **İptal Edildi** durumuna geçer, planlanan tahsilatlar durur ve müşteriye iptal e-postası gönderilir.

***

> [!NOTE]
>
> İstek, Secret Key (`sk_test_` / `sk_live_`) ile alınan erişim anahtarıyla gönderilmelidir. Public Key ile alınan anahtar bu uçta `403` döner. Erişim anahtarı için [Token Alma](https://docs.tahsilat.com/direct-api-reference/get-token.md) sayfasına bakın.

`subscription_id`, webhook bildiriminde ve [İşlem Sonucu Sorgulama](https://docs.tahsilat.com/api-reference/transaction-result.md) yanıtında `subscription.subscription_id` alanında döner; panelde Abonelikler listesindeki "Abonelik Numarası" ile aynıdır.

İstek:

```curl cURL theme={null}
curl -L -X POST 'https://api.tahsilat.com/v1/subscriptions/19464539815644/cancel' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access_token}'
```

Yanıt:

```json JSON theme={null}
{
    "status": true,
    "message": "Abonelik iptal edildi.",
    "errors": [],
    "error_code": null,
    "data": {
        "subscription_id": 19464539815644,
        "status": 3,
        "cancelled_at": "2026-12-05T09:00:03+03:00",
        "status_text": "cancelled"
    }
}
```

## Parametreler

**subscription\_id** `integer` *required*

İptal edilecek aboneliğin 14 haneli kimliği. Adres içinde gönderilir; istek gövdesi boştur.

## Yanıt alanları

**data.subscription\_id** `integer`

İptal edilen aboneliğin kimliği.

**data.status** `integer`

Aboneliğin durumu. İptal sonrası `3` (İptal Edildi) döner; `status_text` aynı değerin metin karşılığıdır (`cancelled`).

**data.cancelled\_at** `datetime`

İptal tarihi.

## Davranış

* İptal anında geçerlidir ve geri alınamaz. Daha önce alınan ödemeler iade edilmez; gerekirse [iade](https://docs.tahsilat.com/api-reference/transaction-refund.md) ayrıca yapılır.
* Aynı abonelik için istek tekrarlanırsa hata dönmez: `200` ve "Abonelik zaten iptal edilmiş." mesajı gelir, `cancelled_at` ilk iptalin tarihidir.
* İlk ödemesi henüz yapılmamış (İlk Ödeme Bekleniyor) abonelik de iptal edilebilir; bu durumda müşteriye e-posta gitmez.
* Abonelik linki ve e-posta davranışının ayrıntısı için [Yaşam Döngüsü](https://docs.tahsilat.com/api-reference/subscriptions/lifecycle.md#iptal) sayfasına bakın.

## Hatalar

| HTTP | Kod | Durum |
| :- | :- | :- |
| 403 | 1002 | Erişim anahtarı geçersiz ya da süresi dolmuş. |
| 403 | 1005 | Erişim anahtarı Public Key ile alınmış. |
| 422 | 901 | Abonelik bulunamadı, başka bir firmaya ait ya da kimlik 14 haneli bir sayı değil. Ayrıntı `errors.subscription_id` alanındadır. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.