Shopify nedir?
Shopify, mağazanızı sıfırdan kurmadan satışa başlamanızı sağlayan, dünyada en yaygın kullanılan bulut tabanlı e-ticaret altyapılarından biridir. Hosting, güvenlik ve modern checkout deneyimi hazır gelir; Türkiye’de özellikle DTC (direct-to-consumer) markaları Shopify’ı tercih eder. Ancak global bir SaaS olduğu için Türkiye’ye özel ödeme, e-fatura ve kargo ihtiyaçları hazır gelmez — kurulum gerektirir. En kritik eksik ödeme tarafındadır: Shopify Payments Türkiye’de aktif değildir, yani yerel kartla ödeme almak için dışarıdan bir sanal POS bağlamanız şarttır.
PayTR nedir?
PayTR, BKM lisanslı, Türkiye’de yaygın kullanılan bir sanal POS (ödeme) altyapısıdır. Kredi kartı, banka kartı ve taksitli ödeme alma, 3D Secure doğrulaması ve düşük komisyon yapısıyla öne çıkar. Banka ile ayrı sözleşme yapma derdini ortadan kaldırır; tek bir PayTR hesabıyla farklı bankaların kartlarından tahsilat yaparsınız. Kart bilgileri PayTR’ın güvenli altyapısında işlenir, sizin sunucunuzda saklanmaz — bu da PCI yükünü üzerinizden alır.
Neden Shopify ve PayTR entegre edilmeli?
Shopify mağazanızda Türk müşterilerinizden kartla ödeme alabilmek için yerel bir sanal POS şart. PayTR bağlantısı kurulduğunda:
- Yerel kartla ödeme: Shopify Payments olmadan, Türk bankalarının kredi ve banka kartlarından tahsilat yaparsınız.
- Taksit desteği: Türkiye’de satışın önemli kısmı taksitli yürür; PayTR ile banka bazlı taksit seçenekleri sunarsınız.
- 3D Secure uyumu: Online kart ödemelerinde 3D Secure yasal zorunluluktur; akış PayTR tarafında otomatik işler.
- Düşük komisyon: PayTR komisyon yapısı, tek satıcılı mağazalarda maliyet avantajı sağlar.
- Otomatik sipariş akışı: Ödeme tamamlandığında sipariş Shopify’da otomatik oluşur, müşteri “ödedim ama sipariş düşmedi” sorunuyla karşılaşmaz.
Bağlantı doğru kurulmadığında en sık görülen sorun, ödeme bildiriminin Shopify’a düzgün ulaşmaması ve siparişin havada kalmasıdır — bu da doğrudan ciro kaybı demektir.
Shopify PayTR entegrasyonu nasıl yapılır?
Önce dürüst olalım: PayTR için iyzico kadar olgun, tek tıkla kurulan bir resmi Shopify app’i her zaman karşımıza çıkmıyor. Shopify’ın checkout’u da kapalı bir alan olduğu için entegrasyon, pazaryerindeki gibi “API’den sipariş çek” değil, kendi mağazanızın ödeme akışına PayTR’ı yerleştirmek şeklinde çalışır. Zeisoft olarak süreci şöyle yürütüyoruz:
- Mevcut yapıyı inceliyoruz: Shopify planınız (standart mı, Plus mı), temanız, sipariş hacminiz ve taksit ihtiyacınız belirleniyor. Plus’taki Checkout Extensibility, standart Shopify’a göre çok daha esnek seçenekler açar.
- Yöntemi seçiyoruz: Uygun bir üçüncü taraf köprü app yeterliyse onu kullanıyoruz; özel iş kuralları varsa PayTR Link/iFrame tabanlı off-site ödeme akışını custom kuruyoruz. Amaç: müşteri PayTR’ın güvenli sayfasında ödesin, dönüşte sipariş Shopify’da oluşsun.
- PayTR erişimini açıyoruz: Merchant ID, Merchant Key ve Merchant Salt alınır; ödeme sayfası ve taksit kuralları PayTR panelinde yapılandırılır.
- Callback’i kuruyoruz: PayTR’ın ödeme sonucu bildirimini doğrulayıp (imza kontrolü) Shopify Admin API üzerinden siparişi oluşturuyor veya “ödendi” olarak işaretliyoruz. Bu adım entegrasyonun en kritik parçası.
- Test ediyoruz: Tek çekim, taksit, 3D Secure, başarısız ödeme ve iade senaryolarını gerçek akışta doğruluyoruz; mobilde ayrıca kontrol ediyoruz.
- Bakım veriyoruz: Shopify tema/Checkout Extensibility geçişleri ve PayTR API değişikliklerini bakım anlaşmasıyla takip ediyoruz.
Lisanslar (Shopify aboneliği, PayTR hesabı, varsa köprü app) sizin tarafınızda; biz kurulum, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
Shopify-PayTR akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Sipariş havada kalması. Callback doğru kurulmadığında müşteri PayTR’da öder ama Shopify’da sipariş oluşmaz. Çözüm: ödeme bildirimini imza kontrolüyle doğrulayıp Admin API üzerinden siparişi güvenilir şekilde oluşturmak, geçici kesintiye karşı yedek mekanizma eklemek.
- Checkout müdahale sınırı. Standart Shopify’da checkout’a istenildiği gibi kod gömülemediği için ödeme adımı yanlış yere konumlanıyor. Çözüm: PayTR’ı off-site/checkout sonrası akış olarak konumlandırmak veya Plus’ta Checkout Extensibility kullanmak.
- Taksit ile fiyatın uyumsuzluğu. Shopify checkout taksiti bilmediğinden, PayTR panelindeki taksit kuralları mağaza fiyatlarıyla çelişebiliyor. Çözüm: banka bazlı taksit ve minimum sepet tutarını PayTR’da Shopify fiyat akışıyla tutarlı yapılandırmak.
- İade statülerinin ayrışması. Shopify’da iade alınıp PayTR tarafı güncellenmediğinde iki sistemin kaydı tutmuyor. Çözüm: iki yönlü iade/iptal eşleme kurallarını kurulumda tanımlamak, tam ve kısmi iadeyi ayrı ele almak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.