Shopify Mağazanıza PayTR Sanal POS Entegrasyonu
Shopify, global pazarın lider e-ticaret altyapısı olsa da, Türkiye'den ödeme almak için yerel bir sanal POS'a (Ödeme Geçidi) ihtiyacınız vardır. Türkiye'de Shopify kullanıcılarının en çok tercih ettiği ödeme kuruluşlarından biri PayTR'dır.
Peki, Shopify mağazanıza PayTR entegrasyonunu nasıl yaparsınız? İşte adım adım rehber:
1. PayTR Mağaza Başvurusu ve Onay Süreci
Öncelikle PayTR web sitesine giderek "Sanal POS Başvurusu" yapmalısınız. Başvuru esnasında vergi levhanız, imza sirküleriniz ve kimlik fotokopiniz istenir. Önemli: Sitenizde Mesafeli Satış Sözleşmesi, Gizlilik Politikası ve İade Koşulları sayfalarının eksiksiz olması onay süreci için şarttır.
2. API Bilgilerinin Alınması
PayTR paneliniz onaylandıktan sonra sırasıyla:
- PayTR Mağaza Paneli'ne giriş yapın.
- Sol menüden "Bilgi" (veya Entegrasyon) sekmesine tıklayın.
- Karşınıza çıkan ekranda Mağaza No (Merchant ID), Mağaza Parolası (Merchant Key) ve Mağaza Gizli Anahtarı (Merchant Salt) bilgilerini göreceksiniz. Bu sekmeyi açık bırakın.
3. Shopify Panelinde Kurulum
- Shopify yönetici panelinize (Admin) giriş yapın.
- Sol alt köşeden Settings (Ayarlar) > Payments (Ödemeler) sekmesine tıklayın.
- "Supported Payment Methods" veya "Add Payment Methods" kısmında arama barına PayTR yazın.
- Çıkan PayTR uygulamasını seçin ve Install (Kur) butonuna basın. (Bu işlem sizi Shopify App Store'a yönlendirecek, oradan uygulamayı mağazanıza ekleyin).
- Uygulama yüklendikten sonra karşınıza çıkan konfigürasyon ekranına, PayTR panelinden aldığınız Merchant ID, Merchant Key ve Merchant Salt bilgilerini kopyalayıp yapıştırın.
- Alt kısımdan kabul etmek istediğiniz kart markalarını (Visa, MasterCard, Troy vb.) seçin.
- "Activate PayTR" butonuna basarak kurulumu tamamlayın.
4. Taksit Ayarlarının Yapılması
PayTR, müşterilerinize taksitli alışveriş imkanı sunar. Taksit komisyonlarının size mi (satıcı) yoksa müşteriye mi yansıtılacağını PayTR paneli üzerinden (Ayarlar > Mağaza Ayarları > Taksit Komisyonu) belirleyebilirsiniz.
5. Test İşlemi (Sandbox)
Kurulumu tamamladıktan sonra mağazanızdan ufak tutarlı (Örn: 1 TL) bir test siparişi vererek ödemenin başarılı bir şekilde geçip geçmediğini ve PayTR paneline düşüp düşmediğini mutlaka kontrol edin.
6. Kurulum Sonrası Yapılması Gereken Kontroller
Test ödemesi geçtikten sonra şu noktaları da doğrulayın:
- Sipariş durumu eşleşmesi: Ödeme tamamlandığında Shopify'daki sipariş "Paid" durumuna otomatik düşüyor mu? Düşmüyorsa bildirim (callback) adresi PayTR panelinde doğru tanımlı değildir.
- Taksit tablosu görünümü: Ödeme sayfasında taksit seçenekleri doğru kart markalarında görünüyor mu?
- Para birimi: Mağaza para biriminin TL olduğundan ve ödeme sayfasında aynı tutarın göründüğünden emin olun.
- Mobil ödeme akışı: Ödeme sayfasını telefondan baştan sona test edin; müşterilerinizin büyük bölümü mobilden ödeyecek.
- Sipariş onay e-postası: Ödeme sonrası müşteriye giden e-postada ödeme yöntemi doğru görünmeli.
Sık Karşılaşılan Hatalar ve Çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Ödeme sayfası açılmıyor | Merchant ID, Key veya Salt hatalı kopyalanmış | Bilgileri boşluk bırakmadan yeniden girin |
| Ödeme başarılı ama sipariş "Pending" kalıyor | Bildirim URL'si PayTR panelinde eksik veya yanlış | Uygulamanın verdiği bildirim adresini PayTR paneline kaydedin |
| Taksit seçenekleri görünmüyor | PayTR panelinde taksit kapalı veya kart markası seçilmemiş | Panelden taksit ayarlarını ve kart markalarını açın |
| Test modunda gerçek ödeme geçmiyor | Uygulama test modunda kalmış | Test modunu kapatıp canlı moda geçin |
| Müşteri 3D doğrulama sonrası siteye dönmüyor | Başarılı/başarısız dönüş adresleri eksik | Dönüş adreslerini uygulama ayarlarından kontrol edin |
Bu adımları aşamazsanız Shopify teknik destek ekibimiz entegrasyonu uzaktan kontrol edebilir.
7. Güvenlik ve Erişim Notları
- Merchant Key ve Merchant Salt bilgilerini e-posta veya mesajla paylaşmayın; yalnızca Shopify uygulama ayarlarında tutun.
- PayTR paneline erişimi olan kişi sayısını sınırlayın ve iki adımlı doğrulamayı açın.
- Mağazanıza kurduğunuz uygulamaların ödeme verisine erişim izinlerini düzenli gözden geçirin.
- Ters ibraz (chargeback) itirazlarında kargo teslim belgesi istenir; teslimat kayıtlarını saklayın.
8. İade ve İptal Süreci Nasıl İşler?
Shopify üzerinden iade (refund) başlattığınızda bu işlem PayTR'ye otomatik iletilebilir veya PayTR panelinden manuel iade yapmanız gerekebilir; uygulamanın güncel sürümünde hangi yöntemin desteklendiğini kontrol edin. İadenin müşteri kartına yansıma süresi bankaya göre değişir; müşteriye bu süreyi önceden bildirmek destek yükünü azaltır.
Sık Yapılan Hatalar
- Yasal sayfalar hazır olmadan PayTR başvurusu yapıp onay beklemek.
- API bilgilerini test ve canlı ortam için karıştırmak.
- Taksit komisyonunu müşteriye yansıtıp bunu ürün veya ödeme sayfasında belirtmemek.
- Tek sanal POS ile çalışıp kesinti anında satış kaybetmek; ikinci bir POS seçeneği için sanal POS firmaları karşılaştırmamıza bakın.
- Kurulumdan sonra ödeme akışını yalnızca masaüstünde test etmek.
Kontrol Listesi
- PayTR başvurusu onaylandı, API bilgileri alındı.
- Shopify'da uygulama kuruldu, bilgiler girildi, kart markaları seçildi.
- Taksit ve komisyon yansıtma ayarı yapıldı.
- Test siparişi başarılı; sipariş "Paid" durumuna düştü.
- Mobil ödeme akışı ve 3D doğrulama dönüşü test edildi.
- İade akışı denendi.
Sıkça Sorulan Sorular
PayTR ile Shopify Payments birlikte kullanılabilir mi?
Shopify Payments Türkiye'de kullanılamadığı için yerel ödeme için PayTR gibi bir ödeme kuruluşu gerekir. Güncel durumu Shopify'ın resmi sayfasından doğrulayın.
Shopify PayTR için ek işlem ücreti alır mı?
Shopify, üçüncü taraf ödeme sağlayıcıları için planınıza göre ek işlem ücreti uygulayabilir. Oranı Shopify plan sayfanızdan kontrol edin ve toplam maliyete ekleyin.
Kurulum ne kadar sürer?
PayTR onayı tamamlandıysa Shopify tarafındaki kurulum ve test genellikle bir saatten kısa sürer. Başvuru onay süresi belgelerin eksiksizliğine bağlıdır.
Birden fazla mağazam var; aynı PayTR hesabını kullanabilir miyim?
Her mağaza için ayrı mağaza tanımı gerekebilir; PayTR ile görüşerek çoklu mağaza yapısını netleştirin. Tüm kurulumu birlikte yapmak isterseniz Shopify mağaza kurulumu ve entegrasyon hizmetlerimize göz atabilirsiniz.
Dijipo olarak, Shopify mağaza kurulumlarında PayTR dahil tüm sanal POS entegrasyonlarını anahtar teslim olarak sağlıyor ve testlerini bizzat yapıyoruz.
Sonuç
Shopify'da PayTR kurulumu teknik olarak kısa bir işlemdir; asıl zaman alan kısım başvuru belgeleri ve kurulum sonrası testlerdir. Sipariş durumu eşleşmesini, mobil akışı ve iade sürecini test ettiğinizde ödeme altyapınız kampanya dönemlerine hazır demektir.