Blog Yazısı Özeti

FAST TR Karekod entegrasyonu, ekranda bir QR kod göstermekten ibaret değildir. Başarılı tahsilat otomasyonu; ödeme isteğini tekil siparişe bağlar, sonucu banka veya ödeme kuruluşundan doğrular ve ERP kaydıyla hesap hareketini sonradan yeniden karşılaştırır.

Hazırlayan: Busana. Kaynak kontrolü: 6 Ekim 2026.

Fotoğraf: SHVETS production / Pexels. Temsili mobil ödeme görselidir; FAST TR Karekod işlemini göstermemektedir.

Bayi “ödemeyi gönderdim” der, finans ekibi hesap hareketini arar, satış ekibi sevkiyatın açılmasını bekler. Tutarlar aynıysa hangi ödemenin hangi siparişe ait olduğu daha da karışır. Bu bekleme, ödeme hızından çok eşleştirme tasarımının sorunudur.

TCMB'nin 2026-36 sayılı duyurusuna göre 26 Ağustos 2026 itibarıyla FAST para transferleri ve Ödeme İste üzerinden gerçekleştirilen ödemelerde limit 300.000 TL'ye; FAST TR Karekod ile dinamik doğrulamalı iş yeri ödemelerinde de 300.000 TL'ye yükseltilmiştir. Bu sistem limiti, her bankanın her müşteriye aynı kanalı ve limiti sunacağı anlamına gelmez. TCMB duyurusu.

Normal havale QR'ı ile iş yeri ödeme akışı aynı değildir

Bir IBAN'ı QR içinde göstermek, dinamik doğrulamalı iş yeri ödeme entegrasyonunu kurmuş olmak değildir. Kullanılacak ürünün hangi katman servisine dayandığı, ödeme referansını nasıl taşıdığı ve iş yerine hangi sonucu döndürdüğü sağlayıcıyla netleştirilmelidir.

İşletmenin TCMB sistemine doğrudan bağlanacağı varsayılmamalıdır. Pratik entegrasyon, hizmeti sunan banka veya yetkili ödeme hizmeti sağlayıcısının sözleşmesi ve teknik arayüzü üzerinden tasarlanır. TCMB'nin açıklamaları sistemin çerçevesini gösterir; bankanızın API uç noktalarını veya ticari koşullarını belirlemez. FAST sık sorulan sorular.

Sipariş ile ödeme denemesini ayrı tutun

Bir siparişin birden fazla ödeme denemesi olabilir. Kullanıcı karekodu açıp vazgeçebilir, süre dolabilir veya başka cihazdan yeniden deneyebilir. Sipariş numarasını tek başına bütün denemelerin teknik kimliği yapmak bu durumları ayırmayı zorlaştırır.

Önerilen veri modeli en az şu ayrımı yapar: sipariş kimliği, ödeme denemesi kimliği, sağlayıcı işlem kimliği, beklenen tutar, para birimi ve durum. Karekod süresini ve yeniden üretim davranışını sağlayıcının desteklediği kurallara göre uygulayın; keyfi bir süreyi standart gereğiymiş gibi kullanmayın.

  • Ödeme henüz doğrulanmadı: ERP davranışı: Siparişi beklet. Yapılmaması gereken: Ekran görüntüsüyle tahsilat kapat.
  • Doğrulanmış, doğru tutarlı ödeme: ERP davranışı: İzinli iş akışını ilerlet. Yapılmaması gereken: İstemciden gelen tutara güven.
  • Aynı bildirim tekrar geldi: ERP davranışı: Önceki sonucu döndür. Yapılmaması gereken: İkinci tahsilat kaydı aç.
  • Eksik veya farklı tutar: ERP davranışı: İstisna kuyruğuna al. Yapılmaması gereken: Sessizce tam ödendi say.
  • Süresi dolmuş denemeye geç sonuç geldi: ERP davranışı: Sağlayıcıdan durumu sorgula. Yapılmaması gereken: Kesin başarısız kabul edip unut.

Bildirimi alın, doğrulayın, sonra işi çalıştırın

Sağlayıcı webhook sunuyorsa bildirimin kimliğini ve bütünlüğünü kendi dokümanındaki yöntemle doğrulayın. IP kontrolü tek başına yeterli kabul edilmemelidir. Bildirimi kalıcı olarak kaydettikten sonra ERP işini kuyruğa almak, kısa sürede yanıt verme ve yeniden işleme açısından yararlıdır.

Bazı sağlayıcılar farklı teslim sırası, yeniden deneme veya sorgulama modeli kullanır. Bunları sözleşme ve test ortamında doğrulayın. Stripe'ın webhook dokümanı imza, tekrar teslim ve sıralama sorunlarına açık bir teknik örnektir; burada yalnızca mimari referans olarak kullanılmıştır, Türkiye'de FAST sağlayıcısı önerisi değildir. Stripe webhook dokümanı.

Doğrulanmış bir bildirim bile yanlış siparişle ilişkilendirilirse iş sonucu hatalıdır. Sağlayıcı işlem kimliği, iş yeri hesabı, tutar ve sipariş ilişkisi sunucu tarafında birlikte kontrol edilmelidir. ERP bağlantısı kesilirse ödeme kaybolmamalı; tahsilat doğrulanmış, ERP aktarımı bekliyor olarak ayrı durum tutulmalıdır.

Günlük mutabakat neden hâlâ gerekli?

Gerçek zamanlı bildirim, mutabakatın yerine geçmez. Kaçırılan olaylar, manuel banka işlemleri, iade ve operasyon hataları olabilir. Gün sonunda sağlayıcının kayıtlarıyla kendi ödeme tablonuzu, ardından ERP tahsilat kayıtlarını karşılaştırın.

Farkları tek bir “hata” kutusuna atmak yerine sınıflandırın: bankada var uygulamada yok, uygulamada var ERP'de yok, tutar farklı, aynı işlem birden fazla kayıtla bağlı. Her sınıfın sahibi ve düzeltme adımı belli olsun. Otomasyonun değeri yalnızca doğru eşleştirme oranı değil, kalan istisnaların kaç dakikada çözülebildiğidir.

İadeyi ilk ödemenin ters işareti gibi ele almayın. Sağlayıcının desteklediği iade veya geri ödeme mekanizması, yetkilendirme ve muhasebe işleyişi ayrıca tasarlanmalıdır. Karekod kullanımı belge düzenleme ve diğer yükümlülükleri kendiliğinden ortadan kaldırmaz; mali süreçleri yetkili danışmanla değerlendirin.

Canlıya geçiş için beş test

Önce test ortamında aynı bildirimi iki kez gönderin. Sonra ödeme sonucu alınırken bağlantıyı kesin, ERP'yi geçici olarak erişilemez yapın, farklı tutar üretin ve gün sonunda tek bir kaydı eksik bırakın. Sistem bu durumlarda yanlış sevkiyat açmadan toparlanabiliyorsa anlamlı bir temel kurulmuş demektir.

Busana'nın API entegrasyonu kapsamında başlayacağı yer banka seçmek değil, mevcut sağlayıcının sunduğu yeteneklerle sipariş-tahsilat sözleşmesini kurmaktır. Teknik dokümanınız ve mevcut tahsilat akışınızla görüşelim.