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

Ziraatpay entegrasyonunu aktif etmek için Payfoni panelinizde Uygulamalar > ZiraatPay POS > Ayarlar yolunu izleyerek "Yapılandırma" sekmesine ulaşmanız yeterlidir. Bu alana Ziraatpay tarafından size iletilen Merchant ID, Merchant User Name ve Merchant API Password gibi teknik verileri girerek kaydettiğinizde sistem saniyeler içinde aktif hale gelir. Herhangi bir kodlama veya teknik kurulum süreciyle uğraşmanıza gerek kalmaz.

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

Evet. Ziraatpay entegrasyonu sayesinde Ziraat Bankası kart şemaları başta olmak üzere tüm bankaların kart programlarına tek merkezden taksit imkanı sunabilirsiniz. Payfoni panelindeki "Komisyon Yönetimi" sekmesinden hangi taksit sayılarını aktif edeceğinizi ve oranlarınızı kolayca yönetebilir, banka bazlı kampanya avantajlarını ödeme sayfanıza yansıtabilirsiniz.

Ziraatpay panelinden API bilgilerimi (Merchant ID, User Name, Password) nasıl alırım?

Ziraatpay Mağaza Paneli’ne giriş yaptıktan sonra teknik ayarlar veya entegrasyon bilgileri bölümünden size özel tanımlanmış olan Merchant ID, API Username ve API Password bilgilerinize ulaşabilirsiniz. Bu bilgileri kopyalayıp Payfoni panelindeki ilgili alanlara yapıştırmanız yeterlidir. Kopyalama işlemi sırasında karakterlerin 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, Ziraatpay için girdiğiniz her bir taksit satırının yanındaki butonu "Aktif" konuma getirmeniz gerekir. Oranları sisteme işlemiş olsanız bile aktif edilmeyen seçenekler müşterilerinize ödeme adımında sunulmaz.

İşlemlerimi takip etmek için her seferinde Ziraatpay mağaza paneline girmem gerekiyor mu?

Hayır. Entegrasyon tamamlandıktan sonra Ziraatpay ü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. İşletmenizdeki nakit akışını ve satış raporlarını yönetmek için farklı paneller arasında geçiş yapmanıza gerek kalmaz; her şeyi tek bir merkezi ekrandan, 2026 teknolojisinin hızıyla 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. Ziraatpay 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 ve ödeme kuruluşlarının panelleri arasında kaybolmaktır. Payfoni, tüm bu hantal yapıyı tek bir akıllı ekosistemde birleştirir. 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önetirsiniz. 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, ödemelerinizin veya transferlerinizin sisteme düşmesini beklemezsiniz. İşlemler gerçekleştiği saniyede 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 ZiraatPay Entegrasyonu: Sanal POS Kurulumu

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

Payfoni Editor

30 March 2026

6 MIN READ

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.