Skip to content
TheChatArchiveThe Chat Archive
o1-mini-2024-09-12· OpenAIAi2 WildChat-4.8M (AI2)

Revenuecat webhook eventtypeları bana açıkla hangi durumlarda bu eventler gerçekleşir bu…

  1. User

    Revenuecat webhook eventtypeları bana açıkla hangi durumlarda bu eventler gerçekleşir bu eventler gerçekleştiğinde nasıl aksiyonlar alınmalı örneklerle açıkla Event Types

    Webhook Event Type Description App Store Play Store Amazon Stripe Promo TEST Test event issued through the RevenueCat dashboard. ✅ ✅ ❌ ❌ ❌ INITIAL_PURCHASE A new subscription has been purchased. ✅ ✅ ✅ ✅ ❌ RENEWAL An existing subscription has been renewed or a lapsed user has resubscribed. ✅ ✅ ✅ ✅ ❌ CANCELLATION A subscription or non-renewing purchase has been cancelled or refunded. Note that in the event of refunds, a subscription's auto-renewal setting may still be active. See cancellation reasons for more details. Note that, for the case of subscription refunds, this event is only fired if the latest subscription period of a subscription is refunded, refunds for earlier subscription periods do not trigger this event. ✅ ✅ ✅ ✅ ✅ UNCANCELLATION A non-expired cancelled subscription has been re-enabled. ✅ ✅ ✅ ❌ ❌ NON_RENEWING_PURCHASE A customer has made a purchase that will not auto-renew. ✅ ✅ ✅ ✅ ✅ SUBSCRIPTION_PAUSED The subscription has set to be paused at the end of the period. Please note: You should not revoke access when receiving a SUBSCRIPTION_PAUSED event, but only when receiving an EXPIRATION event (which will have the expiration reason SUBSCRIPTION_PAUSED). ❌ ✅ ❌ ❌ ❌ EXPIRATION A subscription has expired and access should be removed. If you have Platform Server Notifications configured, this event will occur as soon as we are notified (within seconds to minutes) of the expiration. If you do not have notifications configured, delays may be approximately 1 hour. ✅ ✅ ✅ ✅ ✅ BILLING_ISSUE There has been a problem trying to charge the subscriber. This does not mean the subscription has expired. Can be safely ignored if listening to CANCELLATION event + cancel_reason=BILLING_ERROR. ✅ ✅ ✅ ✅ ❌ PRODUCT_CHANGE A subscriber has changed the product of their subscription. This does not mean the new subscription is in effect immediately. See Managing Subscriptions for more details on updates, downgrades, and crossgrades. ✅ ✅ ❌ ✅ ❌ TRANSFER A transfer of transactions and entitlements was initiated between one App User ID(s) to another. Please note: The webhook will only be sent for the destination user despite us displaying this event in both customer histories because the event body is exactly the same for both users. ✅ ✅ ✅ ✅ ❌ SUBSCRIPTION_EXTENDED An existing subscription has been extended (the expiration date of the current subscription period has been pushed back to the future). This event is fired when a Apple App Store or Google Play Store subscription is extended through the store's API. On the Google Play Store, this event can also sometimes fire when Google defers charging for a renewal by less than 24 hours (for unknown reasons). In this case, you will receive a SUBSCRIPTION_EXTENDED webhook, followed by either a RENEWAL or BILLING_ISSUE webhook within the next 24 hours. ✅ ✅ ✅ ✅ ❌ TEMPORARY_ENTITLEMENT_GRANT RevenueCat was temporarily unable to validate a purchase with the respective store and has granted a short-term entitlement to the customer. This event is sent in exceptional situations (for example, a partial app store outage) and is used to avoid customers making a purchase but not getting access to their entitlement. The expiration date of the entitlement is always at most 24 hours in the future. Once the exceptional situation has been resolved and RevenueCat can validate the purchases, a regular INITIAL_PURCHASE event will be sent. If the purchase can't be validated, an EXPIRATION event with the same transaction_id is sent. Please note: because this event type is dispatched in cases of limited connectivity with the store servers, it contains less information than a regular purchase event. The following fields are guaranteed to be present: app_user_id, purchased_at_ms, expiration_at_ms, event_timestamp_ms, product_id, entitlement_ids, store, transaction_id (note: the transaction_id might be different from the store's transaction_id present in a subsequent INITIAL_PURCHASE event; depending on the store, the product_id might be different from the product_id present in the subsequent INITIAL_PURCHASE event). ✅ ✅ ✅ ✅ ❌ Events Format

    Webhook events are serialized in JSON. The body of a POST request to your server will contain the serialized event, as well as the API version.

    Code { "api_version": "1.0", "event": { "aliases": [ "yourCustomerAliasedID", "yourCustomerAliasedID" ], "app_id": "yourAppID", "app_user_id": "yourCustomerAppUserID", "commission_percentage": 0.3, "country_code": "US", "currency": "USD", "entitlement_id": "pro_cat", "entitlement_ids": [ "pro_cat" ], "environment": "PRODUCTION", "event_timestamp_ms": 1591121855319, "expiration_at_ms": 1591726653000, "id": "UniqueIdentifierOfEvent", "is_family_share": false, "offer_code": "free_month", "original_app_user_id": "OriginalAppUserID", "original_transaction_id": "1530648507000", "period_type": "NORMAL", "presented_offering_id": "OfferingID", "price": 2.49, "price_in_purchased_currency": 2.49, "product_id": "onemonth_no_trial", "purchased_at_ms": 1591121853000, "store": "APP_STORE", "subscriber_attributes": { "$Favorite Cat": { "updated_at_ms": 1581121853000, "value": "Garfield" } }, "takehome_percentage": 0.7, "tax_percentage": 0.3, "transaction_id": "170000869511114", "type": "INITIAL_PURCHASE" } }

    Common Fields

    Field Type Description Possible Values type String Type of the event. TEST, INITIAL_PURCHASE, NON_RENEWING_PURCHASE, RENEWAL, PRODUCT_CHANGE, CANCELLATION, BILLING_ISSUE, SUBSCRIBER_ALIAS, SUBSCRIPTION_PAUSED, UNCANCELLATION, TRANSFER, SUBSCRIPTION_EXTENDED id String Unique identifier of the event. app_id String Unique identifier of the app the event is associated with. Corresponds to an app within a project. This value will soon be visible in the app's configuration page in project settings. event_timestamp_ms Integer The time that the event was generated. Does not necessarily coincide with when the action that triggered the event occurred (purchased, cancelled, etc). app_user_id String Last seen app user id of the subscriber. original_app_user_id String The first app user id used by the subscriber. aliases Array All app user ids ever used by the subscriber. subscriber_attributes Array All attributes set for the customer, including common reserved attributes such as idfa,idfa, gpsAdId, campaign,campaign, keyword, etc. 📘 When looking up users from the webhook in your systems, make sure to search both the original_app_user_id and the aliases array. 📘 If we have to retry a webhook for any reason, the retry will have the same id and event_timestamp_ms of the first attempt.

  2. Assistant

    RevenueCat webhook event türlerini, bu eventlerin ne zaman tetiklendiğini ve bu durumlarda nasıl aksiyonlar almanız gerektiğini detaylı olarak aşağıda açıklıyorum. Her bir event türü için örnek senaryolar ve alınması gereken aksiyonları da ekledim.

    1. TEST

    Açıklama: RevenueCat kontrol paneli üzerinden test amaçlı gönderilen eventlerdir.

    Ne Zaman Tetiklenir: Geliştirme ve test aşamalarında RevenueCat dashboard'undan manuel olarak gönderilir.

    Alınması Gereken Aksiyonlar: Genellikle test ortamında kullanıldığı için bu eventler sırasında özel işlemler yapmanız gerekmez. Ancak, webhook entegrasyonunuzu doğrulamak için kullanılabilir.

    Örnek: Webhook entegrasyonunuzu test etmek için RevenueCat'dan bir TEST event’i gönderilir ve sunucunuzun doğru şekilde yanıt verip vermediğini kontrol edersiniz.


    2. INITIAL_PURCHASE

    Açıklama: Yeni bir abonelik satın alındığında tetiklenir.

    Ne Zaman Tetiklenir: Kullanıcı ilk kez abonelik satın aldığında (App Store, Play Store, Amazon, Stripe).

    Alınması Gereken Aksiyonlar:

    • Kullanıcıya abonelik erişimi sağlamak.
    • Veritabanınıza abonelik bilgilerini kaydetmek.
    • Teşekkür e-postası göndermek.

    Örnek: Bir kullanıcı uygulamanızda pro sürüme geçer ve bir aylık abonelik satın alır. Bu event alındığında, kullanıcının "pro_cat" yetkisini etkinleştirirsiniz ve ona hoş geldin mesajı gönderirsiniz.


    3. RENEWAL

    Açıklama: Mevcut bir abonelik yenilendiğinde veya feshedilmiş bir kullanıcı tekrar abone olduğunda tetiklenir.

    Ne Zaman Tetiklenir: Abonelik periyodu sona erdiğinde ve kullanıcı aboneliğini yenilediğinde.

    Alınması Gereken Aksiyonlar:

    • Kullanıcıya abonelik süresini uzatmak.
    • Ödeme bilgilerinin doğruluğunu kontrol etmek.
    • Kullanıcıya yenileme başarısını bildirmek.

    Örnek: Bir kullanıcının aylık aboneliği sona erip yeniden yenilendiğinde, abonelik süresini günceller ve kullanıcıya yeniden hoş geldiniz e-postası gönderirsiniz.


    4. CANCELLATION

    Açıklama: Bir abonelik veya tek seferlik satın alma iptal edildiğinde veya iade edildiğinde tetiklenir.

    Ne Zaman Tetiklenir: Kullanıcı aboneliğini iptal ettiğinde veya ödeme iadesi gerçekleştiğinde.

    Alınması Gereken Aksiyonlar:

    • Kullanıcının abonelik erişimini iptal etmek.
    • İade nedenlerini analiz etmek.
    • Kullanıcıya durum hakkında bilgilendirme yapmak.

    Örnek: Bir kullanıcı aboneliğini iptal ederse, "pro_cat" yetkisini kaldırır ve iptal doğrulama e-postası gönderirsiniz.


    5. UNCANCELLATION

    Açıklama: İptal edilmiş ve süresi dolmamış bir abonelik yeniden etkinleştirildiğinde tetiklenir.

    Ne Zaman Tetiklenir: Kullanıcı, iptal ettiği aboneliğini süresi dolmadan yeniden aktifleştirdiğinde.

    Alınması Gereken Aksiyonlar:

    • Kullanıcının abonelik erişimini yeniden sağlamak.
    • Kullanıcıya yeniden abone olduğu bilgisini göndermek.

    Örnek: Kullanıcı aboneliğini iptal ettikten sonra 7 gün içinde tekrar aktif ederse, abonelik süresini günceller ve kullanıcıya yeniden hoş geldiniz mesajı yollarsınız.


    6. NON_RENEWING_PURCHASE

    Açıklama: Müşteri, otomatik yenileme olmayan bir satın alma gerçekleştirdiğinde tetiklenir.

    Ne Zaman Tetiklenir: Kullanıcı tek seferlik bir satın alma (örneğin, reklam kaldırma) yaptığında.

    Alınması Gereken Aksiyonlar:

    • Kullanıcıya ilgili ürünü veya özelliği sağlamak.
    • Satın alma bilgisini kaydetmek.

    Örnek: Kullanıcı reklamsız sürüme geçmek için tek seferlik ödeme yaptıysa, reklamsız özelliği etkinleştirir ve teşekkür mesajı gönderirsiniz.


    7. SUBSCRIPTION_PAUSED

    Açıklama: Abonelik, mevcut dönemin sonunda duraklatılmak üzere ayarlandığında tetiklenir.

    Ne Zaman Tetiklenir: Kullanıcı aboneliğini duraklatma talebinde bulunduğunda.

    Alınması Gereken Aksiyonlar:

    • Subscriptions duraklatıldığında erişimi hemen kaldırmamak.
    • Duraklatma süresini izlemek ve dolduğunda erişimi iptal etmek.

    Örnek: Kullanıcı aboneliğini duraklatırsa, erişimini sürdürürsünüz ancak duraklatma süresini veritabanınızda işaretlersiniz. Süre sonunda kullanıcıya abonelik iptal edilirse erişimi kaldırırsınız.


    8. EXPIRATION

    Açıklama: Bir abonelik sona erdiğinde ve erişimin kaldırılması gerektiğinde tetiklenir.

    Ne Zaman Tetiklenir: Abonelik süresi dolduğunda veya ödeme alınamadığında (CANCELLATION eventıyla birlikte olabilir).

    Alınması Gereken Aksiyonlar:

    • Kullanıcının abonelik erişimini kaldırmak.
    • Kullanıcıya aboneliğin sona erdiğini bildirmek.

    Örnek: Bir kullanıcının aboneliği süresi dolduğunda, "pro_cat" yetkisini kaldırır ve aboneliğinin sona erdiğine dair bilgilendirme e-postası gönderirsiniz.


    9. BILLING_ISSUE

    Açıklama: Abonelik ücreti tahsil edilirken bir sorun oluştuğunda tetiklenir. Bu, aboneliğin sona erdiği anlamına gelmez.

    Ne Zaman Tetiklenir: Ödeme işlemi sırasında sorun yaşandığında (örneğin, kredi kartı reddedildi).

    Alınması Gereken Aksiyonlar:

    • Kullanıcıya ödeme sorununu bildirmek ve güncellemesini istemek.
    • CANCELLATION event'ını izlemek için gerekirse bu eventi kullanmak.

    Örnek: Kullanıcının kredi kartı bilgileri güncellenmediğinde, ona ödeme sorununu çözmesi için bir e-posta gönderirsiniz.


    10. PRODUCT_CHANGE

    Açıklama: Abone, abonelik ürününü değiştirdiğinde tetiklenir (örneğin, daha yüksek veya daha düşük bir plan seçtiğinde).

    Ne Zaman Tetiklenir: Kullanıcı mevcut aboneliğini başka bir abonelik ürününe yükselttiğinde veya düşürdüğünde.

    Alınması Gereken Aksiyonlar:

    • Kullanıcının yeni abonelik ürününe uygun şekilde erişimini güncellemek.
    • Eski abonelik özelliklerini kaldırmak ve yenileriyle değiştirmek.

    Örnek: Kullanıcı aylık abonelikten yıllık aboneliğe geçerse, abonelik süresini ve fiyatını güncelleyip kullanıcının yıllık plan özelliklerini aktif edersiniz.


    11. TRANSFER

    Açıklama: Bir kullanıcının abonelik ve haklarının başka bir kullanıcıya aktarılması başlatıldığında tetiklenir.

    Ne Zaman Tetiklenir: Kullanıcı abonelik haklarını başka bir App User ID'ye taşıdığında.

    Alınması Gereken Aksiyonlar:

    • Hedef kullanıcının abonelik haklarını güncellemek.
    • Orijinal kullanıcının abonelik haklarını koruyup korumayacağınızı belirlemek.

    Örnek: Bir kullanıcı aboneliğini farklı bir hesap ile kullanmak istediğinde, yeni kullanıcıya abonelik haklarını aktarır ve ilgili güncellemeleri yaparsınız.


    12. SUBSCRIPTION_EXTENDED

    Açıklama: Mevcut abonelik süresi uzatıldığında tetiklenir. Bu, abonelik süresinin mağaza API'si aracılığıyla uzatılması durumunda gerçekleşir.

    Ne Zaman Tetiklenir:

    • Apple App Store veya Google Play Store aboneliği API üzerinden uzatıldığında.
    • Google Play Store'da Google'ın yenilemeyi 24 saatten az bir süre ertelediği durumlarda.

    Alınması Gereken Aksiyonlar:

    • Abonelik süresini güncellemek.
    • Kullanıcıya abonelik uzatıldığını bildirmek.

    Örnek: Google Play Store üzerinden kullanıcının aboneliği uzatılırsa, abonelik süresini kaydeder ve kullanıcının süresinin uzadığını belirten bir e-posta gönderirsiniz.


    13. TEMPORARY_ENTITLEMENT_GRANT

    Açıklama: RevenueCat, ilgili mağaza ile doğrulama yapamadığında müşteriye kısa vadeli bir hak tanır.

    Ne Zaman Tetiklenir: Örneğin, mağaza sunucularında geçici bir kesinti olduğunda.

    Alınması Gereken Aksiyonlar:

    • Kullanıcıya geçici olarak erişim sağlamak.
    • Durum normale döndüğünde abonelik doğrulamasını tekrar yapmak.

    Örnek: Mağaza sunucularında geçici bir kesinti olduğunda, kullanıcıya 24 saatlik geçici "pro_cat" yetkisi verilir. Kesinti giderildiğinde, aboneliği doğrular ve normal INITIAL_PURCHASE event'i alırsınız.


    Webhook Event Formatı ve Ortak Alanlar

    Webhook eventleri JSON formatında gönderilir ve POST isteğinin gövdesinde bulunur. Aşağıda bazı ortak alanlar ve açıklamaları yer almaktadır:

    • type: Event türünü belirtir (örn. INITIAL_PURCHASE, CANCELLATION).
    • id: Event'in benzersiz tanımlayıcısı.
    • app_id: Event'in ilişkili olduğu uygulamanın kimliği.
    • event_timestamp_ms: Event'in oluşturulduğu zaman (ms cinsinden).
    • app_user_id: Abone olan kullanıcının son görülen App User ID'si.
    • original_app_user_id: Kullanıcının ilk App User ID'si.
    • aliases: Kullanıcının kullandığı tüm App User ID'leri.
    • subscriber_attributes: Kullanıcının ayarlanmış tüm özellikleri.

    Önemli Notlar:

    • Webhook'ları sunucunuzda işlerken hem original_app_user_id hem de aliases array'ini aradığınızdan emin olun.
    • Webhook'unuzu yeniden denediğinde, aynı id ve event_timestamp_ms değerleri kullanılır.

    Genel Öneriler ve İpuçları

    1. Güvenlik: Webhook endpoint'inizi güvenli hale getirin. RevenueCat'dan gelen istekleri doğrulamak için imzaları kontrol edin.
    2. Idempotency (Tekrarlanabilirlik): Aynı event'in birden fazla kez işlenmesi durumunda veritabanınızın tutarlılığını koruyun. Event id'sini kontrol ederek aynı event'i tekrar işlemeyin.
    3. Error Handling: Webhook işlemekte hata alırsanız, RevenueCat event'i yeniden gönderecektir. Hataları loglayın ve mümkünse otomatik olarak düzeltmeye çalışın.
    4. Test Etme: TEST event türünü kullanarak webhook entegrasyonunuzu kapsamlı bir şekilde test edin.
    5. Monitoring: Webhook işleme sürecinizi izleyin. Başarısız olan event'leri hızlıca tespit edip müdahale edebilmek için loglama ve uyarı mekanizmaları kurun.

    Örnek Senaryo

    Durum: Bir kullanıcı uygulamanızda aylık abonelik satın aldıktan sonra, ödeme bilgilerinde bir sorun yaşandı ve aboneliği iptal edilmek üzere.

    Webhook İşleme:

    1. INITIAL_PURCHASE Event'i Alındı:

      • Kullanıcının "pro_cat" yetkisini etkinleştirirsiniz.
      • Kullanıcıya hoş geldin e-postası gönderirsiniz.
    2. BILLING_ISSUE Event'i Alındı:

      • Kullanıcıya ödeme bilgilerindeki hatayı düzeltmesi için bir uyarı e-postası gönderirsiniz.
      • Kullanıcının aboneliği iptal edilmeden önce ödeme sorununu çözmesini beklersiniz.
    3. CANCELLATION Event'i Alındı:

      • Kullanıcının abonelik erişimini sonlandırırsınız.
      • Kullanıcıya aboneliğin iptal edildiğini bildiren bir e-posta gönderirsiniz.
    4. USER UNCANCELLATION Event'i Alındı:

      • Kullanıcı aboneliğini yeniden aktifleştirmişse, "pro_cat" yetkisini tekrar sağlarsınız.
      • Kullanıcıya yeniden hoş geldin mesajı gönderirsiniz.

    Bu senaryo, farklı event türlerinin nasıl bir arada çalıştığını ve kullanıcı abonelik yönetimini nasıl sağladığınızı göstermektedir.


    Bu açıklamalar ve örnekler, RevenueCat webhook eventlerini etkili bir şekilde kullanarak abonelik yönetiminizi optimize etmenize yardımcı olacaktır. Her event türünü dikkatlice işleyerek kullanıcı deneyimini iyileştirebilir ve abonelik süreçlerinizi daha güvenilir hale getirebilirsiniz.