QNB Sanal POS API bilgilerimi Payfoni paneline nasıl tanımlarım?

QNB entegrasyonunu aktif etmek için Payfoni panelinizde Uygulamalar > QNB Finansbank POS > Ayarlar yolunu izleyerek "Yapılandırma" sekmesine ulaşmanız yeterlidir. Bu alana bankadan aldığınız Merchant ID, Terminal ID, Store Key, API Kullanıcı Adı ve Şifresi bilgilerini girerek kaydettiğinizde sistem saniyeler içinde aktif hale gelir. Herhangi bir kodlama veya teknik kurulum süreciyle uğraşmanıza gerek kalmaz.

QNB entegrasyonu ile müşterilerime CardFinans taksit seçenekleri sunabilir miyim?

Evet. QNB Finansbank entegrasyonu sayesinde CardFinans özellikli kartlara özel taksit imkanlarını doğrudan sunabilirsiniz. Payfoni panelindeki "Komisyon Yönetimi" sekmesinden hangi taksit sayılarını aktif edeceğinizi ve oranlarınızı kolayca yönetebilir, bankanın sunduğu kampanya avantajlarını müşterilerinize yansıtabilirsiniz.

API kullanıcı bilgilerini QNB panelinden oluştururken nelere dikkat etmeliyim?

Güvenliğiniz için QNB üye işyeri panelinde oluşturacağınız kullanıcının mutlaka "API Kullanıcısı" yetkisine sahip olması gerekir. Bilgileri Payfoni paneline kopyalarken Terminal ID ve Store Key gibi hassas verilerin başında veya sonunda boşluk kalmadığından emin olmanız, bağlantı hatası almamanız için kritiktir.

Tanımladığım taksit oranları ödeme sayfasında neden görünmüyor?

Oranların ödeme sayfasında aktifleşmesi için Payfoni panelindeki "Banka Oranları" sekmesinde, QNB Finansbank için girdiğiniz her bir taksit satırının yanındaki butonu "Aktif" konuma getirmeniz gerekir. Oranları girmiş olsanız bile aktif edilmeyen seçenekler müşterilerinize sunulmaz.

İşlemlerimi takip etmek için her seferinde QNB üye işyeri paneline girmem gerekiyor mu?

Hayır. Entegrasyon tamamlandıktan sonra QNB üzerinden geçen tüm başarılı veya başarısız işlemler, iade süreçleri ve tahsilat detayları anlık olarak Payfoni panelinize yansır. İşletmenizin nakit akışını ve satış raporlarını yönetmek için banka paneline girmeye gerek kalmadan her şeyi tek bir merkezi ekrandan takip edebilirsiniz.

Payfoni ile entegrasyon kurmak için yazılımcı desteği almam şart mı?

Kesinlikle hayır. Payfoni, "Tak-Çalıştır" mantığıyla tasarlanmıştır. QNB veya diğer banka entegrasyonları fark etmeksizin; karmaşık kod bloklarıyla uğraşmanıza gerek kalmadan, sadece size özel API anahtarlarını paneldeki ilgili alanlara girerek süreci tamamlayabilirsiniz. Teknik bariyerleri ortadan kaldıran arayüzümüz sayesinde işletmenizi dakikalar içinde ödeme almaya hazır hale getirirsiniz.

Neden her banka veya ödeme kuruluşu için ayrı panel kullanmak yerine Payfoni’yi tercih etmeliyim?

Finansal operasyonlardaki en büyük zaman kaybı, farklı banka panelleri arasında kaybolmaktır. Payfoni, QNB Sanal POS tahsilatlarınızdan banka hesap hareketlerinize, iade işlemlerinden muhasebe kayıtlarınıza kadar her şeyi tek şifre ve tek panelle yönetmenizi sağlar. Bu merkeziyetçilik, hata payını sıfıra indirirken verimliliğinizi %100 artırır.

Payfoni’nin "2026 Hız Standardı" finansal süreçlerime ne katar?

Günümüz ticaretinde hız, nakit akışı demektir. Payfoni’nin sunduğu anlık veri akışı sayesinde, QNB üzerinden yapılan bir tahsilat saniyeler içinde panelinize, raporlarınıza ve entegre muhasebe yazılımınıza yansır. Bu hız, size nakit akışınızı gerçek zamanlı raporlarla kontrol etme ve anında doğru finansal kararlar alma gücü verir.

Payfoni QNB Entegrasyonu: Sanal POS Kurulumu

Payfoni QNB Sanal POS Entegrasyonu Nasıl Yapılır?

Payfoni Editor

13 April 2026

6 MIN READ

QNB Sanal POS Nedir? Entegrasyon İçin Neler Gereklidir?

E-ticaret sitenizde banka güvenini doğrudan yansıtmak ve Türkiye'nin en yaygın kart programlarından birine özel avantajlar sunmak istiyorsanız, en profesyonel çözümlerden biri QNB Finansbank tarafından sunulan sanal POS altyapısıdır. Doğrudan banka ile çalışmak, işletmenize hem kurumsal bir prestij kazandırır hem de belirli işlem hacimlerinde size özel finansal çözümler sunar.

QNB Sanal POS Nedir?

Bu sistem, işletmelerin web siteleri üzerinden kredi kartı ve banka kartı ile güvenli bir şekilde tahsilat yapmalarını sağlayan, doğrudan QNB Finansbank iştiraki olan bir altyapıdır. 3D Secure tam uyumu, yüksek hızlı provizyon süreleri ve bankanın kendi güvenlik katmanlarıyla donatılmıştır. Özellikle CardFinans sahiplerine sunulan artı taksit ve puan gibi kampanyaları doğrudan yönetmenize olanak tanır.

Entegrasyon Öncesi Hazırlık: Gereken Bilgiler

QNB Finansbank altyapısını sisteminize entegre edebilmeniz için banka tarafından başvurunuzun onaylanmış olması ve size özel teknik verilerin iletilmiş olması gerekir. Kurulum için şu bilgiler temel taşlardır:

Üye İşyeri Numarası (Merchant ID): Banka tarafından işletmenize özel olarak tanımlanan ana kimlik numarasıdır.
Terminal ID: İşlemlerin web siteniz üzerinden bankaya akmasını sağlayan uç birim kodudur.
API Kullanıcı Adı ve Şifresi: Bankanın V-POS yönetim panelinden oluşturulan, web sitenizin banka sunucularıyla güvenli bir şekilde konuşmasını sağlayan yetkili kullanıcı bilgileridir.
3D Güvenlik Anahtarı (Store Key): Güvenli ödeme (3D Secure) işlemlerinin doğrulanması için kullanılan gizli şifredir.

Adım Adım Entegrasyon Süreci

QNB Sanal POS kurulumunda izlenecek teknik yol haritası şu şekildedir:

API ve Güvenlik Yapılandırması: Bankadan alınan Terminal ve API bilgilerinin sisteme hatasız girilmesi.
Taksit ve Komisyon Tanımlama: QNB Finansbank ile anlaştığınız taksit seçeneklerinin ve komisyon oranlarının sisteme işlenmesi.
URL Tanımlamaları: Başarılı ve başarısız işlem dönüşlerinin (Return URL) banka paneline kaydedilmesi.
IP İzinleri: Bankanın güvenliği gereği, web sitenizin barındığı sunucu IP adresinin banka paneline "Güvenli IP" olarak eklenmesi.

Neden QNB Sanal POS Kullanmalısınız?

Doğrudan Banka Desteği: Aracı kurum olmadan doğrudan QNB Finansbank ile muhatap olursunuz.
Gelişmiş Kampanya Yönetimi: CardFinans'a özel taksit ve puan kampanyalarını en verimli şekilde kullanırsınız.
Kurumsal İmaj: Ödeme sayfasında doğrudan banka logolarının bulunması müşteri güvenini artırır.

QNB Sanal POS Entegrasyonu Nasıl Yapılır?

QNB (Finansbank) Sanal POS altyapısını Payfoni sisteminizde sorunsuz bir şekilde kullanabilmek için aşağıdaki teknik adımları sırasıyla takip etmeniz gerekmektedir.

1. Ödeme Servislerine Erişim

Entegrasyon sürecinin ilk adımı, sisteminizdeki mevcut ödeme yöntemlerine ulaşmaktır.

İşlem Yolu: Payfoni Yönetim Paneli > Üye Firma Paneli > Uygulamalar
Eylem: Bu sayfa, sisteminizde sizin için tanımlı olan tüm ödeme servislerini yönetebileceğiniz ana merkezdir. Burada yer alan listede QNB modülünün hazır olup olmadığını kontrol edin.

2. QNB Servis Yönetimi ve Aktivasyon

Listelenen servisler içerisinden QNB Finansbank’ı bularak aktiflik durumunu belirleyebilirsiniz.

İşlem Yolu: Uygulamalar > QNB Finansbank POS
Detaylar: Bu alanda servisi Aktif/Pasif konuma getirebilir, mağazanızın ana ödeme yöntemi yapmak için Varsayılan olarak atayabilir veya teknik detayları girmek için Ayarlar butonuna ilerleyebilirsiniz.

3. API Yapılandırma ve Güvenlik Ayarları

Banka tarafından size iletilen veya panelden aldığınız teknik verilerin sisteme eşlendiği en kritik aşamadır.

İşlem Yolu: QNB POS > Ayarlar > Yapılandırma
Girilecek Kritik Bilgiler:
- Merchant ID (Üye İşyeri Numarası): Bankanın işletmenizi tanımak için verdiği özel kod.
- Terminal ID: İşlem trafiğinin yönetildiği sanal terminal numarası.
- Store Key (Güvenlik Anahtarı): 3D Secure güvenli ödeme işlemleri için banka tarafında üretilen şifre.
- API Kullanıcı Adı ve Şifre: Sistemin banka sunucularıyla konuşmasını sağlayan yetkili giriş bilgileri.

3.1. QNB Üye İşyeri Panelinden API Bilgileri Nasıl Alınır?

Entegrasyon için gerekli verileri QNB Finansbank (Üye İşyeri) panelinden şu adımları izleyerek temin edebilirsiniz:

Panele Giriş: QNB Finansbank Üye İşyeri Paneli üzerinden kullanıcı bilgilerinizle oturum açın.
API Kullanıcısı: Yönetim > Kullanıcı İşlemleri menüsünü takip ederek, "API Kullanıcısı" yetkisine sahip yeni bir hesap oluşturun ve bu hesabın şifresini güvenli bir yere not edin.
Güvenlik Anahtarı: Güvenlik Ayarları / 3D Secure bölümünden mevcut Store Key’inizi görüntüleyin.

Önemli Hatırlatma: Kopyalama işlemi yaparken karakterlerin başında veya sonunda boşluk kalmadığından emin olun; aksi takdirde bağlantı hatası alabilirsiniz.

4. Komisyon ve Taksit Stratejisi

Müşterilerinize sunacağınız ödeme seçeneklerini ve bu işlemlerin maliyet yükünü bu sekmeden özelleştirebilirsiniz.

İşlem Yolu: QNB POS > Ayarlar > Komisyon Yönetimi
Detaylar: CardFinans özellikli kartlar için kaç taksite kadar izin vereceğinizi belirleyin. Ayrıca banka komisyonunun sepete mi yansıtılacağını yoksa tarafınızdan mı karşılanacağını buradan seçebilirsiniz.

5. Banka Oranları ve Dinamik Tanımlamalar

QNB ve diğer bankaların güncel oranlarını tek bir merkezden yöneterek finansal kontrolü sağlayın.

Manuel Tanımlama: "Yeni Oran Ekle" butonuyla spesifik taksit sayılarına özel oranlar girebilirsiniz.
Toplu Güncelleme: Belirlediğiniz oranları "Tüm Bankalara Uygula" diyerek hızlıca sisteme yayabilirsiniz.
Kritik Not: Tanımladığınız her taksit oranının yanındaki Aktif butonunun açık olduğundan emin olun. Pasif olan oranlar ödeme sayfasında müşteriye sunulmaz.

6. Verilerin Doğrulanması ve Kayıt

Yapılan tüm konfigürasyonun geçerli olması için kaydetme işleminin yapılması şarttır.

Son Adım: Tüm kontrolleri tamamladıktan sonra sağ alt kısımda yer alan "Kaydet" butonuna basın.
Onay: Ekranın üst bölgesinde yeşil renkli "İşlem Başarılı" bildirimini gördüğünüzde, QNB Sanal POS entegrasyonunuz tamamlanmış ve mağazanız ödeme almaya hazır hale gelmiş demektir.