T-SOFT/Admin API/Uygulama abonelikleri

Uygulama abonelikleri

Mağazanın uygulamanızda kurulumda seçtiği planı temsil eder. Mağazaya hangi özellikleri açacağınıza bu kayda bakarak karar verirsiniz. Planları partner panelinde tanımlarsınız; akışın tamamı Faturalama rehberindedir.

Uç noktaMetotKapsam
/integration/app-subscriptionsGET—
/integration/app-subscriptions/{id}GET—

Bu uç noktalar kapsam istemez; mağazaya kurulu her uygulamanın token'ı çağırabilir. Uygulama yalnız kendi aboneliğini görür. Uygulama token'ı olmayan istek 403 alır. Abonelik kurulumda oluşur; uygulama abonelik oluşturamaz ve değiştiremez.

Abonelik nesnesi

AlanTipAçıklama
idstringAboneliğin kimliği (UUID). Mağaza başka plana geçince yeni bir kimlik oluşur. Salt okunur.
planIdstringSeçilen planın kimliği (UUID). Partner panelindeki planla aynıdır; özellikleri buna göre açın. Salt okunur.
namestringPlanın seçildiği andaki adı. Salt okunur.
pricestringPlanın seçildiği andaki KDV hariç fiyatı, iki ondalıklı: "399.00". Ücretsiz planda "0.00". Salt okunur.
currencystringPara birimi: TRY. Salt okunur.
intervalstringevery_30_days, annual, one_time. Salt okunur.
intervalDaysintegerDönem gün olarak: 30, 365; tek seferlik planda 0. Salt okunur.
trialDaysintegerDeneme süresi gün olarak. Deneme yoksa 0. Salt okunur.
freebooleanÜcretsiz planda true. Salt okunur.
statusstringactive, cancelled. Salt okunur. Ayrıntı aşağıda.
testbooleanHer zaman false. Salt okunur.
createdAtdatetimeAboneliğin oluşturulduğu zaman. Salt okunur.
activatedAtdatetimeAboneliğin başladığı zaman. Salt okunur.
cancelledAtdatetimeAboneliğin bittiği zaman. Bitmediyse null. Salt okunur.
{
  "type": "app-subscriptions",
  "id": "5d1c2e7a-8b3f-4f6e-9a21-7c4b0e9d1f30",
  "attributes": {
    "planId": "a3f0c9e2-1b7d-4c55-8e6a-2d9f4b8c7e10",
    "name": "Pro",
    "price": "1490.00",
    "currency": "TRY",
    "interval": "one_time",
    "intervalDays": 0,
    "trialDays": 0,
    "free": false,
    "status": "active",
    "test": false,
    "createdAt": "2026-11-14T10:00:00+03:00",
    "activatedAt": "2026-11-14T10:00:00+03:00",
    "cancelledAt": null
  },
  "links": {
    "self": "https://<domain>/api/v3/admin/2026-01/integration/app-subscriptions/5d1c2e7a-8b3f-4f6e-9a21-7c4b0e9d1f30"
  }
}

status

DeğerAnlamı
activeMağaza bu plandadır. Planın özelliklerini açın.
cancelledAbonelik bitti: mağaza başka plana geçti ya da uygulamayı kaldırdı.

Mağazanın en fazla bir active aboneliği olur. Durum değişince app_subscription.updated olayı gelir.

interval

DeğerAnlamı
every_30_daysAylık plan; her 30 günde bir yenilenir.
annualYıllık plan; her 365 günde bir yenilenir.
one_timeTek seferlik plan; bir kez ödenir, süresiz kullanılır.

Ücretsiz planın dönemi yoktur; interval değeri every_30_days döner, free alanına bakın.

Abonelikleri listeleme

Mağazanın uygulamanızdaki etkin aboneliğini döner. Mağaza plan seçmediyse ya da uygulamanızın planı yoksa liste boştur.

GET /integration/app-subscriptions
curl 'https://<domain>/api/v3/admin/2026-01/integration/app-subscriptions' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

Parametreler

Yok. Liste sayfalanmaz ve yalnız active aboneliği içerir. page, filter ve sort gönderirseniz 400 alırsınız.

Yanıt

200 ile en fazla bir abonelik nesnesinden oluşan bir dizi döner.

{
  "jsonapi": { "version": "1.0" },
  "data": [
    {
      "type": "app-subscriptions",
      "id": "5d1c2e7a-8b3f-4f6e-9a21-7c4b0e9d1f30",
      "attributes": {
        "planId": "a3f0c9e2-1b7d-4c55-8e6a-2d9f4b8c7e10",
        "name": "Pro",
        "price": "1490.00",
        "currency": "TRY",
        "interval": "one_time",
        "intervalDays": 0,
        "trialDays": 0,
        "free": false,
        "status": "active",
        "test": false,
        "createdAt": "2026-11-14T10:00:00+03:00",
        "activatedAt": "2026-11-14T10:00:00+03:00",
        "cancelledAt": null
      },
      "links": {
        "self": "https://<domain>/api/v3/admin/2026-01/integration/app-subscriptions/5d1c2e7a-8b3f-4f6e-9a21-7c4b0e9d1f30"
      }
    }
  ]
}

Hatalar

Durum koduKodSebep
400—page, filter ya da sort gönderildi

Aboneliği getirme

Tek bir aboneliği döner. Biten (cancelled) abonelik de okunur; webhook olayındaki kimliği doğrulamak için kullanın.

GET /integration/app-subscriptions/{id}
curl 'https://<domain>/api/v3/admin/2026-01/integration/app-subscriptions/5d1c2e7a-8b3f-4f6e-9a21-7c4b0e9d1f30' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

Parametreler

ParametreKonumTipZorunluAçıklama
idyolstringEvetAboneliğin kimliği

Yanıt

200 ile abonelik nesnesi döner.

{
  "jsonapi": { "version": "1.0" },
  "data": {
    "type": "app-subscriptions",
    "id": "5d1c2e7a-8b3f-4f6e-9a21-7c4b0e9d1f30",
    "attributes": {
      "planId": "a3f0c9e2-1b7d-4c55-8e6a-2d9f4b8c7e10",
      "name": "Pro",
      "price": "1490.00",
      "currency": "TRY",
      "interval": "one_time",
      "intervalDays": 0,
      "trialDays": 0,
      "free": false,
      "status": "active",
      "test": false,
      "createdAt": "2026-11-14T10:00:00+03:00",
      "activatedAt": "2026-11-14T10:00:00+03:00",
      "cancelledAt": null
    },
    "links": {
      "self": "https://<domain>/api/v3/admin/2026-01/integration/app-subscriptions/5d1c2e7a-8b3f-4f6e-9a21-7c4b0e9d1f30"
    }
  }
}

Hatalar

Durum koduKodSebep
404—Abonelik yok, başka bir uygulamanın ya da başka bir mağazanın