PayTR Sanal POS Nedir? Entegrasyon İçin Neler Gereklidir?
E-ticaret dünyasında güvenli ve hızlı ödeme almak, müşteri memnuniyetinin temel taşıdır. Türkiye'nin en köklü ödeme kuruluşlarından biri olan PayTR, işletmelere tek bir anlaşma ile tüm bankaların kartlarından ödeme alma imkanı sunar. Peki, PayTR Sanal POS tam olarak nedir ve sisteminize entegre etmeden önce neleri hazırlamalısınız?
PayTR Sanal POS Nedir?
PayTR, BDDK lisanslı bir ödeme kuruluşudur. İşletmenizin web sitesi üzerinden kredi kartı veya banka kartı ile güvenli (3D Secure) ödeme almanızı sağlayan bir köprü görevi görür. Ertesi gün ödeme avantajı, gelişmiş sahtecilik (fraud) önleme filtreleri ve kullanıcı dostu arayüzü ile bilinir.
Entegrasyon Öncesi Hazırlık: Gereken Bilgiler
PayTR entegrasyonunu sağlıklı bir şekilde tamamlayıp ödeme almaya başlamak için öncelikle PayTR Mağaza Paneli üzerinden teknik verilerinizi almanız gerekir. Bu bilgiler, web siteniz ile ödeme altyapısı arasındaki güvenli iletişimi sağlar:
- Mağaza No (Merchant ID): İşletmenize özel tanımlanan kimlik numarasıdır.
- Mağaza Parolası (Merchant Key): API bağlantılarında kimlik doğrulaması için kullanılır.
- Mağaza Gizli Anahtarı (Merchant Salt): İşlem güvenliğini ve veri şifrelemesini sağlayan kritik anahtardır.
Adım Adım Entegrasyon Süreci
Teknik kurulum aşamasında izlenmesi gereken temel adımlar şunlardır:
- API Yapılandırması: PayTR'dan aldığınız ID, Key ve Salt bilgilerinin sisteme hatasız girilmesi.
- Taksit ve Komisyon Yönetimi: Müşterilere sunulacak taksit seçeneklerinin ve komisyon oranlarının (maliyetin sepete yansıtılıp yansıtılmayacağı gibi) belirlenmesi.
- Bildirim (Callback) URL Ayarı: Ödemenin başarılı olup olmadığını sistemin otomatik anlaması için en kritik adımdır. Siparişlerin otomatik onaylanması bu URL'nin doğru tanımlanmasına bağlıdır.
- Test ve Canlı Mod: Entegrasyon tamamlandıktan sonra test ödemesi yapılması ve ardından "Canlı Mod"un aktif edilmesi.
Payfoni Panelinde PayTR Sanal POS Entegrasyonu Nasıl Yapılır?
PayTR Sanal POS altyapısını Payfoni sisteminizde aktif hale getirmek ve ödeme almaya başlamak için aşağıdaki adımları sırasıyla takip etmeniz yeterlidir.
1. Ödeme Servislerine Erişim
Entegrasyon sürecini başlatmak için Payfoni yönetim panelinizde servis listesine ulaşmalısınız.
- İşlem Yolu: Üye Firma Paneli > Uygulamalar
- Eylem: Bu sayfa üzerinden sisteminizde tanımlı olan tüm ödeme servislerini ve PayTR modülünü görüntüleyebilirsiniz.
2. PayTR Servis Yönetimi
Listelenen servisler arasından PayTR’ı bularak durum yönetimi yapabilirsiniz.
- İşlem Yolu: Uygulamalar > PayTR POS
- Detaylar: Bu ekranda servisi Aktif/Pasif konuma getirebilir, mağazanız için Varsayılan ödeme yöntemi olarak atayabilir veya yapılandırma için Ayarlar butonuna tıklayabilirsiniz.
3. API Yapılandırma Ayarları
PayTR firmasından temin ettiğiniz teknik bilgilerin Payfoni sistemine tanımlandığı kritik bölümdür.
- İşlem Yolu: PayTR POS > Ayarlar > Yapılandırma
- Girilecek Bilgiler: PayTR mağaza panelinizden aldığınız Merchant ID, Merchant Key ve Merchant Salt verilerini bu alanlara eksiksiz giriniz. Kurulum sonrası ödemelerin sorunsuz tetiklenmesi için bu bilgilerin doğruluğu şarttır.
3.1. PayTR Panelinden API Bilgileri Nasıl Alınır?
Payfoni kurulumunu tamamlamak ve güvenli ödeme almaya başlamak için PayTR Mağaza Paneli üzerinden hem test hem de canlı aktivasyon süreçlerini tamamlamanız gerekmektedir. İşte izlemeniz gereken adımlar:
İlk Hazırlık ve Mağaza Ayarları
- PayTR Mağaza Paneli adresine giriş yapın.
- Sol menüden Destek & Kurulum > Ayarlar sekmesine tıklayın.
- SİTE ADRESİNİZ kısmında, Payfoni tarafından size özel olarak tanımlanan subdomain adresinin (Örn: magazaadi.payfoni.com.tr) doğru şekilde yer aldığından emin olun.
- Mağaza Durum Kontrolü kısmının başlangıçta "Test Modu" olarak seçili olduğundan emin olun.
API Bilgilerini Kopyalama
Sol menüden Destek & Kurulum > Entegrasyon Bilgileri sekmesine tıklayın.
Sayfada yer alan şu 3 anahtarı kopyalayarak Payfoni panelindeki ilgili alanlara yapıştırın:
- Mağaza No (merchant_id)
- Mağaza Parola (merchant_key)
- Mağaza Gizli Anahtar (merchant_salt)
Bildirim URL (Callback URL) Ayarı
- Tekrar Destek & Kurulum > Ayarlar sekmesine gidin.
- Sayfanın en üstündeki "Bildirim URL (Callback URL)" alanına, Payfoni panelinin size verdiği özel dönüş adresini yapıştırın ve kaydedin.
Test Ödemesi ve Canlı Moda Geçiş
- Önce Test: Payfoni panelini "Test Modu"na alın. "Entegrasyon Bilgileri" sayfasındaki Test Kartı Bilgileri ile bir başarılı deneme ödemesi yapın.
- Sonra Canlı: Test başarılı olduktan sonra PayTR panelindeki Ayarlar sekmesine dönün. Mağaza Durum Kontrolü alanından seçimi "Canlı Mod" konumuna getirin ve "Değişiklikleri Kaydet" butonuna tıklayın.
Önemli Hatırlatma: Mağazanız canlıya geçtiğinde API bilgileriniz (Key ve Salt) güncellenebilir. Eğer ödeme hatası alırsanız, Entegrasyon Bilgileri sayfasındaki yeni canlı verileri Payfoni paneline tekrar kopyalayıp kaydetmeyi unutmayın.
4. Komisyon ve Taksit Yönetimi
Müşterilerinize sunacağınız taksit seçeneklerini ve maliyet dağılımını bu sekmeden kontrol edebilirsiniz.
- İşlem Yolu: PayTR POS > Ayarlar > Komisyon Yönetimi
- Detaylar: Hangi taksit seçeneklerinin (2, 3, 6, 9, 12) aktif olacağını belirleyebilir; komisyon maliyetinin müşteri tarafından mı karşılanacağını yoksa sizin tarafınızdan mı üstlenileceğini seçebilirsiniz.
5. Banka Oranları ve Özel Tanımlamalar
Çalıştığınız bankaların güncel oranlarını yönetmek ve özel kampanyalar tanımlamak için bu alanı kullanın.
- Canlı Oranlar: Dilerseniz PayTR üzerinden banka oranlarını sisteminize otomatik olarak çekebilirsiniz.
- Manuel Oran Ekleme: "Yeni Oran Ekle" butonu ile spesifik bir banka veya taksit türü için özel oran tanımlamaları yapabilirsiniz. Eklediğiniz her yeni orandan sonra ilgili satırı Aktif konuma getirmeyi unutmayın.
6. İşlemi Onaylama ve Kaydetme
Yapılan tüm ayarların geçerli olması için verilerin sisteme işlenmesi gerekir.
- Son Adım: Tüm yapılandırmayı 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, PayTR entegrasyonunun Payfoni üzerinde sorunsuz şekilde tamamlandığı anlamına gelir.
Entegrasyon için görsel içeren rehberi inceleyin
PayTR entegrasyonunu nasıl sağlıklı bir şekilde tamamlayacağınızı destek sayfamızdan görsellerle birlikte adım adım inceleyebilirsiniz:
