Kullanıcı Kılavuzu

Capture Reserved Funds

14/3/25
Capture Reserved Funds

Capture Reserved Funds, Kuika’nın Stripe entegrasyonu kapsamında kullanılan bir aksiyondur. Stripe üzerinde daha önce rezerve edilen bir tutarın, yani “ön yetkilendirilmiş” bir ödemenin, tahsil edilmesini sağlar. Bu işlem genellikle iki aşamalı ödeme süreçlerinde kullanılır: ilk aşamada ödeme yetkilendirilir (authorize), ikinci aşamada tahsil edilir (capture).

Teknik Özellikler

  • İki Aşamalı Ödeme Desteği: Stripe üzerinden ön yetkilendirme yapılmış ödemeleri sonradan tahsil etmenizi sağlar.
  • Esnek Tutar Tahsili: Yetkilendirilen tutarın tamamı ya da bir kısmı tahsil edilebilir.
  • Web ve Mobil Uygulama Desteği: Web ve mobil uygulamalarda desteklenir.
  • Güvenli ve Doğrudan İşlem: Stripe API ile doğrudan iletişim kurularak tahsilat işlemi güvenli biçimde gerçekleştirilir.

Capture Reserved Funds Aksiyonu Uygulama Adımları

  1. Kuika platformuna giriş yapın.
  2. Apps ekranından çalışacağınız projeyi seçin.
  3. UI Design modülüne geçin.
  4. Tahsilat işlemini tetikleyecek UI elementini (örneğin: “Ödemeyi Al” butonu) seçin.
  1. Sağ kenarda bulunan Properties panelinden +ADD ACTION seçeneğine tıklayın.
  2. Butonu seçin ve + ADD ACTION menüsünden istediğiniz tetikleyici olaya (Initial Actions, OnClick, OnBlur vb.) göre Payment Stripe >Capture Reserved Funds aksiyonunu ekleyin.
  3. Açılan ayarlardan  şu parametreleri tanımlayın: 
  • Payment Intent: Stripe üzerinde daha önce yetkilendirilmiş (authorized) ödeme işlemine ait benzersiz kimlik. Örneğin: pi_3NsG9sLz3fD9oQvX2t7q...
  • Amount: Tahsil edilecek tutar. Stripe tarafından yetkilendirilen tutarın tamamı ya da belirlenen kısmı burada girilir.
  1. Close butonuna tıklayarak işlemi tamamlayın.

Kullanım Senaryosu: Otel Rezervasyonunda Ön Provizyon Tahsili

Bir kullanıcı otel rezervasyonu yapar ve kredi kartından ilk etapta 1.000₺’lik bir tutar Stripe üzerinden sadece yetkilendirilir (çekilmez). Müşteri otele giriş yaptıktan sonra bu tutarın tahsil edilmesi gerekir.

Senaryo Akışı:

  • Kullanıcı rezervasyon yapar. Payment Intent oluşturulur ve rezerve edilir.
  • Otele giriş günü geldiğinde, resepsiyon görevlisi “Tahsil Et” butonuna tıklar.
  • Bu butona bağlı Capture Reserved Funds aksiyonu çalışır.
  • Payment Intent kimliği ve tahsil edilecek tutar sisteme iletilir.
  • Stripe üzerinden tahsilat gerçekleşir.
  • Kullanıcıya işlem başarılı mesajı gösterilir, fatura otomatik olarak e-posta ile gönderilir.

Capture Reserved Funds Aksiyonu İleri Seviye Özelleştirmeler

  • Kısmi Tahsilat: Amount parametresi ile yetkilendirilen tutarın yalnızca bir kısmı tahsil edilebilir (örneğin 1.000₺ yerine 800₺).
  • Tahsilat Gecikmesi: Ödemeyi hemen almak yerine, kullanıcı işlem yaptıktan saatler veya günler sonra capture işlemi yapılabilir. Bu, kiralama ve ön sipariş gibi senaryolarda oldukça yararlıdır.
  • Ödeme Sonrası İş Akışları: Tahsilat sonrası kullanıcıya bildirim gösterilebilir, e-posta gönderilebilir veya bir onay sayfasına yönlendirme yapılabilir.

Teknik Riskler 

  • Yetkisiz Payment Intent: Capture işlemi yalnızca yetkilendirilmiş ama henüz tahsil edilmemiş Payment Intent nesneleri için geçerlidir.
    Daha önce tahsil edilmiş bir işlemde bu aksiyon başarısız olur.
  • Zaman Aşımı Riski: Stripe, yetkilendirme işlemlerinin genellikle 7 gün içinde tahsil edilmesini bekler. Bu süre aşıldığında capture yapılamaz.
  • Fazla Tahsilat: Amount parametresi, yetkilendirilmiş tutardan fazla girilirse işlem reddedilir. Giriş verileri mutlaka doğrulanmalıdır.
  • Aynı Payment Intent ile Yinelenen İşlem: Her PaymentIntent, yalnızca bir kez tahsil edilebilir. Tekrar kullanılmamalıdır.

Capture Reserved Funds, Stripe ile ön yetkilendirilmiş ödemeleri kontrol altında tahsil etmek için ideal bir çözümdür. İki aşamalı ödeme süreçlerinde esneklik sağlar, kullanıcı deneyimini iyileştirir ve işletmeler için finansal kontrol sunar. Kuika’nın aksiyon mimarisi ile kolayca entegre edilebilir ve güçlü veri akışlarıyla desteklenebilir.

No items found.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar