Wix ile Garanti POS Entegrasyonu: Detaylı Teknik Rehber

Garanti POS ve Wix: Bağlantı Mantığı

Garanti BBVA sanal POS'u Wix mağazasına bağlamak için iki yol bulunmaktadır. Birincisi Garanti ile direkt anlaşmalı bir ödeme aracı kuruluşu (iyzico, PayTR veya Sipay) aracılığıyla bağlanmaktır. İkincisi ise yalnızca iyzico gibi bir sağlayıcıyla çalışarak Garanti kartlarının bu sağlayıcı üzerinden işlenmesidir. Her iki yöntemde de temel akış benzerdir: merchant bilgileri API anahtarlarına dönüştürülür, Wix'e tanımlanır ve güvenlik testleri yapılır.

API Yapılandırması Adımları

Garanti POS API yapılandırması şu adımları içerir: Merchant ID ve terminal ID bilgileri GarantiPay panelinden alınır. API anahtar çifti (public key + secret key) oluşturulur. Seçilen payment provider paneline bu bilgiler girilir. Wix yönetim panelinde ödeme ayarları bölümünden sağlayıcı etkinleştirilir ve API anahtarları sisteme aktarılır. Para birimi TRY olarak seçilir. Minimum ve maksimum işlem tutarı sınırları, merchant anlaşmasına uygun biçimde yapılandırılır.

3D Secure URL Ayarları

GarantiPay panelinde üç URL tanımlanmalıdır: başarılı ödeme URL'si, başarısız ödeme URL'si ve hata URL'si. Bu URL'ler Wix mağazasındaki sipariş tamamlama ve hata sayfalarına işaret etmelidir. URL'lerin HTTPS ile başlaması ve geçerli SSL sertifikasına sahip domaine ait olması zorunludur. URL'ler tanımlandıktan sonra sandbox ortamında test ödemeleri yapılarak dönüşler doğrulanmalıdır.

Hata Kodları ve Çözüm Yolları

Garanti POS entegrasyonunda sık karşılaşılan hata kodları şunlardır: Hata 05 (genel red) genellikle kart limitinin aşılması veya bankanın işlemi red etmesini gösterir. Hata 12 (geçersiz işlem) çoğunlukla yanlış terminal ID kaynaklıdır. Hata 51 (bakiye yetersiz) müşteri kaynaklı bir sorundur. Hata 57 (bu kart türüne izin yok) ise taksit ayarlanmamış bir kart tipiyle ödeme denemesini işaret eder. Bu hatalar GarantiPay hata dokümantasyonunda ayrıntılı açıklanmıştır.

Blakfy ile Hatasız Garanti POS Kurulumu

Blakfy, Garanti BBVA sanal POS entegrasyonunu API yapılandırması düzeyinde gerçekleştirir. Hata kodu analizi, 3D Secure URL ayarları ve canlıya geçiş testlerinde uzman desteği sağlıyoruz. Mağazanızın Garanti müşterilerine kesintisiz hizmet vermesi için Blakfy ile iletişime geçin.