Ziraatpay Sanal POS Nedir? Entegrasyon İçin Neler Gereklidir?
Güvenli ödeme altyapısı denildiğinde Türkiye’nin en köklü finans kurumlarından biri olan Ziraat Bankası güvencesiyle sunulan Ziraatpay, işletmelerin dijital tahsilat süreçlerini modern bir boyuta taşır. Peki, Ziraatpay Sanal POS tam olarak nedir ve Payfoni paneliniz üzerinden bu sistemi devreye almadan önce hangi verilere ihtiyacınız vardır?
Ziraatpay Sanal POS Nedir?
Ziraatpay, Ziraat Bankası iştiraki olan bir ödeme kuruluşudur. Web siteniz veya tahsilat kanallarınız üzerinden tüm banka kartlarından 7/24, güvenli ve hızlı ödeme almanızı sağlar. Özellikle kamu bankası güvencesi, yaygın kart ağı desteği ve rekabetçi komisyon oranlarıyla hem KOBİ'ler hem de büyük ölçekli işletmeler için stratejik bir tercihtir.
Entegrasyon Öncesi Hazırlık: Gereken API Bilgileri
Ziraatpay altyapısını Payfoni sisteminize hatasız bir şekilde bağlamak ve tahsilat akışını başlatmak için Ziraatpay Mağaza Paneli üzerinden şu teknik bilgileri temin etmelisiniz:
- Merchant ID (Mağaza Numarası): İşletmenize özel tanımlanan benzersiz kimlik numarasıdır.
- API Username (API Kullanıcı Adı): Sistemler arası veri trafiğinde yetkilendirme sağlayan kullanıcı bilgisidir.
- API Password (API Şifresi): API bağlantılarının doğrulanması ve güvenliğinin sağlanması için kullanılan şifredir.
- Secret Key (Gizli Anahtar): İşlem güvenliğini en üst düzeye çıkaran, veri şifrelemesinde kullanılan kritik güvenlik anahtarıdır.
Adım Adım Entegrasyon Süreci
Ziraatpay kurulum aşamasında dikkat etmeniz gereken temel adımlar şunlardır:
- API Yapılandırması: Ziraatpay tarafından size iletilen Mağaza ID, Kullanıcı Adı ve Şifre bilgilerinin Payfoni paneline doğru girilmesi.
- Taksit ve Ödeme Modeli: Müşterilerinize sunacağınız taksit seçeneklerinin Ziraat Bankası kart şemalarıyla uyumlu hale getirilmesi.
- Dönüş (Callback) URL Ayarları: Ödeme işlemi tamamlandığında sistemin siparişi otomatik onaylayabilmesi için başarılı/hatalı dönüş sayfalarının tanımlanması.
- Canlı İşlem Testi: Kurulum bittikten sonra "Test Modu" veya düşük tutarlı bir "Canlı İşlem" ile sistemin provizyon alıp almadığının doğrulanması.
ZiraatPay Sanal POS Entegrasyonu Nasıl Yapılır?
ZiraatPay Sanal POS altyapısını Payfoni üzerinden verimli bir şekilde kullanabilmek için aşağıdaki adımları sırasıyla tamamlamanız gerekmektedir.
1. Ödeme Servislerine Erişim
Entegrasyon sürecini başlatmak için Payfoni yönetim panelinizdeki servis listesine ulaşmalısınız.
- İşlem Yolu: Üye Firma Paneli > Uygulamalar
- Eylem: Bu sayfa üzerinden sisteminizde tanımlı olan ZiraatPay ve diğer tüm ödeme servislerini görüntüleyebilirsiniz.
2. ZiraatPay Servis Yönetimi
Listelenen servisler arasından ZiraatPay’i bularak durum yönetimi yapabilirsiniz.
- İşlem Yolu: Uygulamalar > ZiraatPay POS
- Detaylar: Bu ekranda servisi Aktif/Pasif konuma getirebilir, varsayılan ödeme yöntemi olarak atayabilir veya teknik detaylar için Ayarlar butonuna tıklayabilirsiniz.
3. API Yapılandırma Ayarları
ZiraatPay firmasından temin ettiğiniz teknik verilerin Payfoni sistemine işlendiği bölümdür.
- İşlem Yolu: ZiraatPay POS > Ayarlar > Yapılandırma
- Girilecek Bilgiler: Size özel tanımlanan Merchant ID, Merchant User Name ve Merchant API Password gibi kritik verileri bu alanlara eksiksiz giriniz. Dilerseniz "Varsayılan Ödeme Yöntemi" seçeneğini buradan işaretleyebilirsiniz.
4. Komisyon ve Taksit Yönetimi
Müşterilerinize sunacağınız ödeme seçeneklerini ve maliyet yapısını bu sekmeden kontrol edebilirsiniz.
- İşlem Yolu: ZiraatPay POS > Ayarlar > Komisyon Yönetimi
- Detaylar: Hangi taksit seçeneklerinin müşteriye gösterileceğini belirleyebilir; komisyon maliyetinin işletmeniz tarafından mı yoksa müşteri tarafından mı karşılanacağını seçebilirsiniz.
5. Banka Oranları ve Özel Tanımlamalar
Ziraat Bankası ve diğer bankaların güncel oranlarını yönetmek için bu alanı kullanın.
- Canlı Oranlar: Çalıştığınız bankaların oranlarını sistem üzerinden anlık ve canlı olarak çekebilirsiniz.
- Manuel Oran Ekleme: "Yeni Oran Ekle" butonu ile spesifik bir banka, taksit sayısı ve oran tipi belirleyerek özel tanımlamalar yapabilirsiniz.
- Önemli: Eklediğiniz veya güncellediğiniz her yeni oran satırını aktif konuma getirmeyi unutmayın.
6. İşlemi Onaylama ve Kaydetme
Yapılandırmanın geçerli olması ve ödeme sisteminin aktifleşmesi için verilerin kaydedilmesi ş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, ZiraatPay ayarlarınızın Payfoni sistemine sorunsuz kaydedildiği anlamına gelir.
Entegrasyon için görsel içeren rehberi inceleyin
ZiraatPay entegrasyonunu nasıl sağlıklı bir şekilde tamamlayacağınızı destek sayfamızdan görsellerle birlikte adım adım inceleyebilirsiniz:
