Dostlar merhaba, bugün yine teorik masalları bir kenara bırakıp, mutfakta canımızı en çok sıkan, uykumuzu kaçıran o meşhur konuya parmak basıyoruz: Mobil uygulamadan helalinden para kazanmak ve o paranın yolunu tıkır tıkır işleyen bir sisteme bağlamak.

Aylarca kod yazarsınız, uygulamanın arayüz mimarisini kurarsınız, ekran tasarımlarını ve sayfalar arası geçişleri kusursuz hale getirirsiniz; her şey harika gider. Ama iş o “satın al” butonuna basıldığı an arkada dönecek veri trafiğini, sunucu doğrulamasını kurmaya gelince işler değişir. Eskiden kendi sunucumuzda makbuz doğrulamaya (receipt validation) çalışır, Google’ın her API güncellemesinde kodların patlamasını izlerdik. Şimdi ise devir değişti. Bu yazıda size Google Play’in yasal ödeme sistemini, hayat kurtaran RevenueCat altyapısını ve işin analiz bacağını tutan Firebase üçlüsünü, araya hiçbir yabancı süslü kelime sıkıştırmadan, tamamen kendi tecrübelerimle anlatacağım. Kahvenizi alın, başlıyoruz.

Açık konuşalım; Google Play Faturalandırma kütüphanesini (Billing Library) doğrudan uygulama kodunun içine gömmeye kalkmak, tek başına büyük bir çiledir. Google her yıl bu kütüphaneyi günceller ve eski sürümleri zorunlu olarak tedavülden kaldırır. Eski sürümü es kaza güncellemeyi unuttuysanız, mağazadaki uygulamanıza yeni paket yükleyemezsiniz, eliniz kolunuz bağlanır. Üstelik bir kullanıcının aboneliğini iptal etmesi, ödemenin askıya alınması, süresinin uzatılması veya iade süreçlerini tek tek kodla arka planda yönetmeye kalkarsanız, saç baş yolarsınız.

İşte burada devreye güvenli bir köprü koyuyoruz. Bu köprünün adı RevenueCat. Kendisi, Google sunucularından gelen karmaşık ödeme sinyallerini ve makbuz kodlarını alır, temiz bir dille bizim uygulamamıza aktarır. Yani biz her defasında Google’ın değişen kod yapısıyla, kütüphane güncellemeleriyle uğraşmak yerine, bu sistemi bir kere kurup projemizin mimarisine odaklanıyoruz.

İşe ilk olarak mutfağın sahibiyle anlaşarak başlıyoruz. Google Play Konsoluna girip uygulamanızı seçin. Sol menüde para kazanma seçeneklerinin altında yer alan “Uygulama içi ürünler” veya “Abonelikler” kısmına gelin.

Burada dikkat etmeniz gereken en önemli şey, ürün kimliklerini (ID) çok düzenli belirlemek. Sonradan bunları değiştiremezsiniz. Örneğin, aylık premium üyelik paketi için aylik_premium_paket gibi Türkçe karakter içermeyen, net isimler seçin. Fiyatlandırmayı ve vergileri ayarladıktan sonra burayı kaydedin.

Ardından en kritik yere geliyoruz: Google Cloud üzerinden bir hizmet hesabı (Service Account) açıp, RevenueCat’in sizin adınıza Google sunucularıyla konuşabilmesi ve abonelik durumlarını sorgulayabilmesi için bir yetki anahtarı dosyası almanız gerekiyor. Bu API yetkisini vermezseniz, sistem çalışmaz.

Google tarafı hazırsa, şimdi bu sistemi kolaylaştıracak paneli açalım. Revenue Kelimesinin gelir anlamına geldiğini zaten biliyorsunuz, yani burası bizim gelir zincirimiz. Panelde yeni bir proje oluşturup uygulamanızın paket adını (package name) giriyorsunuz.

Az önce Google Cloud’dan aldığınız o yetki anahtarı dosyasını buraya yüklüyorsunuz. Sistem bağlantıyı kurduğu an, Google Play’de açtığınız aylik_premium_paket isimli ürünü otomatik olarak panelde görecektir. Burada yapmanız gereken en güzel ayar, bir “Teklif” (Offering) yapısı oluşturmaktır. Kullanıcıya göstereceğiniz satın alma ekranının arkasındaki mantığı burada bağlarsınız. Yarın bir gün fiyatı veya paketi değiştirmek isterseniz, uygulamaya yeni güncelleme atmadan sadece bu panelden her şeyi yönetebilirsiniz.

Parayı güvenli yola bağladık, köprüyü kurduk ama hangi kullanıcının ne yaptığını bilmezsek önümüzü göremeyiz. Kim uygulamayı indirdi, kim ödeme ekranına kadar gelip vazgeçti, kim aboneliği başlattı? Bunları bilmek zorundayız. İşte burada Firebase devreye giriyor.

Firebase SDK kurulumunu zaten uygulamanıza yaptığınızı varsayıyorum. RevenueCat panelinde entegrasyonlar bölümü vardır. Oraya girip Firebase seçeneğini aktif ediyorsunuz. Bu sayede, bir kullanıcı abonelik satın aldığında RevenueCat arka plandan Firebase’e anlık bir sinyal gönderir: “Bu kullanıcı satın alım yaptı!”

Böylece Firebase panelinde anlık olarak gelir akışınızı, kullanıcı alışkanlıklarını ve reklam dönüşümlerini tek bir ekrandan, hiçbir ek kod yazmadan izleyebilirsiniz.

Sistemleri panellerden bağladıktan sonra iş uygulamamızın içine birkaç satır saf kod eklemeye kalıyor. Uygulama ilk açıldığında, ana kod bloğunun içinde bu sistemi kendi uygulama API anahtarımızla başlatıyoruz (initialize ediyoruz).

Kullanıcı premium butonuna bastığında ise tek yapmamız gereken, hazırladığımız teklif paketini çağırmak. Sistem kullanıcıyı otomatik olarak Google Play’in o güvenli, yasal ödeme arayüzüne fırlatır. Kullanıcı parmak izini okutup ödemeyi yaptığı an, RevenueCat bize “İşlem başarılı, bu kullanıcı artık premium yetkisine sahip” bilgisini döner. Biz de yerel veritabanımızda veya sunucumuzda ilgili kullanıcının yetkisini açarız. Ne bir eksik, ne bir fazla.

Dostlar, bu tarz ödeme sistemlerinde canlıya çıkmadan önce mutlaka Google Play Konsolunda “Lisans Test Kullanıcıları” kısmına kendi e-posta adresinizi ekleyin. Böylece kendi kartınızdan gerçek para çekilmeden, test kartlarıyla sistemi yüzlerce kez deneyebilirsiniz. Abonelik yenileme süreleri test modunda birkaç dakikaya düşer; böylece aboneliğin bitişini, yenilenmesini ve iptal süreçlerini günlerce beklemeden yarım saatte test edip sistemin doğruluğundan emin olursunuz.

Bu yapıyı bir kez kurduğunuzda, arkanıza yaslanıp sadece projenizi büyütmeye odaklanabilirsiniz. Unutmayın, düzgün bir ödeme altyapısı olmayan uygulama, dükkanı açıp kasayı koymayı unutmaya benzer.

Umarım bu makalem uygulamanıza yasal ödeme yollarını eklerken rehberiniz olur. Kafanıza takılan teknik bir detay veya takıldığınız bir panel ayarı olursa, biliyorsunuz, sitenin özel mesajlaşma sisteminden bana her zaman ulaşabilirsiniz. Klavyenize zeval gelmesin, bol kazançlar!