Skip to main content
Üyelik, bir kullanıcı ile bir ürün arasındaki aktif ilişkidir. Erişimi, faturalandırma durumunu ve yenileme takvimini izler. Üyelikleri doğrudan oluşturmazsınız, çünkü bunu ödeme sayfası sizin için yapar. Bir üyelik oluştuktan sonra onu okuyabilir, faturalandırmayı duraklatabilir veya iptal edebilir, ücretsiz süre tanımlayabilir ya da meta verileri güncelleyebilirsiniz.
Çoğu uygulamanın üyelikleri yönetmesine hiç gerek yoktur. Bu yöntemlere; yönetici araçları, müşteri destek akışları veya kullanıcıların duraklatma ya da iptal yapmasına olanak tanıyan self-servis panolar oluştururken başvurun.

Yaşam döngüsüne genel bakış

Getirme ve listeleme

Duraklatma ve devam ettirme

Duraklatma bir sonraki faturalandırma döngüsünü durdurur. Kullanıcı mevcut dönem bitene kadar mevcut erişimini korur, ancak yenileme gerçekleşmez. Otomatik devam ettirme planlamak için until iletin.

İptal

İki iptal modu vardır. cancel_at_period_end: true erişimi mevcut yenileme tarihine kadar korur ve ardından devre dışı bırakır. Erişimi hemen iptal etmek için bunu atlayın (veya false iletin).
cancel_at_period_end: true, üyelikteki cancel_at_period_end değerini true yapar. Kullanıcı yenilemeye kadar erişimini korur, ardından üyelik devre dışı kalır ve previous_attributes.status ayrıldığı duruma ayarlanmış şekilde membership.updated tetiklenir. Alanın atlanması erişimi hemen iptal eder; bu nedenle dönem sonunda iptal etmek istediğiniz her durumda bu alanı açıkça gönderin.

Bir iptali geri alma

Kullanıcı dönem bitmeden fikrini değiştirirse, bekleyen dönem sonu iptalini bir güncellemeyle temizleyin. Üyelik iptal için planlanmamışsa hiçbir etkisi olmaz.

Ücretsiz gün ekleme

Kullanıcıya mevcut döneminde ek süre tanımlayın. Bir sonraki yenileme tarihi days kadar ileri kayar. Hizmet kesintileri, destek jestleri veya yönlendirme ödülleri için kullanışlıdır.
days 1 ile 1095 (3 yıl) arasında değer kabul eder.

Meta verileri güncelleme

Üyelikteki rastgele meta verileri veya diğer yazılabilir alanları kısmi olarak güncelleyin.

Yaşam döngüsü olaylarını dinleme

Webhook’lar aracılığıyla abone olun. Yaşam döngüsü boyunca tetiklenen olaylar şunlardır: pause / resume / extend için üyelik durumu değişmez, bu nedenle hiçbir etkinleştirme/devre dışı bırakma olayı tetiklenmez. Değişikliğin başarılı olduğunu doğrulamanız gerekiyorsa çağrıdan sonra üyeliği getirin veya kendi takviminize göre yoklama yapın.

Sonraki adımlar

Ödeme kabul edin

Üyeliklerin kaynağı. Tek seferlik ve yinelenen ödeme sayfaları.

Ödeme yöntemlerini kaydedin

Gelecekteki yenilemeler ve oturum dışı faturalandırma için kayıtlı kartlar.

Webhook'ları dinleyin

Etkinleştirme, devre dışı bırakma ve iptal değişikliklerine tepki verin.

Memberships API referansı

Kaynağın tamamı: alanlar, durumlar ve her uç nokta.