QNB Finansbank POS’unu Wix’te Kullanma

QNB Finansbank POS'un Wix'te kullanılabilmesi, bankanın sunduğu API servislerinin Velo backend üzerinden işlenmesiyle mümkün oluyor. Bu entegrasyon, işletmelere hem güvenli hem de şeffaf bir ödeme süreci sunuyor. Özellikle QNB Finansbank ile çalışan şirketler için Wix platformunda yerel banka POS'u kullanabilmek büyük bir kolaylık sağlıyor.

QNB Finansbank Sanal POS Wix'te Kullanılabilir mi?

Evet, QNB Finansbank Sanal POS Wix platformunda kullanılabilir. Bu entegrasyon, Velo by Wix geliştirme ortamı üzerinden özel backend yapısıyla gerçekleştirilir. Bankadan alınan API bilgileri sisteme tanımlandığında QNB Finansbank POS Wix üzerinde tam uyumlu şekilde çalışır.

Entegrasyonun sağladığı imkanlar arasında 3D Secure 2.0 destekli güvenli ödemeler, CardFinans ve diğer kart programı avantajları, 2-12 ay arası esnek taksit seçenekleri, hızlı provizyon ve işlem onayı, rekabetçi komisyon oranları ve kapsamlı raporlama imkanı yer alıyor.

Teknik yapı incelendiğinde Wix'in standart ödeme sistemleri dışında özel POS entegrasyonları için Velo geliştirme ortamı kullanılıyor. Backend kodları ile QNB Finansbank API'sine güvenli bağlantı kuruluyor. 3D Secure yönlendirmeleri ve callback işlemleri yönetiliyor. Sipariş durumu güncellemeleri otomatik olarak gerçekleştiriliyor.

QNB Finansbank POS'un Avantajları

QNB Finansbank, Türkiye'nin önde gelen bankalarından biri olarak e-ticaret işletmelerine kapsamlı ödeme çözümleri sunuyor.

Banka avantajları değerlendirildiğinde CardFinans ve Bonus kart ekosistemi entegrasyonu öne çıkıyor. Geniş müşteri tabanına erişim sağlanıyor. KOBİ'lere özel avantajlı komisyon oranları mevcut. Güçlü dijital bankacılık altyapısı bulunuyor. 7/24 teknik destek hizmeti sunuluyor.

Ödeme özellikleri arasında Visa, Mastercard, Troy ve American Express desteği, 3D Secure 2.0 ile güçlendirilmiş güvenlik, esnek taksit seçenekleri, BIN bazlı kampanya yönetimi ve gelişmiş fraud koruma sistemleri yer alıyor.

Başvuru Süreci ve Gerekli Bilgiler

QNB Finansbank POS'u Wix'te kullanmaya başlamadan önce bankadan sanal POS başvurusu yapılması gerekir.

Başvuru için gerekli belgeler olarak güncel vergi levhası, noter onaylı imza sirküleri, ticaret sicil gazetesi sureti, faaliyet belgesi, şirket yetkilisi kimlik fotokopisi, web sitesi URL'i ve içerik bilgisi ile QNB Finansbank hesap bilgileri istenir.

Başvuru onayı sonrası alınacak API bilgileri arasında MbrId (Üye İşyeri Numarası - 5 haneli), MerchantId (İşyeri Kodu - 16 haneli), MerchantPass (İşyeri Şifresi), UserCode (Kullanıcı Kodu), UserPass (Kullanıcı Şifresi) ve SecureKey (3D Secure şifreleme anahtarı) bulunur.

Başvuru kanalları olarak QNB Finansbank şubeleri, online başvuru portalı, ticari bankacılık temsilcisi ve QNB Finansbank işletme bankacılığı hattı kullanılabilir.

Wix Velo Üzerinde Entegrasyon Adımları

Entegrasyon, Velo by Wix geliştirme ortamı üzerinden gerçekleştirilir. Bağlantı süreci, API bilgilerinin sistemde tanımlanmasıyla başlar.

Velo kurulum adımları şu şekildedir: Wix Editor'da Dev Mode aktifleştirilir. Backend klasöründe finansbankPOS.jsw dosyası oluşturulur. Secrets Manager'da API bilgileri güvenli şekilde saklanır. HTTP fonksiyonları ile callback endpoint'leri tanımlanır.

Secrets Manager yapılandırması için önerilen secret isimleri FINANSBANK_MBR_ID, FINANSBANK_MERCHANT_ID, FINANSBANK_USER_CODE, FINANSBANK_USER_PASS ve FINANSBANK_SECURE_KEY şeklindedir. Bu bilgiler kesinlikle frontend kodlarında bulunmamalıdır.

API endpoint bilgileri olarak test ortamı için vpostest.qnbfinansbank.com adresi, production ortamı için vpos.qnbfinansbank.com adresi kullanılır.

3D Secure Ödeme Akışı

Ödeme akışı sırasında müşteri, Wix üzerinden ödeme yaparken otomatik olarak QNB Finansbank'ın 3D doğrulama ekranına yönlendirilir.

Ödeme akışı şu şekilde işler: Müşteri sepet sayfasında ödeme butonuna tıklar ve kart bilgilerini güvenli form alanlarına girer. Sistem arka planda hash değerlerini hesaplar ve form verilerini hazırlar. Müşteri QNB Finansbank 3D Secure sayfasına otomatik yönlendirilir. SMS kodu veya QNB Mobil onayı ile işlem doğrulanır. Kullanıcı bankanın güvenlik adımlarını tamamladıktan sonra işlem sonucu callback URL üzerinden sisteme iletilir. Bu veriler doğrulandıktan sonra ödeme Wix sipariş sistemine işlenir. Müşteri başarılı ödeme sayfasına yönlendirilir.

Callback URL yapılandırması için iki adet endpoint tanımlanır. SuccessUrl başarılı işlemler için https://www.siteadiniz.com/_functions/finansbank-success formatında, FailUrl başarısız işlemler için https://www.siteadiniz.com/_functions/finansbank-fail formatında oluşturulur.

Hash Hesaplama ve Güvenlik

QNB Finansbank, işlem güvenliğini sağlamak için hash doğrulaması gerektirir. Hash hesaplama entegrasyonun kritik bileşenidir.

Hash hesaplama parametreleri belirli bir sırayla birleştirilir ve SHA-512 algoritmasıyla şifrelenir. Parametreler MbrId, OrderId, Amount, OkUrl, FailUrl, TxnType, InstallmentCount, Rnd ve SecureKey sıralamasıyla kullanılır.

Hash hesaplama kuralları olarak parametreler belirtilen sırayla birleştirilmelidir. Boşluk veya ayırıcı karakter kullanılmamalıdır. Tutar kuruş dahil, nokta veya virgül olmadan yazılmalıdır. Encoding UTF-8 olmalıdır.

Güvenlik önlemleri arasında API bilgilerinin Secrets Manager'da saklanması, HTTPS protokolünün zorunlu kullanımı, hash doğrulamasının her işlemde yapılması ve PCI DSS uyumlu yapılandırma yer alır.

Taksit ve CardFinans Avantajları

QNB Finansbank POS, kapsamlı taksit seçenekleri ve CardFinans programı avantajları sunuyor.

Taksit parametreleri için InstallmentCount değeri kullanılır. Tek çekim için boş veya 1 gönderilir. Taksitli işlemler için 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 değerleri kullanılır.

CardFinans avantajları kapsamında CardFinans kart sahiplerine özel ek taksit imkanı, puan kazanımı ve harcama imkanı, özel kampanya dönemlerinde avantajlı teklifler ve BIN bazlı kampanya yönetimi sunuluyor.

BIN bazlı taksit kontrolü ile kart numarasının ilk 6 hanesi kullanılarak o karta uygulanabilecek taksit seçenekleri ve kampanyalar sorgulanabilir.

Hata Yönetimi

Ödeme entegrasyonlarında kapsamlı hata yönetimi kullanıcı deneyimi için kritik öneme sahiptir.

Yaygın hata kodları ve açıklamaları şöyledir: 00 kodu başarılı işlemi, 01 kodu kartı veren bankayı aramayı, 05 kodu onaylanmayan işlemi, 12 kodu geçersiz işlemi, 14 kodu geçersiz kart numarasını, 33 kodu süresi dolmuş kartı, 41 kodu kayıp kartı, 43 kodu çalıntı kartı, 51 kodu yetersiz bakiyeyi, 54 kodu kartın son kullanma tarihinin geçtiğini ve 91 kodu bankadan yanıt alınamadığını gösterir.

Hata yönetimi stratejisi olarak kullanıcıya anlaşılır mesajlar gösterilmeli, teknik detaylar loglanmalı, kritik hatalarda bildirim sistemi kurulmalı ve gerektiğinde retry mekanizması uygulanmalıdır.

Test ve Canlıya Geçiş

Entegrasyon tamamlandıktan sonra kapsamlı test süreci zorunludur.

Test ortamı bilgileri olarak test endpoint adresi vpostest.qnbfinansbank.com üzerinden sağlanır. Test kart bilgileri QNB Finansbank tarafından başvuru onayı sonrası iletilir.

Test senaryoları olarak başarılı tek çekim ödeme, başarılı taksitli ödemeler, CardFinans kartı ile ödeme, yetersiz bakiye senaryosu, geçersiz kart senaryosu, 3D Secure timeout senaryosu, iade işlemi ve provizyon iptal işlemi test edilmelidir.

Canlıya geçiş adımları şu şekildedir: Tüm test senaryoları başarıyla tamamlanır. Test ortamı bilgileri production bilgileriyle değiştirilir. Endpoint URL'leri güncellenir. İlk gerçek işlem düşük tutarla test edilir. İşlem hem Wix panelinden hem QNB Finansbank POS panelinden doğrulanır.

Raporlama ve Takip

Entegrasyon sonrası ödeme hareketleri hem Wix hem QNB Finansbank

panelinden izlenebilir.

Wix tarafında izleme için Wix Stores Dashboard'dan siparişler takip edilir. Ödeme durumları görüntülenir. Özel raporlama için Wix Analytics kullanılabilir.

QNB Finansbank POS panelinde izleme kapsamında günlük işlem özeti, taksit dağılımı raporu, kart tipi bazlı analiz, CardFinans işlem raporu, iade ve iptal raporu ile mutabakat raporları görüntülenebilir.

QNB Finansbank POS'un Wix'te kullanılabiliyor olması, özellikle bankayla çalışan şirketler için büyük bir kolaylık sağlıyor. Bu yapı işletmelere hem güvenli hem de şeffaf bir ödeme süreci sunuyor. CardFinans ekosistemi, rekabetçi komisyon oranları ve güçlü teknolojik altyapı, işletmelere önemli avantajlar sağlıyor. Entegrasyon tamamlandığında 3D Secure destekli güvenli ödeme akışları sorunsuz çalışıyor ve işletme sahibi tüm ödeme süreçlerini çift taraflı olarak izleyebiliyor.

QNB Finansbank POS entegrasyonu ve Wix e-ticaret çözümleri için Blakfy ile iletişime geçin: blakfy.com/iletisim