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ç nokta | Metot | Kapsam |
|---|---|---|
/integration/app-subscriptions | GET | — |
/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
| Alan | Tip | Açıklama |
|---|---|---|
id | string | Aboneliğin kimliği (UUID). Mağaza başka plana geçince yeni bir kimlik oluşur. Salt okunur. |
planId | string | Seçilen planın kimliği (UUID). Partner panelindeki planla aynıdır; özellikleri buna göre açın. Salt okunur. |
name | string | Planın seçildiği andaki adı. Salt okunur. |
price | string | Planın seçildiği andaki KDV hariç fiyatı, iki ondalıklı: "399.00". Ücretsiz planda "0.00". Salt okunur. |
currency | string | Para birimi: TRY. Salt okunur. |
interval | string | every_30_days, annual, one_time. Salt okunur. |
intervalDays | integer | Dönem gün olarak: 30, 365; tek seferlik planda 0. Salt okunur. |
trialDays | integer | Deneme süresi gün olarak. Deneme yoksa 0. Salt okunur. |
free | boolean | Ücretsiz planda true. Salt okunur. |
status | string | active, cancelled. Salt okunur. Ayrıntı aşağıda. |
test | boolean | Her zaman false. Salt okunur. |
createdAt | datetime | Aboneliğin oluşturulduğu zaman. Salt okunur. |
activatedAt | datetime | Aboneliğin başladığı zaman. Salt okunur. |
cancelledAt | datetime | Aboneliğ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ğer | Anlamı |
|---|---|
active | Mağaza bu plandadır. Planın özelliklerini açın. |
cancelled | Abonelik 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ğer | Anlamı |
|---|---|
every_30_days | Aylık plan; her 30 günde bir yenilenir. |
annual | Yıllık plan; her 365 günde bir yenilenir. |
one_time | Tek 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.
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 kodu | Kod | Sebep |
|---|---|---|
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.
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
| Parametre | Konum | Tip | Zorunlu | Açıklama |
|---|---|---|---|---|
id | yol | string | Evet | Aboneliğ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 kodu | Kod | Sebep |
|---|---|---|
404 | — | Abonelik yok, başka bir uygulamanın ya da başka bir mağazanın |