İçeriğe geç
QR & Dijital Cüzdan

QR Ödeme Entegrasyonu: TR Karekod & Dijital Cüzdan

Aynı karekod iki farklı raydan çalışabilir: kart hattından geçen TR Karekod ile taksit ve puan satarsınız, FAST hattından geçen karekodla para saniyeler içinde hesabınıza düşer. Bu rehber hangi rayı hangi işletmenin seçmesi gerektiğini, dinamik-statik karekod kararını, webhook ve iade senaryolarını, limitleri ve gerçekçi maliyet aralıklarını uygulamadan gelen örneklerle anlatıyor.

12 dk okuma 20 soru-cevap 8 ana konu Güncelleme: 26 Temmuz 2026
Kısa Cevap

QR ödeme entegrasyonu, müşterinin telefonundaki banka ya da cüzdan uygulamasıyla bir karekodu okutarak yaptığı tahsilatın kendi POS, kasa veya e-ticaret yazılımınıza bağlanmasıdır. Türkiye'de bu işin omurgası 2020'de yayımlanan TR Karekod standardıdır: aynı karekod hem kart rayından hem de TCMB'nin FAST altyapısı üzerinden hesaptan hesaba çalışabilir, müşteri ayrı bir uygulama indirmek zorunda kalmaz. Entegrasyon pratikte üç parçadan oluşur: karekodun üretilmesi (kasada tutara özel dinamik ya da masada sabit statik), ödeme sonucunun webhook veya durum sorgulamayla yazılıma dönmesi ve tahsilatın ciro, stok ile mutabakat kayıtlarına işlenmesi. Doğru kurulduğunda kasiyer tutarı elle girmez, onay saniyeler içinde döner ve gün sonunda hesaba geçen para sistem cirosuyla eşleşir. QR, sanal POS ve SoftPOS gibi kanalların yerine değil yanına konumlanır; muhasebe entegrasyonuyla birleştiğinde gelir kaydı da elle uğraşmadan oluşur. Aşağıda ray seçiminden limitlere, hata senaryolarından maliyet aralıklarına kadar tüm karar noktalarını bulacaksınız.

Rehberin Ana Konuları

QR Ödeme Entegrasyonunu Kuranların Sırayla Karşılaştığı Kararlar

Kart rayı mı FAST rayı mı, dinamik mi statik karekod, webhook mu durum sorgulama — proje başlamadan netleşmesi gereken teknik ve ticari seçimler.

İki Ayrı Ray: Kart Tabanlı TR Karekod ve FAST Karekod

Karekod aynı görünse de arkasında iki farklı ray çalışır ve ticari sonuçları taban tabana zıttır. Kart tabanlı TR Karekod'da müşteri banka uygulamasında kartını seçer, işlem POS/kart hattından geçer: taksit yapabilirsiniz, müşteri puanını kullanabilir, ancak kart komisyonu ve valör süresi işler. FAST tabanlı karekodda ise tutar müşterinin mevduat hesabından işletmenin hesabına saniyeler içinde geçer; kart komisyonu yoktur, para anında elinizdedir, buna karşılık taksit ve puan senaryosu kurulamaz ve TCMB'nin işyeri ödemeleri için belirlediği tek işlem limiti geçerlidir (uygulama on binler bandında başladı, limitler dönemsel güncelleniyor). Karar kriteri basit: ortalama sepeti yüksek, taksitle satan bir mobilyacı kart rayına ağırlık verir; günde yüzlerce küçük fiş kesen kafe veya bakkal için FAST rayı nakit akışını doğrudan hızlandırır. Çoğu işletmede doğru cevap ikisini birden açıp müşteriye seçim bırakmaktır.

Dinamik ve Statik Karekod: Hangi Noktada Hangisi

Dinamik karekod, her satış için tutarı ve işlem referansını içeren tek kullanımlık koddur; genellikle 2-5 dakikalık geçerlilik süresi taşır ve müşteri tutar girmediği için eksik tahsilat riski ortadan kalkar. Statik karekod ise masaya, tezgaha ya da kuryenin çantasına yapıştırılan sabit koddur; müşteri tutarı kendi girer. Bir kafede doğru kurgu ikisinin birlikte kullanılmasıdır: masalarda statik kod hesap isteme trafiğini azaltır, kasada dinamik kod kuyruğu hızlandırır. Statik kodun en bilinen riski fiziksel manipülasyondur — kodun üzerine başka bir sticker yapıştırılması. Bunun için kodları lamine edin, masa numarasını kodun yanına basılı olarak yazın ve yazılım tarafında her statik kodun hangi masadan kaç tahsilat aldığını raporlayın; beklenmedik bir masadan gelen ödeme akışı anomali olarak fark edilebilir hale gelir.

POS ve ÖKC Üzerinden Karekod: Kasadaki Gerçek Akış

Banka POS yazılımlarında akış çoğunlukla aynıdır: kasiyer tutarı girer, ardından karekod işlemi için ayrılmış tuşa (bankaların büyük kısmında "0") basar, ekranda karekod belirir. Müşteri kendi bankasının uygulamasından okutur; temassız limitin altındaki tutarlarda şifre istenmez, üzerindeki tutarlarda uygulama içi doğrulama ya da kart şifresi devreye girer. Ingenico, PAX, Beko ve Sunmi gibi yaygın terminal ailelerinde destek mevcuttur, ancak marka-model bazında farklılık olabileceği için sahadaki cihaz envanterinizi baştan çıkarmak gerekir. Kasa yazılımı tarafında iki nokta atlanıyor: karekod tahsilatının fiş satırında ayrı bir ödeme tipi olarak görünmesi ve gün sonu Z raporuyla tutarlı çalışması. Bu ikisi kurulmazsa tahsilat gerçekleşir ama ciro raporu ile mali belge birbirini tutmaz; hatanın faturası gün sonu sayımında çıkar.

Dijital Cüzdanlar ve Online Kanal: Tokenizasyon Tarafı

Mağaza dışında, online tarafta konuştuğumuz şey aslında farklı bir teknoloji: Apple Pay ve Google Pay gibi cüzdanlar kart numarasını taşımaz, tokenizasyon ile üretilen şifreli bir jeton gönderir; kart verisi sizin sunucunuza hiç uğramaz. Bunun karşılığında bazı teknik ön koşullar gelir: geçerli HTTPS sertifikası, cüzdan sağlayıcısının istediği alan adı doğrulama dosyasının siteye yerleştirilmesi, PCI DSS kapsamına uygun mimari ve 3D Secure 2.0 akışıyla uyum. Karşılığı ölçülebilir bir dönüşüm kazancıdır: form doldurmayı ortadan kaldıran tek dokunuşluk ödeme, özellikle mobilde sepet terkini gözle görülür biçimde düşürür. Bu akış e-ticaret platform entegrasyonunuzla birlikte kurgulanır; hazır altyapı kullanıyorsanız cüzdan desteği eklenti seviyesinde açılabilirken, özel geliştirilen e-ticaret projelerinde ödeme sayfasının yeniden tasarlanması gerekebilir.

API, Webhook ve Kimsenin Test Etmediği Hata Senaryoları

Teknik akış üç uçtan ibarettir: ödeme oluşturma isteği (tutar, sipariş referansı, geçerlilik süresi), dönen karekod içeriği veya mobil için deep link, ve sonucun bildirilmesi. Sonuç iki yoldan gelir — sağlayıcının gönderdiği webhook ve sizin belirli aralıklarla yaptığınız durum sorgulaması. Sadece webhook'a güvenen kurulumlar sahada sorun çıkarır: bildirim gecikirse kasiyer ödemeyi görmez, ikinci kez karekod üretir, müşteri iki kez öder. Edge Bilişim olarak bu projelerde sandbox aşamasında önce mutlu senaryoyu değil kırık senaryoları koşuyoruz: webhook 30 saniye geciktiğinde, müşteri kodu okutup uygulamayı kapattığında, aynı sipariş için iki istek gittiğinde ne oluyor. Çözüm seti standarttır ama uygulanması gerekir — her istekte idempotency anahtarı, webhook imza doğrulaması, kod süresi dolduğunda otomatik iptal ve son sözü sorgulama sonucuna bırakan bir durum makinesi.

Mutabakat: Referans Numarası Zincirini Kurmak

QR tahsilatının mutabakatı, seçtiğiniz raya göre iki farklı yerden yürür. Kart rayında para valörle ve komisyon kesilmiş net tutar olarak gelir; eşleştirmeyi bankanın hakediş dosyası üzerinden yaparsınız. FAST rayında brüt tutar anında hesaba düşer ve eşleştirme banka hesap hareketleri üzerinden yapılır. Her iki durumda da işin kalbi tek bir şeydir: satış sırasında üretilen referans numarasının hem karekod içeriğine hem de hesap hareketinin açıklamasına taşınması. Bu zincir kurulmadığında gün sonunda "hesaba 47 bin TL geçmiş, sistemde 46.850 TL ciro var" tablosu ortaya çıkar ve farkı kimse bulamaz. Tahsilat kayıtları Logo, Mikro veya Netsis muhasebe entegrasyonuna aktarıldığında gelir kaydı ve komisyon gideri ayrı satırlar olarak düşer; kurumsal tarafta aynı akış SAP entegrasyonuyla finans modülüne bağlanır.

Sektör Senaryoları ve Personelin Benimsemesi

Restoran ve kafede masa bazlı statik karekod, adisyonun garson beklemeden kapanmasını sağlar; bahşiş adımı ödeme akışına eklendiğinde personel gelirini de korursunuz. Markette kasa kuyruğu için dinamik karekod, saha satış ve kuryede ise telefondan gösterilen kod işi çözer; markalı mobil uygulamanıza gömüldüğünde müşteri kodu okutmadan doğrudan uygulama içinden öder. Personelde ise gerçek engel teknik değil alışkanlıktır: kasiyer bilmediği tuşa basmak istemez. Edge Bilişim olarak devreye alırken karekodu satış ekranında ayrı ve büyük bir buton yapıyor, ilk iki hafta yöntem bazlı benimseme raporu çıkarıp hangi kasada QR'ın hiç kullanılmadığını görünür kılıyoruz. Yemekhane ve kurumsal müşteri ağırlıklı işletmelerde bu akış yemek kartı entegrasyonuyla birlikte planlanır; tek ekranda kart, QR ve yemek kartı yan yana durur.

Maliyet: İki Ayrı Kalem, Gerçekçi Aralıklar

QR ödemenin maliyeti iki kalemden oluşur ve karıştırılmamalıdır. Birincisi bankanın veya ödeme sağlayıcısının aldığı işlem ücretidir; kart rayında mevcut POS komisyon oranlarınız, FAST rayında ise çok daha düşük seviyeler geçerlidir ve bu kalem yazılım entegrasyonundan tamamen bağımsızdır. İkincisi tek seferlik geliştirme bütçesidir. Tek kanal ve tek sağlayıcıyla sınırlı, mevcut yazılıma karekod tahsilatı eklenmesi tipik olarak 40.000-90.000 TL bandında konumlanır. POS, mobil ve e-ticaretin birlikte kurulduğu, mutabakat ve muhasebe aktarımını da kapsayan çok kanallı projeler 90.000-250.000 TL aralığına oturur. Çok şubeli, ERP bağlantılı ve özel raporlama isteyen kurumsal kurulumlar 250.000 TL üzerine çıkar. Bütçeyi asıl belirleyen değişkenler: kanal sayısı, entegre edilecek sağlayıcı adedi, mevcut yazılımın kullanılabilir bir API'sinin olup olmadığı ve iade, taksit, puan gibi senaryoların kapsama dahil edilip edilmediğidir.

QR / Karekod Ödeme Entegrasyonu projenizi konuşalım — ihtiyacınızı ücretsiz analiz edelim, aynı gün dönüş yapalım.
WhatsApp
Sıkça Sorulan Sorular

QR Ödeme Entegrasyonu Hakkında Sık Sorulan Sorular

20 gerçek soruya net cevap — aradığınızı yazarak filtreleyin.

QR ödeme entegrasyonu, müşterinin telefonuyla karekod okutarak yaptığı tahsilatın POS, kasa veya e-ticaret yazılımınıza bağlanmasıdır. Yazılım tutara özel karekodu üretir, ödeme sonucu webhook veya durum sorgulamayla geri döner, tahsilat ciroya ve mutabakat kayıtlarına otomatik işlenir. Kasiyer tutar girmediği için yanlış tahsilat riski düşer, gün sonu eşleştirmesi kendiliğinden tutar.

Yardımcı olalım

QR / Karekod Ödeme Entegrasyonu konusunda bir projeniz ya da sorununuz mu var?

Edge Bilişim ekibi ihtiyacınızı ücretsiz analiz eder ve projeye özel net bir teklif sunar. Kaynak kodu size teslim edilen, lisans bağımlılığı olmayan çözümler; 200+ proje deneyimi ve 81 ilde uzaktan hizmet.

WhatsApp'tan Yazın Hemen Arayın

[email protected] · İstanbul (81 ile uzaktan hizmet)

Müşteri Yorumları

Müşterilerimiz Bizi Nasıl Değerlendiriyor?

5.0 3 değerlendirme Google Yorumları
5 100%
4 0%
3 0%
2 0%
1 0%
Google'da değerlendirin

Daha fazla yorum için kaydırın