Ödeme Alma (Payout) ⏳ Yakında

Eklenti gelirin balancePending'de birikir; Stripe Connect Express ile banka hesabına aktarılır. KYC (kimlik + banka doğrulama) tamamen Stripe'ta yapılır — platform banka bilgini hiç görmez.

Nasıl ödeme alırsın (adımlar)

  1. Portaldan Stripe onboarding'i başlat → açılan Stripe formunu doldur (KYC bilgileri + banka hesabı).
  2. Stripe KYC'yi tamamla → payout'a uygun olursun (payoutsEnabled = true).
  3. Kazanç birikir (abonelik + IAP) → balancePending artar.
  4. Eşik aşılınca platform otomatik payout açar → Stripe Connect hesabına transfer (balancePending −= tutar, balancePaid += tutar).
  5. Para Stripe Connect → banka hesabın (Stripe payout takvimine göre).
Onboarding ve earnings görünümü portal arayüzünden yönetilir. Bu sayfa kavramsaldır — geliştirici doğrudan bir payout API'si çağırmaz; transfer işlemini platform senin adına yürütür.

Bakiye modeli

Geliştirici bakiyesi kuruş (integer; 1₺ = 100 kuruş) cinsindendir.

AlanTipZorunluAçıklama
balancePendingint (kuruş)Çekilebilir bekleyen gerçek para. Payout açılınca buradan düşülür.
balancePendingTestint (kuruş)Test-mode kazanç. ASLA payout edilmez; yalnız test akışını görmen için tutulur.
balancePaidint (kuruş)Ömür boyu sana ödenen toplam tutar.
payoutsEnabledbooleanKYC tamamlandı → transfer alabilirsin. Payout için bakılan tek bayrak budur.
chargesEnabledbooleanYalnız bilgi amaçlı; payout’u ETKİLEMEZ (kontrol edilen tek alan payoutsEnabled).
detailsSubmittedbooleanStripe onboarding formu gönderildi mi (KYC ilerleme göstergesi).
canReceivePayout = Connect hesabı var payoutsEnabled balancePending ≥ minPayoutAmount.

Minimum eşik

minPayoutAmount varsayılan 10.000 kuruş (100,00₺)'dir. Bakiyen bu eşiğin altındaysa payout açılmaz; bakiye birikmeye devam eder (batch amortismanı — küçük tutarlar tek seferde toplanır).

KYC & güvenlik

  • Stripe Connect Express kullanılır. KYC (kimlik doğrulama) ve banka hesabı tamamen Stripe'ta toplanır.
  • Platform yalnızca Stripe accountId'ni görür — banka / kimlik verisi Stripe'ta kalır, PCI yükü Stripe'a aittir.
  • payoutsEnabled, Stripe account.updated event'i işlenince true olur. Canlı durum daima Stripe hesabından doğrulanır (accounts.retrieve) — event payload'ına körü körüne güvenilmez.

Payout batch (özet)

  • Eşiği aşan ve payoutsEnabled olan geliştiricilere platform periyodik olarak transfer açar.
  • Stripe idempotency ile aynı transfer iki kez gönderilmez; ağ hatasında recovery uygulanır.
  • Test-mode kazanç (balancePendingTest) batch'e ASLA girmez.
  • Bir refund payout'tan önce gelirse ilgili bakiye tersine çevrilir (geri alınır).

İlgili