Mobil Uygulamanıza Ödeme Entegrasyonu Eklemenin Yolları

Mobil uygulamalar, kullanıcıların günlük yaşamlarının ayrılmaz bir parçası haline geldi. Alışveriş, yemek siparişi, ulaşım, eğitim, sağlık — hemen her sektörde mobil uygulamalar üzerinden ödeme alma ihtiyacı bulunuyor. Ancak mobil uygulama içinde ödeme entegrasyonu, web sitesi entegrasyonundan farklı zorluklar ve fırsatlar barındırır. Platform kuralları, kullanıcı deneyimi beklentileri, güvenlik gereksinimleri ve teknik altyapı farklılıkları dikkate alınmalıdır.

Bu rehberde mobil uygulamanıza ödeme entegrasyonu eklemenin farklı yollarını, iOS ve Android platformlarındaki farklılıkları, App Store ve Google Play kurallarını, 3D Secure'ün mobilde nasıl çalıştığını ve test sürecini detaylıca ele alacağız.

Mobil Ödemede Yöntemler: In-App, WebView ve Native SDK

Mobil uygulamanıza ödeme entegrasyonu eklemek için üç temel yaklaşım bulunur. Her birinin avantaj ve dezavantajları vardır; seçiminiz uygulamanızın türüne, satış modelinize ve teknik kaynaklarınıza bağlıdır.

Native SDK Entegrasyonu

Ödeme altyapısının sunduğu mobil SDK'yı (Software Development Kit) uygulamanıza entegre ederek, ödeme formunu doğrudan uygulama arayüzünüze gömmenizi sağlar. Kart bilgisi girişi, form doğrulama ve ödeme işlemi uygulamanın doğal akışında gerçekleşir.

• Avantajları: En akıcı kullanıcı deneyimi, uygulama tasarımıyla tam uyum, hızlı işlem süresi, gelişmiş hata yönetimi.
• Dezavantajları: Daha fazla geliştirme eforuna ihtiyaç duyar, SDK güncellemelerini takip etmek gerekir.
• Uygun senaryolar: Yüksek işlem hacimli uygulamalar, premium kullanıcı deneyimi hedefleyen projeler.

WebView Entegrasyonu

Ödeme sayfasının uygulama içinde bir WebView (gömülü tarayıcı) aracılığıyla açılmasıdır. Kullanıcı, uygulama içindeyken bir web sayfası gibi görünen ödeme formunu görür ve ödemeyi tamamlar.

• Avantajları: Hızlı entegrasyon, web sitesiyle aynı ödeme sayfasını kullanma imkanı, güncelleme kolaylığı (web sayfası güncellendiğinde mobilde de güncellenir).
• Dezavantajları: Kullanıcı deneyimi native kadar akıcı olmayabilir, yükleme süresi ağ hızına bağlıdır, bazı durumlarda uygulama-web geçişi fark edilebilir.
• Uygun senaryolar: Hızlı lansman hedefleyen projeler, sınırlı geliştirme kaynağına sahip ekipler, MVP (Minimum Viable Product) aşamasındaki uygulamalar.

In-App Purchase (Uygulama İçi Satın Alma)

Apple ve Google'ın kendi ödeme altyapıları üzerinden gerçekleştirilen satın alımlardır. StoreKit (iOS) ve Google Play Billing (Android) kütüphaneleri kullanılır.

• Avantajları: Platformla tam entegrasyon, kullanıcı için tanıdık ve güvenilir ödeme deneyimi, abonelik yönetimi desteği.
• Dezavantajları: Mağaza komisyonu uygulanır, ödeme verilerine sınırlı erişim, fiyatlandırma esnekliği kısıtlı.
• Uygun senaryolar: Dijital ürün ve içerik satışı (mağaza kuralları gereği zorunlu olabilir), abonelik bazlı uygulamalar.

iOS ve Android İçin Entegrasyon Farklılıkları

Her iki platform da mobil ödeme entegrasyonu için farklı araçlar, kurallar ve teknik gereksinimler sunar. Bu farklılıkları anlamak, her iki platformda da sorunsuz bir ödeme deneyimi sunmanızı sağlar.

iOS (Apple) Platformu

• Programlama dili: Swift veya Objective-C ile native geliştirme. React Native, Flutter gibi çapraz platform çözümleri de desteklenir.
• Ödeme SDK: Ödeme altyapısının iOS SDK'sı CocoaPods veya Swift Package Manager ile entegre edilir.
• App Store kuralları: Dijital ürün ve içerik satışlarında Apple'ın in-app purchase sistemi zorunludur. Fiziksel ürün ve hizmetlerde üçüncü parti ödeme altyapısı kullanılabilir.
• Apple Pay: iPhone ve Apple Watch ile temassız ödeme. Ödeme altyapınız Apple Pay desteği sunuyorsa entegre edilebilir.
• Güvenlik: iOS Keychain ile hassas verilerin güvenli saklanması, App Transport Security (ATS) ile zorunlu HTTPS kullanımı.

Android Platformu

• Programlama dili: Kotlin veya Java ile native geliştirme. React Native, Flutter gibi çapraz platform çözümleri de desteklenir.
• Ödeme SDK: Ödeme altyapısının Android SDK'sı Gradle bağımlılığı olarak entegre edilir.
• Google Play kuralları: Dijital ürün satışlarında Google Play Billing sistemi zorunludur. Fiziksel ürün ve hizmetlerde üçüncü parti ödeme altyapısı kullanılabilir.
• Google Pay: Android cihazlarda temassız ve online ödeme. Ödeme altyapınız Google Pay desteği sunuyorsa entegre edilebilir.
• Güvenlik: Android Keystore ile hassas verilerin güvenli saklanması, network security configuration ile HTTPS zorunluluğu.

App Store / Google Play Kuralları ve Komisyon

Mobil ödeme entegrasyonunda en kritik konulardan biri, Apple App Store ve Google Play Store'un ödeme kurallarıdır. Bu kurallar, hangi ödeme yöntemini kullanmanız gerektiğini doğrudan belirler.

Dijital Ürün ve İçerik Satışı

Dijital ürünler (uygulama içi özellikler, abonelikler, dijital içerik, sanal para vb.) satıyorsanız, mağazaların kendi in-app purchase sistemlerini kullanmanız genellikle zorunludur. Bu satışlardan mağaza belirli bir komisyon oranı alır.

Fiziksel Ürün ve Hizmet Satışı

Fiziksel ürünler (giyim, elektronik, yemek vb.) veya uygulama dışında teslim edilen hizmetler (taksi, otel, temizlik vb.) satıyorsanız, üçüncü parti ödeme altyapısı kullanabilirsiniz. Bu durumda mağaza komisyonu uygulanmaz; yalnızca ödeme altyapısının kendi komisyonu geçerli olur.

Hibrit Modeller

Bazı uygulamalar hem dijital hem de fiziksel ürün veya hizmet sunar. Bu durumda dijital ürün satışları mağazanın sisteminden, fiziksel ürün satışları ise üçüncü parti ödeme altyapısından geçmelidir. Her iki akışın uygulamada doğru şekilde yönlendirilmesi önemlidir.

3D Secure Mobilde Nasıl Çalışır?

Türkiye'de online kart ödemelerinde 3D Secure doğrulaması zorunludur. Mobil uygulamalarda 3D Secure entegrasyonu, web'den farklı teknik gereksinimler barındırır.

3D Secure 1.0 Mobil Akışı

3D Secure 1.0'da kullanıcı, bankanın doğrulama sayfasına yönlendirilir. Mobil uygulamada bu yönlendirme genellikle bir WebView veya in-app browser aracılığıyla gerçekleşir. Kullanıcı SMS kodu veya mobil bankacılık onayı ile doğrulamayı tamamladıktan sonra uygulama akışına geri döner. Bu geçiş süreci bazen kullanıcı deneyimini olumsuz etkileyebilir.

3D Secure 2.0 ve Frictionless Akış

3D Secure 2.0, mobil deneyimi önemli ölçüde iyileştirmiştir. Risk bazlı kimlik doğrulama sayesinde düşük riskli işlemler "frictionless" (müdahalesiz) olarak tamamlanabilir — yani kullanıcıdan ek bir doğrulama istenmez. Yüksek riskli işlemlerde ise biyometrik doğrulama (parmak izi, yüz tanıma) veya uygulama içi bildirim ile onay istenebilir. Bu, hem güvenliği artırır hem de dönüşüm oranını yükseltir.

Mobil 3D Secure Entegrasyon İpuçları

• WebView'da 3D Secure sayfasının düzgün yüklenmesi için JavaScript ve çerez desteğinin aktif olduğundan emin olun.
• 3D Secure tamamlandıktan sonra callback URL'sinin doğru şekilde yakalanması ve kullanıcının uygulama akışına sorunsuz dönmesi kritiktir.
• Ağ bağlantısı kesilmesi veya timeout durumları için hata yönetimi senaryolarını hazırlayın.
• Kullanıcıya 3D Secure bekleme sürecinde bilgilendirici bir yükleme ekranı gösterin.

Test ve Yayına Alma

Mobil ödeme entegrasyonunun doğru çalıştığından emin olmak için kapsamlı bir test süreci gereklidir. Ödeme akışındaki herhangi bir hata, doğrudan gelir kaybına ve kötü kullanıcı deneyimine yol açar.

Test Ortamı (Sandbox)

Ödeme altyapınızın sandbox ortamını kullanarak gerçek para hareketine gerek kalmadan tüm ödeme senaryolarını test edin. Test kartları ile farklı durumları simüle edebilirsiniz:

• Başarılı ödeme senaryosu
• Yetersiz bakiye nedeniyle başarısız ödeme
• Kart limitine takılan işlem
• 3D Secure başarılı ve başarısız doğrulama
• Ağ kesintisi ve timeout durumları
• İade (refund) işlemi

Platform Bazlı Test

Her iki platformda da farklı cihaz ve işletim sistemi versiyonlarında test yapılmalıdır:

• iOS: Farklı iPhone modelleri, iPad ve farklı iOS versiyonlarında test edin. Özellikle eski iOS versiyonlarında WebView davranışı farklılık gösterebilir.
• Android: Farklı ekran boyutları, Android versiyonları ve marka/model çeşitliliğinde test edin. Android'in parçalı ekosistemi, beklenmedik davranışlara yol açabilir.

Yayına Alma Kontrol Listesi

1. Sandbox testleri tamamlandı: Tüm ödeme senaryoları başarıyla test edildi.
2. Canlı ortam anahtarları: Test anahtarları canlı (production) anahtarlarıyla değiştirildi.
3. Güvenlik kontrolleri: API anahtarları güvenli bir şekilde saklanıyor, hassas veriler loglanmıyor.
4. Hata yönetimi: Tüm hata durumları için kullanıcıya anlaşılır mesajlar gösteriliyor.
5. Mağaza kuralları uyumluluğu: App Store ve Google Play kurallarına uyumluluk doğrulandı.

Sonuç

Mobil uygulamanıza ödeme entegrasyonu eklemek, kullanıcı deneyimi, güvenlik ve platform kurallarını bir arada değerlendirmenizi gerektiren kapsamlı bir süreçtir. Native SDK, WebView ve in-app purchase yöntemleri arasında doğru seçimi yapmak, uygulamanızın türüne ve hedef kitlenize bağlıdır.

iOS ve Android platformlarının farklı gereksinimleri, App Store ve Google Play'in ödeme kuralları ve 3D Secure entegrasyonu, dikkat edilmesi gereken kritik konulardır. Kapsamlı bir test süreci ile tüm senaryoları doğruladıktan sonra yayına aldığınızda, kullanıcılarınıza güvenli ve akıcı bir ödeme deneyimi sunabilirsiniz.