Üç App Store iade bildirimi Apple karar verdikten sonra gelir ve REFUND_REVERSED satışı size geri verir

Apple iadenize karar verir ve sonra konuşmaya devam eder. Sonuç belirlendiğinde, App Store sunucunuza üç App Store iade bildiriminden birini gönderir ve her biri farklı bir hamle ister. Bir REFUND, paranın gittiğini ve erişimi çekmeniz gerektiğini söyler. Bir REFUND_DECLINED, müşterinin talebi kaybettiğini ve satışı koruduğunuzu söyler. Bir REFUND_REVERSED, Apple'ın zaten verdiği bir iadeyi geri aldığını söyler, yani satış yine sizindir ve aldığınız her şeyi geri vermeniz gerekir. Çoğu uygulama ilkini bağlar ve diğer ikisini sessizce göz ardı eder. Ödeme yapan bir müşteri işte böyle, ödediği bir şeyden kilitlenip kalır.

Bu üçü, yanıt vermenizi isteyen tek iade mesajı olan CONSUMPTION_REQUEST'ten ayrıdır. Karar sonrası bildirimler bir tartışma istemez. Bir HTTP 200 ve müşterinin erişimine doğru değişikliği isterler. İşte her birinin ne anlama geldiği, gerçekleri taşıyan tam alanlar ve yanlış işlediğinizde paranın nereden sızdığı.

Dört iade bildirimi ve hangisi yanıt istiyor

App Store Server Notifications V2 tek bir akıştır. Onu bir URL'ye yönlendirirsiniz ve Apple her bildirim türünü oraya gönderir, dolayısıyla işleyin ya da işlemeyin dört iade mesajının tümünü zaten alırsınız. Türlerden dördü iadelere değinir ve yalnızca biri bir sorudur.

Bir REFUND bildirimi size gerçekte ne söyler

REFUND, App Store bir işlemi bir müşteriye başarıyla iade ettiğinde tetiklenir. Her satın alma türüne uygulanır: bir tüketilebilir, bir tüketilemez, bir otomatik yenilenen abonelik ve yenilenmeyen bir abonelik. Bildirimin içindeki imzalı işlem artık iadeden önce sahip olmadığı iki alan taşır ve bu iki alan işin tüm özüdür.

revocationDate ve revocationReason gerçekleri taşır

revocationDate, App Store'un işlemi iade ettiği veya iptal ettiği milisaniye cinsinden UNIX zamanıdır. revocationReason size iadenin kategorisini söyler ve tam olarak iki değer alır.

Bir işlemde revocationDate'in bulunması başlı başına işaretin kendisidir. Daha sonra bir işlemi çekerseniz ve onun bir revocationDate'i varsa, o satın alma iade edilmiştir, bildirim olsun ya da olmasın. Nedeni onun yanında okuyun ki tek bir sürümde değer-1 iadelerinden oluşan bir dalga gürültü gibi gözünüzden kaçmasın.

Ürüne göre değil, işleme göre iptal edin

Buradaki tuzak çok fazlasını iptal etmektir. Bir REFUND tek bir işlemi adlandırır. Size müşterinin o ürün kimliğiyle yaptığı her satın almayı devre dışı bırakmanızı söylemez. Apple'ın kendi rehberliği, herhangi bir şeyi kesmeden önce müşterinin hâlâ hangi erişime sahip olduğunu kontrol etmenizdir, çünkü hak sahiplikleri örtüşür. Klasik örnek bir aboneliktir: bir iade geçen ayın yenilemesine gelirken bu ayın yenilemesi etkin ve tam ödenmiştir. Ürüne göre iptal edin ve zaten sona ermiş bir dönem için yapılan bir iade yüzünden güncel, ödeme yapan bir müşteriyi kesip atmış olursunuz.

REFUND_DECLINED zaten kazandığınız anlamına gelir, o yüzden bunu geri almayın

REFUND_DECLINED, App Store müşterinin iade talebini reddettiğinde gelir. Müşteri istedi, Apple hayır dedi ve siz satışı korursunuz. İlk bakışta yapacak bir şey yoktur ve mesele de budur. Bu bildirimin açığa çıkardığı hata farklı bir hatadır: erişimi erken iptal etmek.

Kodunuz CONSUMPTION_REQUEST'e, Apple karar vermeden önce müşterinin erişimini çekerek tepki verirse, bir REFUND_DECLINED o kararın patladığı andır. Apple paranızı tuttu ve siz iadesi reddedilmiş bir müşteriyi kilitlediniz. O müşteri artık kullanamadığı bir ürün için ödeme yapar, bir destek talebi açar ve bunu hatırlar. Çözüm bir özellik değil, bir kuraldır: REFUND'da iptal edin, talepte asla değil. REFUND_DECLINED yalnızca Apple'ın, erken iptalin yanlış bir karar olacağını doğrulamasıdır.

REFUND_REVERSED, size geri ödeme yapan bildirimdir

REFUND_REVERSED, neredeyse kimsenin işlemediği bildirimdir ve size parayı geri getiren de odur. Apple bunu, daha önce verdiği bir iadeyi tersine çevirdiğinde gönderir, tipik olarak müşteri o iadeye itiraz ettikten sonra. Bir REFUND'un işleme eklediği iptal alanları yeniden kaldırılır, böylece satın alma yeniden ödenmiş olarak okunur. Apple, geliştiricinin işini tek satırda ifade eder: uygulamanız ilgili iade sonucunda içerik veya hizmetleri iptal ettiyse, onları geri yüklemesi gerekir. Bir tüketilebilirden otomatik yenilenen bir aboneliğe kadar her satın alma türüne uygulanır.

Haftalar sonrası sorunu

Geliştiricilerin Apple'ın kendi forumlarında dile getirdiği gerçek soru zamanlamadır. Bir REFUND_REVERSED, orijinal REFUND'dan haftalar sonra, bir abonelik dönemi sona erdikten çok sonra gelebilir. O zaman erişimi geri yükler misiniz? İşlemin gerçekte verdiği şeyi, o işlemin kapsadığı şeyle sınırlı olarak geri yükleyin. Bir tüketilebilir veya bir tüketilemez için kilidi yeniden açın. Zaten geçmiş bir abonelik dönemi için yeni süre dağıtmıyorsunuz, kaydı düzeltiyorsunuz ki müşterinin geçmişi doğru olsun ve hâlâ geçerli olan herhangi bir hak sahipliği yeniden devreye girsin. Belirli işlemi geri yükleyin ve örtüşme mantığınız şu anda neyin etkin olduğuna karar versin.

Bunu doğru yapmakta para nerede

Bu bildirimlerin her biri gerçek bir sayıya karşılık gelir ve onu yanlış işlemenin maliyeti yalnızca satış fiyatı değildir.

REFUND: iade edilmiş bir müşteriye hizmet etmek için ödeme yapmayı bırakın

REFUND geldiği an satış fiyatı gitmiştir. Hâlâ kontrol edebileceğiniz şey, sunmaya devam etmenin maliyetidir. İade edilmiş bir hak sahipliğinin etkin kaldığı her saat, müşterinin artık ödemediği şeylere harcamaya devam edersiniz: işlem gücü, model API çağrıları, depolama ve onun kullanımına bağlı herhangi bir içerik üreticisi ya da ortak ödemesi. REFUND'da hemen iptal etmek o sayacı durdurur. Bildirimi göz ardı etmek, mağazanın zaten telafi ettiği biri için bir ürünü finanse etmeniz anlamına gelir.

REFUND_DECLINED: bir kazancı iyi niyet iadesine dönüştürmeyin

Erken iptal ettiğinizde ve iade daha sonra reddedildiğinde, satışı kâğıt üzerinde korudunuz ama uygulamada kaybettiniz. Ödeme yapan müşteri ürünü kullanamaz, dolayısıyla bir destek görüşmesini ve çoğu zaman durumu düzeltmek için isteğe bağlı bir iadeyi devralırsınız. Bu, hiçbir zaman tehlikede olmamış tek bir satış için iki kez ödeme yapmaktır. REFUND_DECLINED'ı doğru işlemek hiçbir şeye mal olmaz, tam da bu yüzden REFUND'a kadar erişime dokunmadan bırakmak benimseyebileceğiniz en ucuz kuraldır.

REFUND_REVERSED: en kötü ikili, hem paralarının hem erişimlerinin gitmiş olmasıdır

REFUND_REVERSED'ı göz ardı edin ve tahtadaki en kötü sonuca ulaşırsınız. Size ödeme yapıldı ve müşterinin elinde hiçbir şey yok. İadeyi tersine çevirmek için bankasıyla zaten bir kez iletişime geçti ve artık ücretlendirildiği bir üründen kilitlenmiş biri, bankayla ikinci kez iletişime geçmesi muhtemel bir kişidir. O sonraki itiraz bir kart ters ibrazına dönüşebilir, ki bu banka nezdinde kesindir ve satışın hiç maliyet ettiğinden daha fazlaya mal olur. REFUND_REVERSED geldiği an erişimi geri yüklemek, tüm iade akışındaki en ucuz sigortadır.

Neyi bağlamalı

Model doğru olduğunda işleme küçüktür. Hak sahipliklerini işlem kimliğine göre anahtarlayın ki her bildirim tek bir satın almayı işaret etsin. CONSUMPTION_REQUEST'te verinizi 12 saat içinde gönderin. REFUND'da o işlemi iptal edin. REFUND_DECLINED'da hiçbir şey yapmayın. REFUND_REVERSED'da geri yükleyin. Hepsine hızlıca HTTP 200 döndürün ve erişim değişikliğini kendi zamanınızda yapın.

Bildirimlerin bıraktığı boşluk için Get Refund History uç noktasını kullanın. Bir kesinti sırasında sunucunuz kapalıysa ve bir REFUND'u kaçırdıysa, /inApps/v2/refund/lookup/{transactionId} adresinde bir işlem kimliği için App Store Server API iade aramasını çağırın ve imzalı işlemleri revocationDate ve revocationReason değerleriyle geri okuyun. Bir seferde tek bir işlemi eşleştirir ve müşterinin iade edilmiş satın alımları arasında sayfalar, böylece kaçırılan bir webhook kalıcı olarak yanlış ayarlanmış bir hak sahipliğine dönüşmez.

İşte bu, RefundHalt'ın sizin için çalıştırdığı kısımdır. Dört türün tümünü dinler, REFUND'da iptal eder, REFUND_DECLINED'da erişime dokunmadan tutar ve REFUND_REVERSED'da otomatik olarak geri yükler, her biri tam işleme anahtarlanmış olarak. Tersine çevrilmiş bir iade, ödeme yapan bir müşteri kilitli kalırken bir kuyrukta beklemez ve reddedilmiş biri, geri almanız gereken bir iptali asla tetiklemez.