Abonelik Yönetimi

Purvisor AI’daki abonelik akışının tamamı iyzico’nun barındırdığı ödeme formu üzerinden yürür — kart bilgin hiçbir zaman Purvisor sunucularına dokunmaz, doğrudan iyzico’ya girilir. Panelden abone ol, plan yükselt, kartını güncelle veya iptal et; arka planda bir webhook aboneliğinin gerçek durumunu (aktif, gecikmiş ödeme, iptal) sürekli Purvisor ile senkron tutar, sen elle bir şey işaretlemek zorunda kalmazsın.

Nasıl çalışır?

Panelde plan + dönem seç (Pro / Business × aylık / yıllık) → "Abone ol"
        ↓
Fatura profili tam mı? (TCKN/VKN, adres, şehir, posta kodu, telefon)
   ├─ Eksik → HTTP 422 (billing_info_required / valid_phone_required)
   │          → Fatura bilgileri formu açılır
   └─ Tam → iyzico'nun barındırdığı ödeme (checkout) formu döner
        ↓
Kart bilgisi iyzico'nun formunda girilir
        ↓
iyzico → callback (/api/billing/subscribe/callback) → abonelik durumu kaydedilir
        ↓
iyzico → webhook (/api/billing/iyzico/webhook) → kanonik durum senkronize edilir
        ↓
Abonelik "active" → plan özellikleri açılır + planına dahil aylık dakika cüzdanına eklenir

Ön koşullar

• Panelde tamamlanmış bir fatura profili: geçerli bir TCKN (bireysel) veya VKN (şirket), adres, şehir, posta kodu — bkz. Profil ve Fatura Bilgileri.
• Hesap profilinde geçerli bir telefon numarası (E.164’e normalize edilebilir olmalı — örn. 05xx xxx xx xx veya +90 formatı).
• Sadece Pro ve Business planlarına panelden self-servis abone olunabilir. Ücretsiz kademe için abonelik gerekmez (kayıt olduğunda zaten geçerlidir), Enterprise ise özel fiyatlandırma ve satış görüşmesi gerektirir. Plan karşılaştırması: Planlar.
• Abonelikte aylık veya yıllık dönem seçebilirsin; yıllık dönemde aylık eşdeğer fiyat daha düşüktür. Fiyatlar USD listelenir, tahsilat güncel kurla TL olarak yapılır.

Abone olma

Plan yükseltme

Plan değiştirmek “iptal + yeniden abone ol” değildir — iyzico’nun upgrade akışı kullanılır, böylece kart tekrar girilmez ve gün bazlı ücret orantılaması (proration) korunur. Yükseltme isteğinde iki zamanlama seçeneği vardır:

NEXT_PERIOD seçilirse hedef plan pendingPlanType alanında bekletilir; kullanıcının erişim planı değişmez — aksi halde düşük fiyata anında üst tier erişimi verilmiş olurdu. Yeni dönem başladığında webhook bu bekleyen planı otomatik uygular.

Zaten bulunduğun plana “yükseltme” isteği göndermek 409 Zaten bu plandasınız hatası döner.

Ödeme başarısız olursa (yeniden deneme)

Kart reddi, yetersiz bakiye gibi nedenlerle bir yenileme ödemesi başarısız olursa abonelik durumu past_due (gecikmiş ödeme) olarak işaretlenir. Panelde “Ödemeyi yeniden dene” butonu bu durumda görünür:

1. Purvisor iyzico’dan aboneliğin sipariş (order) geçmişini çeker.
2. SUCCESS olmayan ilk siparişi bulur.
3. O siparişi iyzico’nun /operation/retry uç noktasıyla yeniden dener.

Yeniden deneme başarılı olup abonelik hemen ACTIVE durumuna dönerse, Purvisor bunu senkron olarak da işler: premium erişim tekrar açılır ve varsa eski iptal tarihinden kalan kısıtlama (premiumExpiresAt) temizlenir. Webhook geldiğinde aynı durum ayrıca kanonik olarak teyit edilir.

Kart güncelleme

Kartın süresi dolduysa veya değiştiyse, aboneliği iptal etmene gerek yok — sadece kartı güncelle:

1. Panelde Kart bilgilerini güncelle butonuna tıkla.
2. Purvisor iyzico’dan yeni bir checkout form alır (mevcut abonelik referans koduyla ilişkilendirilmiş).
3. Yeni kart bilgilerini iyzico’nun formunda girersin; doğrulama için iyzico kart üzerinden küçük bir tutar (1 TL) çekip anında iade eder.
4. Form tamamlandığında iyzico Purvisor’ın callback adresine yönlendirir ve abonelik kartın üzerinde devam eder.

Abonelik iptali

Panelde Aboneliği iptal et dediğinde:

• İptal isteği iyzico’ya iletilir.
• Abonelik veritabanında canceled olarak işaretlenir.
• Mevcut ödediğin dönem sonuna kadar erişimin devam eder — eğer dönem bitiş tarihi (currentPeriodEnd) hâlâ ileri bir tarihse, premium erişimin o tarihe kadar (premiumExpiresAt) korunur ve dönem bitince otomatik düşer (ayrı bir cron işlemine gerek yoktur). Dönem bilgisi yoksa erişim hemen kesilir.

Webhook ile durum senkronu

POST /api/billing/iyzico/webhook — iyzico’nun abonelik yaşam döngüsü olaylarını (ödeme başarılı/başarısız, yükseltme, iptal, süre dolumu) Purvisor’a bildirdiği uç nokta. Bu senin elle tetiklediğin bir şey değil, ama işleyişini bilmek “neden panelim hemen güncellenmedi” sorusuna cevap verir.

Güvenlik: Her istek X-IYZ-SIGNATURE-V3 başlığındaki imzayla doğrulanır (HMAC-SHA256, merchant secret key ile). İmza uyuşmazsa 401 invalid_signature döner ve olay hiç işlenmez.

Kanonik durum ilkesi: Webhook, payload’daki alanlara güvenmek yerine subscriptionReferenceCode ile iyzico’dan aboneliğin güncel halini yeniden çeker — böylece olay sırası karışsa veya payload eksik olsa bile Purvisor’daki durum her zaman iyzico ile birebir eşleşir.

iyzico durumları Purvisor’ın kendi durum değerlerine şöyle eşlenir:

Webhook ayrıca NEXT_PERIOD yükseltmelerini de bu noktada uygular: abonelik active olduğunda ve fatura dönemi gerçekten yenilendiğinde (yeni dönem başlangıcı öncekinden ileriyse), bekleyen pendingPlanType otomatik olarak devreye girer.

Webhook, tanımadığı bir subscriptionReferenceCode veya abonelikle ilgisi olmayan olay türü görürse hata döndürmez — { ok: true, ignored: true } ile onaylar ki iyzico aynı olayı tekrar tekrar denemesin.

İşlem geçmişi

GET /api/billing/transactions panelde son 20 dakika hareketini döner — bu abonelik faturaları değil, dakika bakiyeni etkileyen hareketlerdir (kullanım ve dakika paketi satın alımları). Abonelik faturalarının kendisi iyzico tarafında tutulur; dakika paketleri ve tüketim için:

Dakika paketleri ve fiyatlandırma detayı için: Dakika Paketleri. Dakikaların arama sırasında nasıl düşüldüğü için: Dakika Nasıl Düşülür?.

Sorun giderme

İlgili