Yenile

Bir aboneliği bir sonraki döngü için yenileyin. Durumu active olarak ayarlar, ended_at'i temizler, yenileme sayısını artırır, son yenileme zamanını damgalar ve bir renewed olayı kaydeder.

POST/v1/superuser/subscriptions/renew

İstek Gövdesi

Alan	Tür	Zorunlu	Notlar
`external_id`	string	Evet	Mevcut bir aboneliği referans almalı
`period`	string	Hayır	Aboneliğin mevcut periyoduna varsayılır
`due_at`	datetime	Hayır	Atlanırsa, mevcut `due_at`'tan (veya şu andan) bir `period` ileri taşınır

Yenileme tarihini API'nin bir periyot otomatik ilerletmesi için due_at'i atlayın. due_at'i yalnızca faturalandırma sisteminiz belirli bir sonraki tarih dayattığında gönderin.

Örnek İstek

bash

curl -X POST "https://marka.prod.loyetta.com/api/v1/superuser/subscriptions/renew" \
  -H "Authorization: Bearer loy_sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "external_id": "sub_12345"
  }'

Yanıt (200 OK)

json

{
  "success": true,
  "data": {
    "id": "01JQ...",
    "external_id": "sub_12345",
    "product_id": "01JQ...",
    "user_id": "01JQ...",
    "status": "active",
    "period": "monthly",
    "started_at": "2026-03-26T00:00:00.000000Z",
    "ended_at": null,
    "due_at": "2026-05-26T00:00:00.000000Z"
  }
}

Hata Yanıtları

403 — Yasak (token super_user yetkisine sahip değil)

json

{
  "message": "Operation not allowed."
}

422 — Doğrulama Hatası (ör. bilinmeyen external_id)

json

{
  "message": "The given data was invalid.",
  "errors": {
    "external_id": ["The selected external id is invalid."]
  }
}