Shopify PayTR entegrasyonu, resmî PayTR Sanal POS uygulamasının doğru mağaza ve PayTR hesabıyla bağlanıp etkinleştirilmesini gerektirir. Kontrolü ödeme onayıyla sınırlamayın; Shopify siparişi, PayTR işlem referansı ve iade davranışı birlikte incelenmeli. Özellikle iadeyi hangi panelden yaptığınız operasyonu değiştirir.

Bu rehber Türkiye'deki Shopify mağazasına PayTR bağlayacak ekipler içindir. PayTR'nin Shopify'a özgü teknik belgesini temel alır. Sağlayıcının genel API veya pazarlama sayfası, Shopify uygulamasının bütün davranışlarını açıklamayabilir.

Önce hesabı ve ticari teklifi netleştirin

Mağazanızın alan adını, şirket bilgilerini ve ürün kategorisini PayTR başvurusuyla eşleştirin. Hesap onayı ve kullanılacak Shopify ürününün erişimi tamamlanmadan canlı kurulum tarihi belirlemeyin. Yabancı kart, taksit ve tahsilat ihtiyaçlarını başvuruda ayrı belirtin.

PayTR genel destek sayfası, komisyonun iş modeli ve işlem hacmi gibi bilgilerle özel olarak belirlendiğini açıklıyor. Bu nedenle her mağaza için geçerli tek bir PayTR Shopify oranı veremeyiz. Teklifte kart türü, taksit maliyeti, valör ve iade koşulları yer alsın. Sağlayıcı ücretini Shopify'ın kendi ücretleriyle karıştırmayın.

Resmî Shopify bağlantısı nasıl ilerler?

Belgede yer alan kurulum bağlantısından doğru Shopify mağazasını seçerek başlayın. Uygulamanın bağlantı ve yükleme akışını tamamladıktan sonra PayTR hesabıyla oturum açılır; Shopify'a dönüşte yöntem etkinleştirilir. Birden fazla mağaza veya hesap varsa bu iki seçimi özellikle kontrol edin.

PayTR belgesi oturum açma adımında süre sınırına dikkat çekiyor. Süre dolduğunda aynı ekranı tekrar tekrar göndermek yerine belgedeki ödeme ayarları üzerinden yönetim akışını yeniden başlatın. Başarı ekranından sonra Shopify ödeme ayarlarında doğru hesabın göründüğünü doğrulayın.

Bu akış için internetten bulunan eski API anahtarı kılavuzlarını doğrudan kullanmayın. Güncel resmî belge uygulama ve hesap bağlantısını esas alır. Hesap parolası veya anahtarları ekip sohbetine eklemeyin; yetkili kullanıcı üzerinden bağlayın.

Müşteri iletişim ayarları neden önemli?

Kontrol edilen PayTR Shopify belgesi müşteri iletişiminde e-posta ve ad/soyad alanlarının gerekliliğini belirtiyor. Bu ayarların güncel uygulamanızda nasıl istendiğini kurulum sırasında doğrulayın. Sadece telefonla devam edecek şekilde tasarlanmış bir checkout varsa veri paylaşımını ayrıca inceleyin.

Mağazanızdaki iletişim seçimiyle sağlayıcının işlem için aldığı veriyi karşılaştırın. Teknik belgede bazı alanların sabit veya sınırlı aktarılabildiğine dair bilgiler bulunuyor. Bu nedenle PayTR panelindeki müşteri veya sepet alanlarını, Shopify siparişinin eksiksiz kopyası olarak kabul etmeyin. Sipariş ayrıntısının asıl kaynağını ekip içinde belirleyin.

Müşteri hangi ödeme ekranını kullanır?

PayTR'nin Shopify belgesi ödemenin PayTR ortak sayfasında gerçekleştiğini anlatıyor. Mobilde mağazadan ödeme sayfasına geçişi, doğrulama sonrası dönüşü ve başarısız işlem mesajını kontrol edin. Dış sayfaya geçiş varsa fiyat, marka ve sipariş beklentisi kopmamalı.

Taksit, yabancı kart veya para birimi gibi özellikleri bu gerçek akış içinde değerlendirin. Genel ürün tanıtımında sunulan bir özelliğin Shopify bağlantısında da aynı şekilde çalıştığını varsaymayın. İhtiyaç duyduğunuz özelliğin adıyla destek teyidi alın ve uygun test senaryosu hazırlayın.

Shopify siparişi ile PayTR işlemi nasıl eşleştirilir?

Belge, Shopify siparişindeki ağ geçidi bilgisinden alınan işlem numarasıyla PayTR panelinde arama yapılmasını açıklar. Kendi kabul kaydınızda Shopify sipariş numarası, PayTR referansı, tutar, para birimi ve işlem zamanı birlikte bulunsun.

Bu eşleme özellikle müşteri ödeme yaptığını söylediğinde ama sipariş durumu beklediğiniz gibi olmadığında işe yarar. Aynı müşteriye hemen yeniden ödeme yaptırmak yerine önce mevcut işlemin sonucunu inceleyin. Siparişin onay mesajını, sağlayıcıdaki tahsilat ve bankaya aktarım kaydıyla aynı şey saymayın.

İade hangi panelden yapılmalı?

Kontrol edilen resmî belge, Shopify siparişi üzerinden iade akışını anlatırken PayTR panelinden yapılan iadelerin Shopify'daki ilgili siparişe şu an yansımadığını belirtiyor. Bu sınırı kurulum gününde yeniden doğrulayın. İade tutarı ve sipariş durumu iki panelde ayrı görünüyorsa ikinci kez ödeme iadesi başlatmayın; önce işlem referansıyla kontrol edin.

Tam ve kısmi iade için operasyon sorumlusu, kullanılacak panel ve beklenen kayıt ayrı yazılmalı. Para iadesi, sipariş iptali ve stok geri alma aynı işlem değildir. Ayrıntı için Shopify iade ve chargeback rehberine bakabilirsiniz.

Yayından önce kabul listesi

Sağlayıcının desteklediği test moduyla başlayın. Belgedeki test göstergelerini kontrol edin ve gerçek işlemle test işlemini karıştırmayın. Testlerde şu kayıtları tamamlayın:

  • Doğru Shopify mağazası ve PayTR hesabı bağlı.
  • Başarılı ve reddedilen ödeme, doğru sipariş durumunu oluşturuyor.
  • Mobil ödeme ve mağazaya dönüş kontrol edildi.
  • Referans, tutar ve para birimi iki panelde eşleştirildi.
  • İade akışı ve bildirim ayarı güncel resmî belgeye göre kontrol edildi.
  • Canlıya geçişte test ayarlarının son durumu kaydedildi.

Bildirim veya hata sorunu varsa sağlayıcının güncel belgesindeki adımlarla ilerleyin. Destek talebine hata kodu ve işlem zamanını ekleyin; kart bilgisi veya parola eklemeyin. Buradaki liste bir kabul yöntemidir, gerçekleştirilmiş mağaza testi değildir.

Karar için iyzico–PayTR karşılaştırmasına, tahsilat için valör rehberine, genel hazırlık için sanal POS kurulum rehberine geçebilirsiniz. Kaynaklar 15 Ekim 2026'da kontrol edildi.