Uygulamanız hâlâ App Store Server Notifications V1 kullanıyorsa, Apple abonelik iadeleri hakkında size hiçbir zaman soru sormaz

App Store Server Notifications'ın Version 1'i iadeleri hâlâ iletiyor, ancak bir abonelik iadesine itiraz etmenizi sağlayan tek bildirimi dışarıda bırakıyor. Apple, V1'i 5 Haziran 2023'te verifyReceipt uç noktasıyla birlikte kullanımdan kaldırdı ve o tarihten bu yana eklediği her iade özelliğini yalnızca V2'ye ekledi. App Store Connect ayarlarınızda hâlâ Version 1 yazıyorsa, Apple sunucunuza hiçbir zaman CONSUMPTION_REQUEST göndermeden bir abonelik iadesine karar verebilir. Orada bir mücadeleyi kaybetmezsiniz. O mücadeleye hiç davet edilmezsiniz.

App Store Server Notifications V1'in kullanımdan kaldırılması ne anlama geliyor

Kullanımdan kaldırılmak, kapatılmak demek değil. Bir Apple mühendisi Haziran 2023'te geliştirici forumlarında, verifyReceipt ve V1 bildirimlerinin bir kullanım sonu tarihi açıklanana kadar çalışmaya devam edeceğini, bu tarihin henüz belirlenmediğini ve geliştiricilere önceden haber verileceğini yazdı. Üç yılı aşkın bir süre sonra bile App Store Connect, sunucu URL'si ayarlarken "Version 1 (deprecated)" seçeneğini hâlâ sunuyor.

Kullanımdan kaldırılmanın asıl anlamı donmaktır. Haziran 2023'ten bu yana Apple'ın bildirim değişiklik günlüğündeki her değişiklik bir V2 değişikliğidir: imzalı işlemde yeni alanlar, yeni bildirim türleri, Nisan 2026'da eklenen 12 aylık taahhüt verileri. Bir V1 sunucusu bunların hiçbirini görmez.

Bir V1 sunucusunun hiçbir zaman almadığı iade sinyalleri

Apple'ın her sürüme ait belgelerine göre, aynı iade olaylarının bir V1 sunucusuna ve bir V2 sunucusuna nasıl ulaştığı aşağıda.

V1 hâlâ CONSUMPTION_REQUEST alıyor mu?

Evet, tüketilebilir ürünler için. Apple'ın V1 başvuru belgesi CONSUMPTION_REQUEST'i, müşteri tüketilebilir bir uygulama içi satın alma için iade talebi başlattığında gönderilen bildirim olarak tanımlar. Bir Apple mühendisi 2023'te forumlarda, uygun iadeler için V1 tüketim taleplerinin gönderildiğini doğruladı. Eksik olan abonelikler. Apple'ın değişiklik günlüğü abonelik tüketim taleplerini 11 Nisan 2024 tarihine ve V2'ye bağlar. Send Consumption Information belgeleri de Apple'ın talebi V2 uç noktanız üzerinden gönderdiğini belirtir.

V1'de CANCEL neden kolayca yanlış anlaşılır

V1'de Apple bir aboneliği iade ettiğinde bildirim türü CANCEL olur ve çoğu zaman DID_CHANGE_RENEWAL_STATUS ile birlikte gelir. Pek çok sunucu her iptali, müşterinin otomatik yenilemeyi kapatması olarak ele alır ve erişimi dönem sonuna kadar açık bırakır. V2 bu belirsizliği ortadan kaldırır. İade REFUND olarak gelir, yenilemeyi kapatan müşteri ise AUTO_RENEW_DISABLED alt türüyle DID_CHANGE_RENEWAL_STATUS olarak gelir.

V1'de kalmanın parasal maliyeti

Her App Store iadesine Apple karar verir. CONSUMPTION_REQUEST, kullanım verilerinizin bu karara ulaştığı tek noktadır ve Apple sizden 12 saat içinde yanıt vermenizi ister. V1'de abonelik iadeleri bu adımı atlar.

Aşağıda temsili rakamlarla hazırlanmış bir örnek var. Uygulamanızın, yapay zekâ ile görsel üretimi içeren $9.99 tutarında aylık bir abonelik sattığını varsayalım. Bir abone bir ayda 400 üretim yapıyor ve her biri model çıkarımı için size gerçek para olarak mal oluyor. Sonra Apple'dan iade istiyor.

Kaybettiğiniz ödeme liste fiyatı değil, sizin payınızdır. Apple, abonenin ücretli hizmetinin ilk yılında abonelik fiyatının geçerli vergiler düşüldükten sonra %70'ini, sonrasında veya App Store Small Business Program üyeleri için %85'ini öder. İşlem gücü faturası bununla birlikte küçülmez. Çıkarım, üçüncü taraf API çağrıları ve dosya depolama, müşteri bunları kullandığında ödenmişti.

Eksik olan iki sonuç bildirimi de para kaybettirir. REFUND_REVERSED olmadan, iade üzerine erişimi iptal eden bir sunucu, Apple iadeyi geri aldığında erişimi hiçbir zaman geri vermez. Böylece ödeme yapan bir müşteri dışarıda kalır ve desteğe yazar. REFUND_DECLINED olmadan da hâlâ beklemede olan bir iadeyi Apple'ın reddettiği bir iadeden ayırt edemezsiniz.

Tek bir iadeyi kaybetmeden V1'den V2'ye nasıl geçilir

V2'ye geçmek bir sunucu değişikliği ile tek bir ayardan ibarettir. Aralık 2025'te bir App Store Commerce Engineer'ın forumlarda paylaştığı Apple'ın kendi rehberi, geçiş yaptığınız gün neler olduğunu açıklar.

Ayarı değiştirmeden önce V2 uç noktasını oluşturun

• Gövdesinde signedPayload taşıyan bir POST isteğini kabul edin. V2 yükleri Apple tarafından imzalanmış JWS'dir, bu yüzden içindeki herhangi bir şeye güvenmeden önce imzayı doğrulayın. Apple'ın App Store Server Library'si bunu sizin için yapar.
• CANCEL işlemesini REFUND ile eşleyin, REFUND_DECLINED ve REFUND_REVERSED'i de yeni durumlar olarak ele alın.
• Abonelikler için CONSUMPTION_REQUEST'e Send Consumption Information ile yanıt verin ve bunu yalnızca müşteri Apple ile veri paylaşımına onay verdiyse yapın. Apple, onay olmadan yanıt vermemeniz gerektiğini söylüyor.
• Başarı durumunda HTTP 200 ile 206 arasında bir kod döndürün. Herhangi bir 40x veya 50x, Apple'ın yeniden denemesine yol açar.

Ayarı App Store Connect'te değiştirin

App Store Connect'te uygulamanızı açın, General altında App Information'ı seçin, App Store Server Notifications bölümünü bulun ve Version 2 seçili olarak Production Server URL'yi V2 uç noktanıza ayarlayın. Test etmek istiyorsanız önce sandbox URL'si için de aynısını yapın ve sunucunuzun yanıt verdiğini doğrulamak için Request a Test Notification'ı kullanın.

V1 işleyicisini yaklaşık üç gün çalışır durumda tutun

Geçişten sonra yeni bildirimler, eski ya da yeni her abonelik için hemen V2 biçiminde gelir. Hâlihazırda yeniden deneme sürecindeki V1 bildirimleri ise başarılı olana veya denemeleri tükenene kadar V1 biçiminde gelmeye devam eder. Apple, olası son V1 yeniden denemesini yaklaşık 78. saate koyar, yani 6 + 24 + 48. Eski işleyiciyi bu sürenin ötesinde de çalıştırın, sonra kaldırın.

Hazır başlamışken verifyReceipt'i de değiştirin

verifyReceipt da aynı gün kullanımdan kaldırıldı. Hâlâ yanıt veriyor, ancak Apple sunucuları bunun yerine App Store Server API'ye yönlendiriyor. Get Transaction Info tek bir imzalı işlem döndürür, Get Transaction History bir müşterinin geçmişini döndürür ve Get Refund History bir müşterinin iade edilen tüm satın almalarını listeler. V2 bildirimleriyle birlikte bunlar, çoğu sunucunun makbuzları kullandığı her şeyi karşılar. Buna eskiden makbuzda bir iadeyi işaretleyen cancellation_date alanı da dahildir.

RefundHalt, App Store Server Notifications V2'ye bağlanır ve uygulamanızın zaten kaydettiği kullanım verilerini kullanarak her CONSUMPTION_REQUEST'e 12 saatlik süre içinde yanıt verir. Hâlâ V1 kullanıyorsanız, tüm bunları mümkün kılan adım geçiştir.