← Lifecycle Webhook'ları
Ne zaman Ödeme başarısız (gecikmiş) Geliştirici Degrade — premium özellikleri kısıtla Abonelik / gating Yok — bağlı (connected) her kuruluma her zaman gelir
Alan Tip Zorunlu Açıklama id string ✓ Idempotency anahtarı. Aynı id tekrar gelebilir (retry) → dedup et. type string ✓ "subscription.past_due" — event mi lifecycle mı olduğunu bununla ayırt et. version string ✓ Envelope şema versiyonu ("1"). tenantId string ✓ Hangi tenant (kurulum). İşlemini buna göre yap; cross-tenant doğrula. occurredAt number ✓ Oluşma zamanı (unix ms). data object ✓ Bu tipte boş ({}).
Bu tipte data boştur ({}) — gereken tüm bilgi tenantId + type'tadır.
Örnek webhook gövdesi (data alanı teyitli — webhook.site)
{
"id": "evt_9f2a7c1b",
"type": "subscription.past_due",
"version": "1",
"tenantId": "tnt_123",
"occurredAt": 1780000000000,
"data": {}
} Degrade et, SİLME: premium özellikleri kıs ama tenant verisini koru — bu durum geri dönüşlüdür. Tersine çevrilebilir kur: ödeme düzelince activated gelir → kısıtladığın her şeyi tam geri aç. Veri silme YASAK — silme yalnız app.uninstalled sinyalindedir. idempotent: aynı id tekrar gelirse degrade durumunu yeniden uygulamak no-op olmalı.