İçeriğe geç

Shopify PayTR Entegrasyonu Nasıl Yapılır?

Shopify PayTR entegrasyonu için iFrame kurulumu, API anahtarı yapılandırması, taksit tanımlama ve sık karşılaşılan sorunlar adım adım anlatılıyor.

Shopify PayTR Entegrasyonu Nasıl Yapılır?

Shopify PayTR Entegrasyonu Nedir? Shopify PayTR entegrasyonu, Türkiye merkezli PayTR sanal POS altyapısının Shopify App Store üzerinden mağazaya bağlanarak checkout sürecinde iFrame tabanlı kredi kartı tahsilatı almasını sağlayan kurulum işlemidir.

PayTR, Shopify ödeme entegrasyonu rehberinde karşılaştırılan dört büyük sanal POS sağlayıcısından biridir ve özellikle iFrame güvenlik modeliyle öne çıkar. Bu rehber PayTR’nin kurulum adımlarını, taksit yapılandırmasını ve sık karşılaşılan teknik sorunları ayrıntılı olarak ele alır.

PayTR’nin iFrame Yöntemi Nasıl Çalışır?

PayTR, kart bilgisinin Shopify checkout sayfasından hiç ayrılmadan PayTR’nin güvenli iFrame katmanında işlenmesini sağlar; bu yöntem PCI-DSS uyumluluk yükünün büyük kısmını sağlayıcıya devreder.

Checkout akışında müşteri kart bilgilerini girdiğinde, bu veri doğrudan PayTR sunucularına iletilir; Shopify veya mağaza sahibi kart numarasına hiçbir noktada erişim sağlamaz. Bu mimari, veri güvenliği açısından mağaza sahibinin sorumluluk alanını daraltır çünkü hassas kart verisi mağazanın kendi altyapısına hiç dokunmaz.

Quotable: PayTR’nin iFrame modelinde kart verisi Shopify sunucusuna hiç ulaşmaz; bu, PCI-DSS uyumluluk yükünün büyük kısmını sağlayıcıya taşıyan mimari bir karardır.

Peki bu teknik ayrım pratikte ne anlama geliyor? Mağaza sahibi, kart verisi sızıntısı riskiyle doğrudan muhatap olmaz çünkü bu veri hiçbir zaman kendi sunucusundan veya Shopify’ın checkout sayfasından geçmez.

Shopify’a PayTR Nasıl Kurulur?

PayTR kurulumu, Shopify App Store’dan PayTR uygulamasının yüklenip mağaza API anahtarlarının PayTR paneline tanımlanmasıyla tamamlanır; teknik geliştirme gerekmez.

  1. PayTR’de işletme hesabı açılır, gerekli evraklar (vergi levhası, imza sirküleri) yüklenir ve onay beklenir.
  2. Onay sonrası PayTR panelinden Mağaza Numarası, Mağaza Parolası ve Mağaza Gizli Anahtarı alınır.
  3. Shopify Admin → Settings → Payments bölümünden PayTR uygulaması aranıp yüklenir.
  4. Alınan üç bilgi (Mağaza No, Parola, Gizli Anahtar) ilgili alanlara girilir.
  5. Test kartıyla bir deneme işlemi yapılarak entegrasyonun canlı çalıştığı doğrulanır.
Adım Kim Yapar Ortalama Süre
İşletme hesabı başvurusu Mağaza sahibi 1 gün
PayTR onayı PayTR ekibi 1-3 iş günü
Shopify App kurulumu Mağaza sahibi / geliştirici 15-30 dakika
Test işlemi ve doğrulama Mağaza sahibi 10 dakika

İpucu: PayTR başvurusu sırasında istenen evraklar eksiksiz yüklenirse onay süresi genelde 1 iş gününe iner. Eksik evrak, onay sürecini bir haftaya kadar uzatabilen en sık gecikme nedenidir.

PayTR’de Taksit Seçenekleri Nasıl Tanımlanır?

Taksit seçenekleri PayTR panelinden banka bazlı olarak tanımlanır ve otomatik olarak Shopify checkout’una yansır; Shopify tarafında ayrı bir yapılandırma gerekmez.

PayTR panelindeki “Taksit Ayarları” bölümünden hangi bankaların kartlarına kaç taksit sunulacağı belirlenir. Kampanya dönemlerinde bankalar taksit sayısını değiştirdiğinde bu ayarların panelden güncellenmesi gerekir, aksi halde checkout eski taksit tablosunu göstermeye devam eder.

Kriter PayTR
Entegrasyon yöntemi iFrame
Taksit yönetimi Panel üzerinden banka bazlı
3D Secure Varsayılan olarak aktif
Şirket türü şartı Şahıs ve tüzel şirket kabul edilir

PayTR Entegrasyonunda En Sık Karşılaşılan Sorunlar Nelerdir?

En sık karşılaşılan sorun, test ortamı (sandbox) bilgileriyle canlı ortam bilgilerinin karıştırılmasıdır; bu durumda checkout “ödeme sağlayıcısına ulaşılamıyor” hatası verir.

İkinci yaygın sorun, PayTR panelinde tanımlı geri bildirim (callback) URL’sinin mağaza domain değişikliği sonrası güncellenmemesidir. Bu durumda ödeme PayTR tarafında başarıyla tamamlanır ama Shopify sipariş durumunu “ödeme bekleniyor” olarak göstermeye devam eder, çünkü PayTR’nin gönderdiği onay bildirimi eski URL’ye gider.

Uzak Durulması Gereken Risk: Domain değişikliği veya SSL yenilemesi sonrası PayTR panelindeki callback URL’sini güncellemeyi unutmak, ödemesi alınmış ama Shopify’da “beklemede” görünen siparişlerin birikmesine yol açar. Bu tür bir değişiklik sonrası mutlaka bir test siparişi verilmelidir.

PayTR ile iyzico Arasındaki Pratik Fark Nedir?

PayTR ve iyzico’nun her ikisi de hazır Shopify App’e sahiptir, ancak ödeme sayfası deneyimi ve entegrasyon mimarisi farklıdır: PayTR sabit iFrame kullanırken iyzico hem iFrame hem yönlendirmeli seçenek sunar.

Bu fark, checkout’ta müşterinin gördüğü görsel deneyimi doğrudan etkiler. iFrame tabanlı sağlayıcılarda müşteri Shopify sayfasından hiç ayrılmaz, bu da algılanan güveni artırabilir. Sağlayıcı seçimi yaparken bu görsel deneyim farkı, komisyon oranı kadar önemli bir karar kriteri olabilir.

Sık Sorulan Sorular

PayTR kurulumu ne kadar sürer? İşletme hesabı onayı dahil ortalama 2-4 iş günü sürer. Onay sonrası Shopify App kurulumu 30 dakikadan kısadır.

PayTR hangi şirket türlerini kabul eder? Hem şahıs şirketi hem tüzel şirket statüsünü kabul eder. İşlem hacmi arttıkça ek belge talep edilebilir.

PayTR’de taksit oranları nasıl değişir? Taksit oranları bankaların kendi kampanya politikasına göre değişir ve PayTR panelinden güncellenmesi gerekir. Panel güncellenmezse checkout eski oranları göstermeye devam eder.

PayTR ile iyzico aynı anda kullanılabilir mi? Evet, Shopify birden fazla ödeme sağlayıcısının aynı anda tanımlanmasına izin verir. Biri birincil diğeri yedek sağlayıcı olarak yapılandırılabilir.

PayTR entegrasyonu için geliştirici gerekir mi? Hayır, Shopify App Store üzerinden hazır uygulama kullanıldığında geliştirici desteği gerekmez. Özel checkout akışı isteyen kurumsal projelerde API tabanlı entegrasyon geliştirici gerektirebilir.

PayTR’de 3D Secure devre dışı bırakılabilir mi? Bazı işlem türlerinde bankanın onayıyla mümkün olabilir, ancak varsayılan ve önerilen yapılandırma 3D Secure’un aktif kalmasıdır. Devre dışı bırakmak dolandırıcılık riskini artırır.

Sonraki Adım

PayTR kurulumu tamamlandıktan sonra diğer sağlayıcılarla komisyon ve taksit karşılaştırması yapmak isteyenler sanal POS komisyon oranları karşılaştırması rehberine bakabilir.