1. Ödeme Servislerine Erişim
Entegrasyon sürecini başlatmak için öncelikle servis listesine ulaşmalısınız.
- İşlem Yolu: Üye Firma Paneli > Uygulamalar > Ödeme Servisleri
- Eylem: Bu sayfa üzerinden sisteminizde tanımlı olan tüm ödeme servislerini görüntüleyebilirsiniz.
2. Garanti BBVA Servis Yönetimi
Listelenen servisler arasından Garanti BBVA kartını bularak durum yönetimi yapabilirsiniz.
- İşlem Yolu: Uygulamalar > Garanti BBVA Sanal POS > Uygulamayı Bağla
- Detaylar: Bu ekranda servisi Aktif/Pasif konuma getirebilir, varsayılan ödeme yöntemi olarak atayabilir veya yapılandırma için Ayarlar butonuna tıklayabilirsiniz.
3. API Yapılandırma Ayarları
Garanti BBVA firmasından temin ettiğiniz teknik bilgilerin Payfoni sistemine tanımlandığı bölümdür.
İşlem Yolu: Garanti BBVA POS > Uygulamayı Bağla > Yapılandırma
Girilecek Bilgiler:
- Üye İşyeri No (MerchantID): Banka tarafından size verilen Merchant ID bilgisi.
- Terminal No (TerminalID): Banka tarafından atanan terminal numarası.
- Provizyon Şifresi (ProvAut): Sanal POS yönetim panelinizden aldığınız şifre.
- İade/İptal Şifresi (ProvRFN): İptal ve iade işlemlerinde kullanılacak şifre (Boş bırakılırsa provizyon şifresi kullanılır).
- 3D Store Key: Callback hash doğrulama anahtarı.
- Provizyon Kullanıcısı (ProvUser): Provizyon işlemleri için kullanıcı adı.
- İade Kullanıcısı (ProvUser): İade işlemleri için kullanıcı adı.
- İşyeri Adı (CompanyName): 3D ödeme formunda görünecek işyeri adı.
- Test Ortamı: Canlı veya test ortamı seçimi.
- 3D Gateway URL (GT3DEngine): (İsteğe bağlı) Test veya canlı moduna göre sistem otomatik tanımlar.
- VPServlet URL: (İsteğe bağlı) Test veya canlı moduna göre sistem otomatik tanımlar.
- Varsayılan POS: POS'un varsayılan olarak seçilip seçilmeyeceği bilgisi.
3.1. Garanti BBVA Panelinden API Bilgileri Nasıl Alınır?
Paneldeki kurulumu tamamlamak için ihtiyacınız olan teknik verileri Garanti BBVA sanal POS yönetim panelinizden şu adımları izleyerek temin edebilirsiniz:
- Garanti BBVA Paneline Giriş: Garanti BBVA sanal POS yönetim paneline firmanıza ait Üye İşyeri Numarası, Kullanıcı Kodu ve Parola bilgilerinizle giriş yapın. SMS doğrulamasını tamamlayın.
API Bilgilerine Erişim:
Üye İşyeri ve Terminal Numaralarına Erişim
- Üst menüde yer alan Yönetim sekmesine tıklayın.
- Sol menüden Üye İşyeri Bilgileri ve Terminal Arama/Listeleme alanlarına giderek şu bilgileri not edin:
- Üye İşyeri No (MerchantID): Banka tarafından firmanıza atanan 9 haneli benzersiz kimlik numarasıdır.
- Terminal No (TerminalID): Sanal POS işlemlerinizin geçeceği 8 haneli terminal numarasıdır.
API Kullanıcı Adları ve Şifrelerinin Üretilmesi
- Üst menüden Kullanıcı Yönetimi > API Kullanıcıları (veya Güvenlik Ayarları) sekmesine geçiş yapın.
- Listelenen teknik kullanıcılar arasından işlem tipine göre seçim yaparak şifrelerinizi üretin:
- Provizyon Kullanıcısı (ProvAut): Ödeme alma ve yetkilendirme süreçleri için kullanılan, genellikle PROVAUT ile başlayan kullanıcı adıdır. Yanındaki "Şifre Değiştir/Üret" butonuna basarak Provizyon Şifresi oluşturun.
- İade/İptal Kullanıcısı (ProvRFN): Gün sonu iptalleri ve iade işlemlerini gerçekleştirmek için kullanılan, genellikle PROVRFN ile başlayan kullanıcı adıdır. Yanındaki butondan İade/İptal Şifresi üretin.
Not: Sistem bu şifreleri güvenlik nedeniyle ekranda sadece bir kez gösterir, hemen kopyalamanız gerekir.
3D Secure Anahtarının Alınması
- Sol veya üst menüde yer alan 3D Secure İşlemleri > İşyeri Anahtarı (Store Key) Tanımlama alanına gidin.
- Ekranda yer alan 3D Store Key kodunu kopyalayın. Eğer daha önce tanımlanmadıysa, "Yeni Anahtar Üret" butonuna basarak harf ve rakamlardan oluşan şifrenizi oluşturup kaydedin.
Verilerin Aktarılması: Panelde görüntülenen aşağıdaki bilgileri kopyalayarak Payfoni panelindeki ilgili alanlara yapıştırın:
- Üye İşyeri No (MerchantID): Banka tarafından size atanan benzersiz işyeri kimlik numarasıdır.
- Terminal No (TerminalID): İşlemlerinizin tanımlı olduğu terminal numarasıdır.
- Provizyon Şifresi (ProvAut): İşlem yetkilendirme ve ödeme süreçleri için gerekli olan şifredir.
- İade/İptal Şifresi (ProvRFN): İptal ve iade işlemlerini gerçekleştirmek için kullanılan özel şifredir.
- 3D Store Key: 3D Secure işlemleri için kullanılan callback hash doğrulama anahtarıdır.
- Provizyon ve İade Kullanıcısı (ProvUser): Sistemin yetkilendirme işlemleri için kullandığı kullanıcı adlarıdır.
Boşluk Kontrolü: Bilgileri kopyalarken başında veya sonunda sistemin hata vermesine sebep olabilecek boşluklar kalmadığından emin olun.
4. Komisyon ve Taksit Yönetimi
Müşterilerinize sunacağınız taksit seçeneklerini ve maliyet yönetimini bu sekmeden kontrol edebilirsiniz.
İşlem Yolu: Garanti BBVA POS > Ayarlar > Komisyon Yönetimi
Detaylar: Garanti BBVA'nın desteklediği (Bonus, World, Axess vb.) tüm kart aileleri için hangi taksit seçeneklerinin aktif olacağını belirleyebilir; komisyon maliyetinin yansıtılma şeklini seçebilirsiniz.
5. Banka Oranları ve Özel Tanımlamalar
Garanti BBVA panelindeki güncel oranların Payfoni sistemine doğru yansıması için bu alanı kullanın.
- Manuel Oran Ekleme: "Yeni Oran Ekle" butonu ile ilgili taksit sayısını ve oranını girin.
- Toplu Uygulama: Garanti BBVA farklı kart aileleri (Bonus vb.) için özel oranlar sunabildiği için, oranları tanımlarken bu kart bazlı yapılandırmaları dikkatlice kontrol edin.
- Önemli: Eklediğiniz her yeni orandan sonra ilgili satırı aktif konuma getirmeyi unutmayın.
6. İşlemi Onaylama ve Kaydetme
Yapılandırmanın geçerli olması için verilerin sisteme işlenmesi şarttır.
- Son Adım: Tüm ayarları bitirdiğinizde sağ alt köşede bulunan "Kaydet" butonuna tıklayın.
Doğrulama: Ekranın üst kısmında "İşlem Başarılı" uyarısını görmeniz, ayarlarınızın sorunsuz kaydedildiği ve Garanti BBVA entegrasyonunuzun hazır olduğu anlamına gelir.