For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/mobile/revenuecat.md (or send Accept: text/markdown).
RevenueCat satın alımlarını kurun
Bir RevenueCat projesi oluşturun, App Store ve Play ürünlerinizi bağlayın ve satın alımları doğrulayan SDK anahtarları ile sunucu gizli değerlerini bağlayın.
Başlangıç seviyesinde izlenecek yol
Neden var: Apple ve Google uygulama içi dijital satın alımların kendi faturalandırmalarından geçmesini ister — asla Stripe Checkout'tan değil — ve kit bu sınırı uygular. RevenueCat her iki mağazanın üzerinde durur, böylece tek entegrasyon iOS ve Android'i kapsar: makbuzları, abonelikleri ve geri yüklemeleri izler ve sunucunuz RevenueCat'e bir çalışma alanının ödeme yapıp yapmadığını sorar.
Ön koşullar: mobil hesap rehberindeki Apple Developer Program (yıllık 99$) ve Google Play Console (25$ bir kerelik) hesapları — RevenueCat bunları bağlamadan önce mağaza ürünleri var olmalıdır — artı gerçekten test etmek için bir EAS geliştirme derlemesi, çünkü Expo Go yerel satın alma modülünü hiç çalıştıramaz. RevenueCat'in ücretsiz katmanı testi kapsar; ürünler canlıya çıkmadan önce bunlardan hiçbiri ücret almaz.
Kısa terimler: bir RevenueCat projesi mağazaya bağlı uygulamalarınızı tutar. Ürünler, RevenueCat içinde yansıtılan mağaza öğeleridir. Yetki, RevenueCat'in abonelik aktifken verdiği bayraktır — varsayılan pro. Offering, ürünleri uygulamanın sunduğu ödeme duvarında toplar. Genel SDK anahtarları mobil env'e girer; gizli API anahtarı ve webhook yetkilendirmesi sunucu tarafında kalır.
Oluşturacağınız şey: bir proje, mağazaya bağlı iki uygulama, ürünler, bir yetki, bir offering — yaklaşık bir saat, çoğunlukla mağaza ürünü kurulumunu bekleyerek.
RevenueCat hesabı ve projesi oluşturun
1. app.revenuecat.com → kaydolun ve ürününüzün adını taşıyan bir proje oluşturun.
Beklenen: Apps, Products, Entitlements, Offerings ve API keys sekmeleri olan boş bir proje gösterge paneli — sonraki bölümler bunları sırayla doldurur.
Mağaza ürünlerini oluşturun, ardından iki uygulamayı bağlayın
RevenueCat onlara atıfta bulunmadan önce mağaza tarafı ürünlerin var olması gerekir. iOS: appstoreconnect.apple.com → My Apps → ios.bundleIdentifier ile uygulama kaydı oluşturun → In-App Purchases veya Subscriptions → satmayı planladığınız abonelik ürünlerini oluşturun (test ederken taslak kalabilirler). Android: play.google.com/console → uygulamayı oluşturun → Monetize → Products → Subscriptions (veya uygulama içi ürünler).
Ardından RevenueCat içinde ikisini de bağlayın: Apps → New app. iOS için App Store'u seçin, bundle id'yi girin ve formun istediği App Store Connect kimlik bilgilerini sağlayın — her alan için RevenueCat'in kendi kurulum belgelerine bağlanır. Android için Play Store'u seçin, paket adını girin ve Play hizmet hesabı JSON'unu yükleyin — bağlantılı belgeler Google Cloud'da oluşturma sürecini adım adım anlatır.
Beklenen: iki uygulama projenin altında listelenir ve mağaza konsolları ürünlerinizin var olduğunu gösterir — bu aşamada taslak durumu sorun değildir.
Ürünler, yetki, offering
1. Products → New: mağaza ürünü başına bir RevenueCat ürünü oluşturun ve eşleşen App Store veya Play ürün kimliğini iliştirin — kimlikler konsollarla tam olarak eşleşmelidir.
2. Entitlements → New: REVENUECAT_ENTITLEMENT_ID ile eşleşen bir ad verin — kit'in varsayılanı pro — ve onu veren ürünleri iliştirin.
3. Offerings → New: bir offering oluşturun, ürünlerinizi işaret eden paketler ekleyin ve Current olarak işaretleyin — uygulama ödeme duvarını işlerken offerings.current okur.
REVENUECAT_ENTITLEMENT_KEY varsayılanını ai.reference-task tutun: bu kit'in iç defter anahtarıdır — gönderilen web planlarının verdiği aynı anahtar — ve RevenueCat erişimi onun altında yazılır. Yalnızca ürününüzün plan anahtarı değiştiğinde yeniden adlandırın.
Anahtarları kopyalayın ve webhook'u kaydedin
Project → API keys aşağıdaki üç türü listeler. Platform başına genel SDK anahtarları (iOS için appl_…, Android için goog_…) apps/mobile/.env.local içine girer — uygulamayı tanımlarlar, harcama yetkisi taşımazlar ve EXPO_PUBLIC_ ön eki onlar için doğrudur.
Gizli API anahtarı (sk_…, v1 anahtarı) ve webhook yetkilendirmesi apps/web/.env.local içinde yalnızca sunucudadır — asla EXPO_PUBLIC_ değil, asla commit değil. Sunucu, her çalışma alanının satın alma durumunu doğrulamak için gizli anahtarla RevenueCat'in abone API'sini çağırır.
Webhook: RevenueCat → Integrations → Webhooks → URL'yi {APP_URL}/api/billing/webhook/revenuecat ayarlayın ve bir Authorization üstbilgi değeri — kendinizin uydurduğu uzun rastgele bir dize — ayarlayın, ardından tam olarak aynı dizeyi REVENUECAT_WEBHOOK_AUTHORIZATION içine koyun. Kit üstbilgiyi birebir karşılaştırır ve diğer her şeyi reddeder, böylece yenilemeler, iptaller ve iadeler bir sonraki uygulama başlatmasını beklemeden sunucuya ulaşır.
Kum havuzu satın alımları üretim dışında otomatik olarak kabul edilir; üretim env'indeki REVENUECAT_ALLOW_SANDBOX=true başlangıçta reddedilir, bu yüzden canlıya çıktıktan sonra ayarlanmamış bırakın.
# apps/mobile/.env.local
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=revenuecat
EXPO_PUBLIC_REVENUECAT_IOS_API_KEY=appl_…
EXPO_PUBLIC_REVENUECAT_ANDROID_API_KEY=goog_…
# apps/web/.env.local — server side
MOBILE_PURCHASES_PROVIDER=revenuecat
REVENUECAT_SECRET_API_KEY=sk_…
REVENUECAT_WEBHOOK_AUTHORIZATION=<the exact Authorization value set on the webhook>
REVENUECAT_ENTITLEMENT_ID=pro
REVENUECAT_ENTITLEMENT_KEY=ai.reference-taskKum havuzu satın alımıyla doğrulayın
Satın alımlar yalnızca geliştirme veya üretim derlemesinin içinde çalışır — Expo Go yerel modülü tamamen yoksayar, bu yüzden bu adım eas build --profile development'ın bir geliştirme istemcisi ürettiğini varsayar (EAS rehberi onu derler).
1. Geliştirme derlemesini sandbox hesabına giriş yapmış bir cihaza veya simülatöre kurun: iOS için App Store Connect → Users and Access → Sandbox Testers; Android için Play Console → license testing.
2. Uygulamada ödeme duvarını açın ve sandbox hesabıyla satın alın. Beklenen: satın alma sandbox'ta tamamlanır — gerçek ücret yok — satın alımları geri yükleme çalışır ve çalışma alanının yetkisi ai.reference-task anahtarı altında sunucu tarafında kayıtlı aktif gösterir.
Yaygın hatalar: boş ödeme duvarı offering'in Current olmadığı veya ürünlerin bağlanmadığı anlamına gelir; başarısız cihaz satın alımı mağaza ürününün hâlâ taslakta olduğu veya yanlış sandbox hesabına giriş yapıldığı anlamına gelir; asla çevrilmeyen yetki MOBILE_PURCHASES_PROVIDER/EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER'ın kapalı olduğu veya webhook Authorization'ın uyuşmadığı anlamına gelir — RevenueCat'in gösterge paneli her webhook teslimatının durumunu listeler.