Shopify PayTR Kurulumu Nedir? Shopify PayTR kurulumu, Türkiye’nin köklü ödeme altyapılarından PayTR’yi Shopify mağazanıza bağlayarak kredi kartı, banka kartı ve taksitli ödeme almanızı sağlayan teknik entegrasyon sürecidir.
PayTR, 2009 yılında kurulan ve Türkiye’de 200.000’den fazla üye iş yerine hizmet veren BDDK lisanslı bir ödeme kuruluşudur (PayTR, 2025). Shopify’ın kendi ödeme altyapısı Shopify Payments Türkiye’de bulunmadığından, PayTR Türk e-ticaret mağazaları için yaygın tercihlerden biridir. Entegrasyon Merchant ID, Merchant Key ve Merchant Salt üçlüsüyle kurulur.
PayTR’nin Shopify ile Kullanım Avantajları
PayTR, Shopify entegrasyonu açısından iyzico ve Craftgate ile birlikte Türkiye’nin en sık tercih edilen ödeme sağlayıcıları arasındadır. Avantajları şunlardır:
- Tüm Türk bankaları ve kart markaları (Visa, Mastercard, Troy, Amex) desteklenir
- 2’den 12 aya kadar taksit
- Sanal POS ve iframe iframe ödeme formu seçenekleri
- Link ile ödeme özelliği (sosyal medya satışları için)
- Dolandırıcılık önleme sistemi (fraud detection)
- 7/24 teknik destek
PayTR’nin öne çıkan farkı: iFrame ödeme formu, müşteriyi başka bir sayfaya yönlendirmeden checkout içinde ödeme alır. Bu yöntem mobil deneyimde terk oranını düşürür.
Shopify PayTR Entegrasyonu İçin Gereksinimler
PayTR tarafında:
- PayTR’nin resmi sitesinden üye iş yeri başvurusu yapın.
- Başvuru onaylandıktan sonra PayTR üye paneline giriş yapın.
- Mağaza Ayarları bölümünden şu üç bilgiyi alın:
- Merchant ID (Mağaza ID)
- Merchant Key (Mağaza Anahtar)
- Merchant Salt (Mağaza Salt)
- Bildirim URL’ini (IPN/Webhook URL) daha sonra Shopify’dan alıp buraya ekleyeceksiniz.
Shopify tarafında:
- Shopify Basic veya üzeri plan
- Mağaza para birimi TRY olarak ayarlı
- Ödeme ayarlarına erişim
Shopify PayTR Kurulumu: Adım Adım
Adım 1: Shopify Admin’e giriş yapın. Sol menüden Uygulamalar bölümüne gidin.
Adım 2: Shopify App Store’da “PayTR” araması yapın. Resmi PayTR uygulamasını bulun ve Yükle butonuna tıklayın.
Adım 3: Uygulama izinlerini onaylayın.
Adım 4: PayTR uygulama ayarları ekranında şu bilgileri girin:
- Merchant ID
- Merchant Key
- Merchant Salt
Adım 5: Ödeme modu seçin:
- iframe Modu: Ödeme formu checkout sayfası içinde açılır (önerilir)
- Yönlendirme Modu: Müşteri PayTR sayfasına yönlendirilir
Adım 6: 3D Secure ayarını yapılandırın. Zorunlu seçeneğini işaretleyin.
Adım 7: Taksit seçeneklerini etkinleştirin ve maksimum taksit adedini belirleyin.
Adım 8: Shopify’ın oluşturduğu Webhook URL’ini kopyalayın ve PayTR üye panelindeki Bildirim URL alanına yapıştırın. Bu adım sipariş durumlarının senkronize edilmesi için zorunludur.
Adım 9: Test ödemesi yapın. PayTR test kart numarası: 4355 0843 5558 5858, son kullanma: herhangi gelecek tarih, CVC: 000.
Webhook URL’ini PayTR paneline eklemeden yapılan entegrasyonlarda başarılı ödemeler Shopify’da “Beklemede” olarak kalır. Sipariş durumu güncellemeleri çalışmıyorsa ilk kontrol etmeniz gereken yer bu alandır.
iframe ve Yönlendirme Modlarının Karşılaştırması
| Özellik | iframe Modu | Yönlendirme Modu |
| Müşteri Deneyimi | Sayfadan çıkmadan ödeme | PayTR sayfasına yönlendirilir |
| Mobil Uyum | Yüksek | Orta |
| Terk Oranı Riski | Düşük | Daha yüksek |
| Özelleştirme | Sınırlı | PayTR sayfası özelleştirilebilir |
| Teknik Gereksinim | Standart kurulum | Standart kurulum |
PayTR Taksit ve Komisyon Yapısı
PayTR taksit komisyonları banka ve kart tipine göre değişir. Sabit bir oran olmakla birlikte yüksek hacimli hesaplarda müzakere edilebilir özel oranlar sunulabilir.
Taksit komisyonunu mağazaya yansıtmak veya müşteriye aktarmak mümkündür. Türk tüketici hukuku kapsamında taksit farkını müşteriye yansıtmak yasal olarak mümkündür; ancak bu durumun checkout sayfasında açıkça belirtilmesi zorunludur.
Dikkat edilmesi gereken nokta: Taksit komisyonunu müşteriye yansıtıyorsanız Shopify’ın Türkiye özel bir taksit fiyatlandırma uygulaması ya da PayTR’nin kendi taksit fark hesaplama aracı kullanılabilir.
PayTR ile iyzico Temel Farklar
| Kriter | PayTR | iyzico |
| Kuruluş Yılı | 2009 | 2013 |
| Üye İş Yeri Sayısı | 200.000+ | 50.000+ |
| iframe Desteği | Var | Var |
| Link ile Ödeme | Var | Var |
| Mağaza Paneli Arayüzü | Kapsamlı raporlama | Gelişmiş analitik |
| Shopify Uygulama | App Store’da mevcut | App Store’da mevcut |
Yaygın Kurulum Hataları
Shopify PayTR entegrasyonunda en sık karşılaşılan sorunlar şunlardır:
- Merchant Salt yanlış girilmesi: Salt değeri büyük/küçük harfe duyarlıdır; kopyalarken boşluk bırakmayın.
- Webhook URL eksikliği: PayTR paneline bildirim URL’i eklenmezse siparişler asılı kalır.
- Para birimi uyumsuzluğu: Shopify mağazası TRY dışında bir para birimiyle ayarlıysa PayTR ödeme alamamaktadır.
- Test modunda canlıya geçmek: Test API bilgileriyle canlı işlem denenirse ödeme başarısız olur; canlı Merchant ID ve Key kullandığınızı doğrulayın.
Kurulum sonrasında PayTR üye panelindeki İşlem Geçmişi bölümünü açık tutun. İlk birkaç gerçek siparişte ödeme durumu ve Shopify sipariş durumu arasındaki senkronizasyonu buradan doğrulayabilirsiniz.
Sık Sorulan Sorular
Shopify PayTR entegrasyonu için hangi belgelere ihtiyacım var? PayTR üye iş yeri başvurusu için vergi levhası, imza sirküleri veya ticaret sicil belgesi ve banka hesap bilgileri gereklidir. Bireysel başvuru yapılamaz; şahıs şirketi veya tüzel kişilik şarttır.
Shopify’da PayTR ile iade işlemi nasıl yapılır? Shopify Admin panelinden sipariş detayına girin ve iade başlatın. Shopify, PayTR API’sine otomatik iade talebi gönderir. İade onayı PayTR panelinde görünür; tutarın müşterinin kartına yansıması 3-10 iş günü sürebilir.
PayTR taksit seçenekleri checkout sayfasında görünmüyor, neden? Taksit seçeneklerinin görünmesi için hem PayTR hesabınızda taksit tanımlanmış olmalı hem de uygulamada taksit aktif edilmelidir. Ayrıca bazı kart tipleri (sanal kart, banka kartı) taksit desteklemez; bu kartlarla ödeme yapıldığında taksit seçenekleri otomatik gizlenir.
Shopify PayTR entegrasyonunda komisyon oranı nedir? PayTR komisyon oranları herkese açık yayınlanmaz; hesap tipine ve aylık işlem hacmine göre değişir. Standart oranlara ek olarak yüksek hacimli hesaplar için özel oran müzakeresi yapılabilir. Güncel oran bilgisi için PayTR satış ekibiyle iletişime geçin.
PayTR mi yoksa iyzico mu daha iyi Shopify için? İkisi de güvenilir seçenekler; fark kullanım senaryosuna bağlıdır. PayTR daha köklü bir altyapıya ve geniş bir üye tabanına sahipken iyzico özellikle analitik araçları ve geliştirici dokümantasyonu açısından öne çıkar. İşlem hacminize göre her iki sağlayıcıdan teklif alıp komisyon oranlarını karşılaştırmanız önerilir.
Shopify’da iki farklı ödeme sağlayıcısı aynı anda kullanabilir miyim? Hayır. Shopify’da aynı anda yalnızca bir birincil ödeme sağlayıcısı aktif olabilir. Birden fazla ödeme yöntemi sunmak istiyorsanız Craftgate gibi ödeme orkestrasyon platformlarını değerlendirin; bu platformlar birden fazla sağlayıcıyı tek entegrasyon altında birleştirir.
Sonraki Adım
PayTR kurulumu tamamlandıktan sonra mağazanızın kargo ve faturalama altyapısını gözden geçirin. Türkiye’de e-ticaret işletmelerinin e-fatura veya e-arşiv belgesi düzenlemesi yasal zorunluluktur; ödeme altyapısıyla birlikte faturalama entegrasyonunu da kurmak süreci baştan doğru yapılandırmanın en verimli yoludur.