Abonelik API'si

Müşteri uygulaması tarafından aboneliklerle çalışmak için üç uç nokta bulunmaktadır: abonelik oluşturma, aboneliği iptal etme ve mevcut kullanıcının aktif aboneliklerinin listesini alma.

Tüm uç noktalar yetkilendirilmiş bir kullanıcı adına çalışır — abonelik her zaman talebin yapıldığı token ile ilişkilidir.

Abonelik Oluşturma

Mevcut kullanıcı için belirtilen token ile yeni bir abonelik oluşturur.

Davranış, aboneliğe bağlı ödeme hesabının türüne göre değişir modül ayarlarında:

• stripe, midtrans — abonelik kaydı oluşturulur ve ödeme bağlantısı döner. Abonelik, sağlayıcı tarafından başarılı bir şekilde tahsilat yapıldıktan sonra aktif hale gelir.
• custom — abonelik oluşturulur ve hemen aktif olarak kabul edilir. Ödeme bağlantısı döndürülmez, ödeme manuel olarak kullanıcı kartı üzerinden yönetici tarafından kaydedilir.

Aboneliği İptal Etme

Kullanıcının aktif aboneliğini hemen iptal eder.

Davranış, ödeme hesabının türüne bağlıdır:

• stripe, midtrans — abonelik sağlayıcının API'si aracılığıyla iptal edilir: otomatik tahsilatlar durdurulur, aboneliğin durumu canceled olarak değiştirilir.
• custom — API üzerinden iptal mümkün değildir. Bu tür abonelikler yalnızca yönetici tarafından kullanıcı kartı aracılığıyla iptal edilebilir.

bilgi

API üzerinden custom aboneliğini iptal etmeye çalışmak bir hata döndürecektir. Bu, kasıtlı olarak yapılmıştır: manuel abonelikler yönetici tarafından yönetilir, çünkü ödemeler sistem dışında gerçekleşir.

Aktif Abonelikleri Alma

Mevcut kullanıcının aktif aboneliklerinin token'larını içeren bir dizi döndürür.

Bir abonelik aktif olarak kabul edilir, eğer:

• Başarıyla oluşturulmuşsa.
• Mevcut dönemi henüz sona ermemişse.
• İptal edilmemişse (canceled).

Eğer abonelik sona ermişse veya iptal edilmişse, token otomatik olarak listeden kaybolur. Bu uç nokta, içerik erişimini kontrol etmek için istemcide kullanışlıdır: eğer dizide gerekli aboneliğin token'ı varsa — erişim sağlanır.