PayTR Sanal POS

Kategori: Ödeme Versiyon: 1.0.0

PayTR, Türkiye'de yaygın kullanılan ödeme servisidir. iFrame entegrasyonu ile vitrinde kolay ödeme alabilirsiniz.


Desteklenen Özellikler

  • Kredi/banka kartı ile ödeme
  • 3D Secure
  • Taksitli ödeme
  • iFrame ödeme ekranı (vitrinde gömülü)
  • Test ve canlı ortam

1. Ön Hazırlık — PayTR Panelinden Bilgileri Alın

  1. www.paytr.com üzerinden mağaza panelinize giriş yapın.
  2. Bilgi → API Entegrasyon Bilgileri bölümüne gidin.
  3. Mağaza No (Merchant ID), Mağaza Parolası (Merchant Key) ve Mağaza Salt (Merchant Salt) değerlerini kopyalayın.
📸 PayTR API Entegrasyon Bilgileri sayfası

2. Eklentiyi Yapılandırın

  1. Sol menüden Eklenti Mağazası sayfasına gidin ve PayTR kartındaki Eklentiyi Yapılandır butonuna tıklayın. (Aynı sayfaya Ödeme Entegrasyonları listesinden de ulaşabilirsiniz.)
  2. Aşağıdaki alanları doldurun:
AlanAçıklama
Merchant IDPayTR mağaza numarası
Merchant KeyMağaza parolası
Merchant SaltMağaza salt değeri
Test moduCanlıya geçmeden önce açık
  1. Entegrasyonu aktif et anahtarını açın, ardından Ayarları kaydet ve Bağlantıyı test et.

ℹ️ Taksit sayısı eklenti içinde değil, Ayarlar → Ödeme sayfasındaki Max Taksit Sayısı alanından belirlenir.

📸 PayTR ayarları formu

3. Test Kartları

PayTR test ortamı için kullanılabilen sahte kartlar:

Kart NoSon KullanmaCVC
435508435508435812/30000
540667540667540312/30000

Bu kartlarla gerçek tahsilat yapılmaz; sadece akış testi içindir.


4. iFrame Görünüm Ayarları

PayTR panelinde Tema → iFrame Tema bölümünden ödeme ekranının renklerini mağazanızın markasıyla uyumlu hale getirebilirsiniz.

📸 PayTR iFrame tema seçici

Sık Karşılaşılan Sorunlar

"Mağaza onaylı değil": PayTR yeni hesaplar için onay süreci işletiyor. Canlı çalışmadan önce mağaza onayının tamamlandığından emin olun.

"İmza hatası": Merchant Salt yanlış girilmiş olabilir. Salt değeri özel karakterler içerebilir, kopyala-yapıştırırken boşluk kalmadığını kontrol edin.

Taksit görünmüyor: Ayarlar → Ödeme sayfasındaki Max Taksit Sayısı değerini kontrol edin. Taksitlerin müşteriye görünmesi için ayrıca PayTR tarafında taksit tanımlarınızın aktif olması gerekir.