Infumar
Geliştirici sayfası

Uygulama içi satın alma rehberi

RevenueCat kullanan bir mobil uygulamada influencer kampanyası: takipçi influencer'ın kodunu uygulamada girer, kodla yapılan satın almalardan influencer komisyon kazanır.

Nasıl çalışır

İki bağımsız kanıt birlikte aranır. Satın almanın kampanyadan geldiğini mağazanın kendi kaydı söyler: satın alma, Infumar'ın uygulamanız için ürettiği kampanya teklifiyle yapılmıştır. Hangi influencer'dan geldiğini uygulamanızın RevenueCat'e yazdığı infumar_code özelliği söyler. Satış, RevenueCat'in imzalı webhook'uyla bize ulaşır; tutar mağazanın kaydıdır.

Kurulum

1. Uygulamayı bağlayın

Infumar panelinde Markalarım → markanız → Entegrasyonlar → Uygulama İçi Satın Alma'dan RevenueCat proje kimliğini ve salt-okunur bir v2 gizli anahtar girin (customer_information:customers:read ve project_configuration:integrations:read). Panel size webhook adresini, uygulama anahtarını ve kampanya teklif adlarını verir.

2. Webhook'u açın

RevenueCat → Integrations → Webhooks'ta panelin verdiği adresle bir webhook ekleyin: ortam Production, tüm olay türleri, imzalama açık. RevenueCat'in gösterdiği imza anahtarını panele yapıştırın. Webhook her gün kontrol edilir; kapatılırsa kampanya durur.

3. Kampanya teklifini mağazalarda açın

App Store Connect'te aboneliklerinize (ve tek seferlik ürünlerinize) özel bir teklif kodu açın: referans adı ve kod paneldeki adlarla birebir aynı olmalı. Google Play Console'da aynı ürünlere paneldeki kimlikle bir geliştirici teklifi ekleyin. Teklifin fiyatı ve süresi sizin kararınız; Infumar yalnız adına bakar.

4. Kod ekranını ekleyin

Uygulamanız kullanıcının yazdığı kodu Infumar'a doğrulatır. İstek yalnız uygulama anahtarını taşır (gizli değildir); cevap kimseyi adlandırmaz. Kod büyük-küçük harf ve Türkçe karakter farkı gözetmeden eşleşir.

curl https://api.infumar.com/api/v1/iap/codes/AYSE \
  -H "X-Infumar-App-Key: infapp_..."

// Live creator of your running campaign (or the test code):
{
  "valid": true,
  "code": "AYSE",
  "apple": { "offerCode": "INF3F9A...", "redeemUrl": "https://apps.apple.com/redeem?ctx=offercodes&id=...&code=INF3F9A..." },
  "play":  { "offerId": "inf-3f9a12bc" }
}

// Anything else — unknown, removed, no campaign running:
{ "valid": false }

5. Test satın alması

Sandbox hesabıyla INFUMARTEST kodunu girip kampanya teklifinden bir satın alma yapın. Bu kod kampanya yokken de geçerlidir; satın alma ulaştığında panel uygulamayı doğrulanmış gösterir ve kampanya açılabilir.

Örnek akış

Kod geçerliyse önce infumar_code özelliğini yazın, sonra kampanya teklifini uygulayın. iOS'ta teklif Apple'ın kod kullanım ekranıyla, Android'de teklifin seçeneğiyle satın alınır. Örneklerdeki lookup, yukarıdaki isteği yapan kendi yardımcınızdır.

iOS (Swift)

// 1. Check the code the user typed.
let lookup = try await infumar.lookup(code: typed)   // GET /iap/codes/:code
guard lookup.valid else { return showInvalidCode() }

// 2. Tag the customer BEFORE the purchase — this is what pays the creator.
Purchases.shared.attribution.setAttributes(["infumar_code": lookup.code])
await Purchases.shared.syncAttributesAndOfferingsIfNeeded()

// 3. Apply the campaign offer: Apple's redeem sheet with the offer code.
if let url = URL(string: lookup.apple!.redeemUrl) {
  await UIApplication.shared.open(url)
}

Android (Kotlin)

// 1. Check the code the user typed.
val lookup = infumar.lookup(typed)                   // GET /iap/codes/:code
if (!lookup.valid) return showInvalidCode()

// 2. Tag the customer BEFORE the purchase — this is what pays the creator.
Purchases.sharedInstance.setAttributes(mapOf("infumar_code" to lookup.code))

// 3. Buy with the campaign offer (option id = "<basePlan>:<offerId>").
val option = product.subscriptionOptions
  ?.firstOrNull { it.id.endsWith(":" + lookup.play!!.offerId) }
  ?: return showOfferMissing()
Purchases.sharedInstance.purchase(
  PurchaseParams.Builder(activity, option).build(), callback
)

React Native

const res = await fetch(`https://api.infumar.com/api/v1/iap/codes/${encodeURIComponent(typed)}`, {
  headers: { "X-Infumar-App-Key": INFUMAR_APP_KEY },
});
const lookup = await res.json();
if (!lookup.valid) return showInvalidCode();

await Purchases.setAttributes({ infumar_code: lookup.code });   // before the purchase

if (Platform.OS === "ios") {
  await Linking.openURL(lookup.apple.redeemUrl);
} else {
  const option = product.subscriptionOptions?.find((o) =>
    o.id.endsWith(":" + lookup.play.offerId),
  );
  await Purchases.purchaseSubscriptionOption(option);
}

RevenueCat kullanmıyorsanız

Uygulamayı bağlarken "App Store & Google Play"i seçin. App Store için bir In-App Purchase anahtarı oluşturun; satın almaları Apple'ın sunucu bildirimleri geçmişinden okuruz (App Store Server Notifications adresi tanımlı olmalı, kendi sunucunuzunki olabilir). Google Play için bir servis hesabına uygulamada "Finansal verileri görüntüleme" ve "Siparişleri ve abonelikleri yönetme" izinlerini verin ve Play bildirimlerinizin Pub/Sub konusuna bizim adresimize push yapan bir abonelik ekleyin; her satın almayı Play API'den okuruz. infumar_code özelliğinin yerine, satın alma tamamlanınca kodu bize bildirirsiniz: iOS'ta original transaction id, Android'de purchase token ile. Bildirim satın almadan sonra gelebilir; kampanya teklifiyle yapılmış bir satın alma bir süre kodu bekler.

curl -X POST https://api.infumar.com/api/v1/iap/attributions \
  -H "X-Infumar-App-Key: infapp_..." \
  -H "Content-Type: application/json" \
  -d '{ "platform": "ios", "purchaseId": "2000000123456789", "code": "AYSE" }'
# Android: { "platform": "android", "purchaseId": "<purchaseToken>", "code": "AYSE" }

// → { "recorded": true }   (a code the check would refuse → { "recorded": false })
// After the offer-code purchase lands (Apple's redeem sheet runs outside
// your purchase call, so listen for it):
for await update in Transaction.updates {
  guard case .verified(let transaction) = update else { continue }
  if let code = pendingInfumarCode {                 // the code the user typed
    try await infumar.report(platform: "ios",
                             purchaseId: String(transaction.originalID),
                             code: code)             // POST /iap/attributions
    pendingInfumarCode = nil
  }
  await transaction.finish()
}
// Android (Play Billing): buy with the campaign offer's token, then report.
val details = productDetails.subscriptionOfferDetails
  ?.first { it.offerId == campaign.play.offerId }      // from /iap/codes
val params = BillingFlowParams.ProductDetailsParams.newBuilder()
  .setProductDetails(productDetails)
  .setOfferToken(details!!.offerToken).build()
billingClient.launchBillingFlow(activity,
  BillingFlowParams.newBuilder().setProductDetailsParamsList(listOf(params)).build())

// in onPurchasesUpdated:
infumar.report(platform = "android", purchaseId = purchase.purchaseToken, code = code)

Kurallar

  • infumar_code özelliği satın almadan ÖNCE yazılmalı. Sonradan yazılan kod o satın almayı influencer'a bağlamaz.
  • Yalnız kampanya teklifiyle yapılan satın almalar sayılır. Teklifsiz satın alma kod girilmiş olsa da kampanyanın değildir.
  • Teklifle yapılıp kodu olmayan satın alma kimseye yazılmaz ve tahsil edilmez; birkaç tanesi birikince kampanya durur. Kodu her zaman yazdığınızdan emin olun.
  • Influencer'ın linki ziyaretçiyi telefonuna göre App Store ya da Google Play sayfanıza götürür. Android'de kod, Play'in install referrer bilgisinde gelir (referrer = infumar_code=KOD): uygulamanız ilk açılışta Play Install Referrer API ile bunu okuyup kod kutusunu doldurursa kullanıcı kodu yazmak zorunda kalmaz. iOS'ta App Store linki uygulamaya bilgi taşımaz; kullanıcı kodu kendisi girer.
  • Abonelik yenilemeleri ilk satın almadan itibaren 12 ay boyunca aynı influencer'a yazılır; kampanya kapansa da önceden başlamış abonelikler için sürer.
  • İade edilen satın almanın komisyonu geri alınır. Komisyon, müşterinin ödediği tutar üzerinden hesaplanır (mağaza kesintisi düşülmez).
  • TL dışı ödemeler, satın alma günü geçerli TCMB döviz alış kuruyla TL'ye çevrilir.
  • iOS'ta teklif kodu uygulamanın dışındaki Apple ekranında kullanılır. RevenueCat SDK'sı uygulama açıldığında bu satın almayı alır; SDK'nın her açılışta yapılandırıldığından ve kullanıcının erişimini bu satın almadan verdiğinizden emin olun.
  • Webhook kapalı, silinmiş ya da yalnız sandbox'a gönderiyorsa kampanya duraklatılır; düzelince ertesi sabah kendiliğinden devam eder.
  • Uygulama anahtarı uygulamanın içinde durabilir, gizli değildir. RevenueCat API anahtarınızı ve imza anahtarını ise yalnız Infumar paneline girin.

Sık sorulanlar

iOS'ta tek teklif koduyla hem ücretsiz deneme hem ilk ay indirimi verebilir miyiz?
Hayır. App Store'da bir teklif kodu tek bir tür taşır: ücretsiz, dönem başına indirimli (pay as you go) ya da peşin ödeme. Kampanya için indirimli dönemi öneriyoruz: influencer'ın takipçisine söylediği vaat odur ve ilk ödeme hemen gelir. Ücretsiz deneme, kampanya dışındaki kullanıcılar için normal tanıtım teklifiniz olarak kalabilir. Denemede ilk kayıt 0 TL olur, dönüşmeyen deneme satış sayılmaz.
Android'de kendi teklif kimliğimizi (örneğin p20-monthly) kullanabilir miyiz?
Kampanya teklifinin kimliğini Infumar verir (bağlantı ekranında, inf-… biçiminde); Play Console'da aynı base plan üzerinde bu kimlikle yeni bir developer-determined teklif açmanız yeterli, indirimi mevcut teklifinizle aynı tutabilirsiniz. O kimlikle yapılan her satın alma kampanyaya sayıldığı için kimlik yalnız kampanyanın olmalı; mevcut teklifleriniz kendi promosyonlarınızda kullanılmaya devam eder. Play'de teklif sayısı sınırı yoktur.
RevenueCat webhook'unu kendi sunucumuz üzerinden size aktarabilir miyiz?
Hayır. Kampanyanın açılması ve açık kalması için RevenueCat projenizde doğrudan bizim adresimize giden, açık ve canlı ortamda bir webhook'un kayıtlı olduğunu RevenueCat'in API'sinden kontrol ediyoruz; aktarılan bir webhook bu kontrolü geçemez ve kampanya duraklar. Mevcut webhook'unuz olduğu gibi kalsın, bizim adresimize ikinci bir webhook ekleyin.
Uygulamayı yeniden bağlarsak teklif adları değişir mi?
Hayır. Aynı uygulamayı (aynı bundle id ya da paket adı) yeniden bağlamak mevcut kaydı geri getirir; uygulama anahtarı, teklif adları ve Google Play bildirim adresi aynı kalır.

Yardım

Kuruluma takıldığınız yerde panelin destek bölümünden bize yazın.

Panele git
Uygulama İçi Satın Alma Rehberi | Infumar