Charge Payment Method, Kuika’nın Stripe entegrasyonu kapsamında kullanılan bir aksiyondur. Bu aksiyon, kullanıcıların önceden kaydedilmiş ödeme yöntemlerini (kredi kartı vb.) kullanarak kolay, hızlı ve güvenli bir şekilde ödeme gerçekleştirmesini sağlar.

Genellikle Setup Intent aksiyonu ile ödeme yöntemi kaydedildikten sonra kullanılır ve tekrar eden ödemelerde ya da kullanıcı deneyimini hızlandırmak amacıyla tercih edilir.

Teknik Özellikler

• Kayıtlı Kartla Ödeme: Setup Intent ile daha önce kaydedilen ödeme yöntemiyle işlem yapılmasını sağlar.
• Web ve Mobil Uygulama Desteği: Web ve mobil uygulamalarda kullanılabilir.  
• Gelişmiş Ödeme Senaryoları: Tek hesaba veya birden fazla Stripe hesabına ödeme yönlendirmeyi destekler (uygulama bazlı kullanım senaryoları için uygundur).
• Stripe PCI Uyumluluğu: Ödeme işlemleri Stripe’ın güvenli altyapısı üzerinden yürütülür, hassas kart bilgileri uygulamada tutulmaz.

Charge Payment Method Aksiyonu Uygulama Adımları

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.
3. UI Design modülüne geçin.
4. Ödeme işlemini tetikleyecek UI elementini (örneğin “Aboneliği Başlat” butonu) seçin.

5. Sağ kenarda bulunan Properties panelinden +ADD ACTION seçeneğine tıklayın.
6. Butonu seçin ve + ADD ACTION menüsünden istediğiniz tetikleyici olaya (Initial Actions, OnClick, OnBlur vb.) göre Payment Stripe > Charge Payment Method aksiyonunu ekleyin.

Parametreler

• Payment Method:Eklenen aksiyon içinde "Symbol Picker (B)" kullanılarak parametre giriş yöntemi seçilebilir.
  
  • Ödeme alınabilmesi için, öncesinde "Setup Intent" aksiyonu oluşturulup çağrılmalıdır.
  • Daha sonra "Charge Payment Method → Payment Method" kısmında "Symbol Picker" kullanarak "Action Results → Setup Intent → Payment Method" seçeneğini seçerek bağlantıyı tamamlayın.
• Currency: İşlemin gerçekleşeceği para birimi (örneğin: usd, eur, try). Stripe hesabınızda tanımlı olmalıdır.
• Amount: Ödenecek tutar, seçilen para biriminin en küçük biriminde girilmelidir. Örneğin: 1000 değeri USD için 10 dolar, kuruş bazlı TRY için 10 TL ifade eder.
• Description: Ödeme açıklaması. Örneğin “Aylık Premium Abonelik”.
• Customer Mail Address: İşlemle ilişkilendirilecek müşterinin e-posta adresidir. Stripe panelinde takip kolaylığı sağlar.

Ödeme Dağıtım Seçenekleri

• Single/Multi Part: Alınan ödemenin dağıtım yöntemini belirler.
  
  • Ödeme tek bir hesaba aktarılacaksa: "Single" seçeneğini kullanın.
  • Ödeme birden fazla hesaba bölünecekse: "Multi" seçeneğini seçin.
  • "Multi" seçildiğinde ek olarak aşağıdaki parametreler eklenir:
    
    • Application Fee Amount: Master hesabın alacağı komisyon tutarını belirler.
    • Destination: Ödemenin aktarılacağı diğer hesapların ID’sinin girildiği alandır.
      
      • Örneğin, toplam ödeme tutarı 1000 $ ise ve "Application Fee Amount" kısmına 100 $ girilmişse:
        
        • Master hesap 100 $ alır ve geriye kalan 900 $, "Destination" hesabına otomatik olarak aktarılır.
          

Kullanım Senaryosu: Dijital Ürün Platformunda Kayıtlı Kart ile Ödeme

Senaryo Akışı:

• Kullanıcı, platforma ilk kez kayıt olduğunda Setup Intent ile kartını kaydeder.
• İkinci kez alışveriş yaptığında, doğrudan Charge Payment Method aksiyonu ile ödeme yapılır.
• Kullanıcı, kart bilgisi girmeden hızlıca satın alma işlemini tamamlar.
• Eğer platform Stripe Connected Accounts yapısına sahipse, ödeme otomatik olarak ilgili alt satıcıya yönlendirilir.

Charge Payment Method Aksiyonu İleri Seviye Özelleştirmeler

• Otomatik Abonelik Ödemeleri: Kullanıcının kaydedilmiş ödeme yöntemi periyodik olarak çekilerek abonelik sistemine entegre edilebilir.
• Fatura Otomasyonu: Başarılı ödeme sonrası e-fatura entegrasyonu ile belge düzenlenebilir.
• Komisyon Yönetimi: Marketplace uygulamalarında, komisyon oranına göre Application Fee Amount dinamik olarak hesaplanabilir.
• Hatalı Ödeme Senaryoları İçin Yedek Kart Kullanımı: Eğer ilk kartla ödeme başarısız olursa, farklı bir kayıtlı kart denemesi tetiklenebilir.

Teknik Riskler 

• Setup Intent Olmadan Kullanılamaz: Kayıtlı ödeme yöntemi yoksa bu aksiyon çalışmaz. Öncesinde Setup Intent aksiyonu tetiklenmiş olmalıdır.
• Para Birimi Hatası: Currency parametresi Stripe hesabınızda tanımlı para birimiyle uyuşmuyorsa ödeme reddedilir.
• Hatalı Tutar Formatı: Amount küçük birimle girilmelidir. Örneğin 10₺ yerine 1000 yazılmalıdır (kuruş bazlı).
• Geçersiz Payment Method ID: Silinmiş, iptal edilmiş veya süresi dolmuş kartla işlem yapılmaya çalışılırsa hata alınır.
• Aynı Kullanıcıya Birden Fazla Ödeme: Eğer ödeme tekrar tekrar tetiklenirse kullanıcıdan aynı tutar birden fazla tahsil edilebilir. Kontrollü tetikleme yapılmalıdır.

Charge Payment Method, Stripe ile entegre edilen Kuika projelerinde kayıtlı ödeme yöntemleriyle hızlı, tekrar edebilir ve güvenli ödeme işlemleri gerçekleştirmenizi sağlar. Özellikle abonelik bazlı modeller, e-ticaret platformları ve pazar yerleri için büyük kolaylık sunar.