Blog içeriği
September 11, 2026

Shopify Sipay Entegrasyonu: Kurulum ve API Rehberi

Shopify Sipay entegrasyonu resmi bir Shopify uygulaması yerine API tabanlı kurulum gerektirir. Sanal POS, taksit ve komisyon yapısıyla adım adım rehber.

Shopify Sipay Entegrasyonu Nedir?

Shopify Sipay entegrasyonu, mağazanızı Sipay'in sanal POS altyapısına bağlayarak 9 kart ailesini (Advantage, Axess, Bonus, World, CardFinans, Maximum, Paraf, SağlamKart, Ziraat Bankkart Combo) tek bir ödeme kuruluşu üzerinden kabul etmenizi sağlayan bir kurulumdur. Sipay'in kendi tanımına göre üye iş yerleri, ayrı ayrı banka anlaşması yapmadan bu kart ailelerinin kredi ve banka kartlarıyla ödeme alabiliyor.

Sipay'in Shopify'daki konumu, iyzico veya PayTR'den farklı işliyor. Apps.shopify.com/partners/sipay sayfasının gösterdiği gibi Sipay'in Shopify App Store'da yayınlanmış resmi bir uygulaması bulunmuyor; entegrasyon, Sipay Business API dokümantasyonu (apidocs.sipay.com.tr) üzerinden API anahtarlarının girilmesiyle veya bir geliştirici/ajans aracılığıyla kurulan özel bağlantıyla yapılıyor.

Sipay, sanal POS'un yanında fiziksel POS, açık bankacılık, EFT/havale ve dijital cüzdan ürünlerini tek çatı altında sunuyor. Shopify mağazaları için asıl kullanılan katman sanal POS ve taksit altyapısı; taksitli satışlarda faaliyet alanına göre 18 aya kadar taksit imkanı tanınıyor.

Kritik Not: Sipay'in Shopify App Store'da resmi bir uygulaması olmaması, kurulumu iyzico veya PayTR'ye göre daha fazla teknik adım gerektirdiği anlamına geliyor. Mağaza sahibi kendi başına API entegrasyonu yapamıyorsa, bir geliştirici veya ajans desteği almadan bu kurulumu tamamlamak zor.

Tek çekim işlemlerde bile komisyon oranının bankaya göre değişmesi, Sipay'i seçen mağazaların işlem hacmine göre pazarlık yapabildiği bir model haline getiriyor. Sipay verilerine göre komisyon oranı %1 ile %11 arasında değişiyor ve aylık işlem hacmi arttıkça bu oran düşüyor.

Sipay Shopify'a Nasıl Bağlanır? (Resmi Uygulama mı, API Entegrasyonu mu?)

Sipay'i Shopify'a bağlamanın tek yolu Sipay Business API'yi kullanarak özel bir entegrasyon kurmaktır; App Store'dan tek tıkla yüklenebilecek bir Sipay uygulaması bulunmuyor.

Sipay Business API ile Bağlantı

Sipay Business API, RESTful servisler üzerinden çalışıyor ve para transferi, hesap yönetimi ile işlem takibini tek API üzerinden yönetiyor. Shopify tarafında bu API'yi kullanmak için ya Shopify'ın özel ödeme entegrasyonu (custom payment gateway) altyapısını kullanan bir uygulama geliştirmeniz, ya da Sipay'in sanal POS API dokümanını (apidocs.sipay.com.tr) temel alan bir üçüncü parti çözüm kullanmanız gerekiyor.

Bu noktada iki yol var: doğrudan kendi geliştiricinizle API entegrasyonu kurmak, veya Qukasoft ve posentegrator.com gibi Sipay sanal POS entegrasyonu sunan ajanslardan hazır bir bağlantı satın almak. İkinci yol daha hızlı kuruluyor, ama entegrasyonun bakımı ve güncellemeleri o ajansa bağımlı kalıyor.

Neden Shopify App Store'da Resmi Bir Sipay Uygulaması Yok?

Sipay, Shopify entegrasyonunu App Store üzerinden değil doğrudan API dokümantasyonu ve iş ortaklıkları üzerinden yürütmeyi tercih ediyor. Bu model, iyzico ve PayTR'nin izlediği "önce Shopify uygulaması, sonra API" yaklaşımından farklı; Sipay öncelikle Business API'sini geliştirici ekosistemine açık tutuyor.

Uzak Durulması Gereken Risk: "Sipay Shopify uygulaması" aramasıyla App Store'da resmi bir sonuç bulmayı beklemeyin. Bu aramanın sonucunda çıkan bazı üçüncü parti "entegrasyon" sayfaları, gerçek bir Sipay iş ortaklığı olmadan sadece API anahtarı yönlendirmesi yapan basit çözümler olabilir; kurulum öncesi ajansın Sipay ile resmi bir teknik iş birliği belgesi olup olmadığını sorun.

Bir önceki bölümde değindiğimiz komisyon esnekliği, bu API tabanlı modelin doğrudan sonucu: Sipay, tek tip bir App Store paketi sunmak yerine her mağazanın işlem hacmine göre özel şartlar sunabiliyor.

Shopify Sipay Entegrasyonu: Adım Adım Kurulum Süreci

Kurulum, Sipay üye iş yeri hesabı açmanızla başlar ve API bağlantısını Shopify checkout'unda test etmenizle biter; aradaki adımlar API anahtarlarının alınmasını ve entegrasyon yönteminin seçilmesini kapsar.

Adım 1: Sipay Üye İş Yeri Hesabı Açın

Sipay.com.tr üzerinden üye iş yeri başvurusu yapın. Sipay'in kendi tanımına göre bu süreçte sözleşme zorunluluğu yok; başvuru onaylandıktan sonra Sipay panelinden API kullanıcı adı, şifre ve merchant key bilgilerinizi alıyorsunuz.

Adım 2: Entegrasyon Yöntemini Seçin

Kendi geliştirme ekibinizle Sipay Business API dokümantasyonunu (apidocs.sipay.com.tr) temel alan özel bir entegrasyon mu kuracağınıza, yoksa Qukasoft veya posentegrator.com gibi hazır Sipay entegrasyon hizmeti sunan bir ajanstan mı destek alacağınıza burada karar verirsiniz. Teknik ekibiniz yoksa ikinci yol kurulum süresini kısaltıyor.

Adım 3: API Anahtarlarını Shopify Ödeme Ayarlarına Tanımlayın

Seçtiğiniz entegrasyon yöntemine göre API anahtarlarınızı ya Shopify'ın özel ödeme entegrasyonu (custom payment gateway) alanına, ya da ajansın sağladığı uygulama ayarlarına giriyorsunuz. Bu adımda merchant key ve API şifresinin doğru mağaza hesabıyla eşleştiğini teyit etmek gerekiyor; yanlış eşleşme, ödeme onaylansa bile siparişin Shopify'a düşmemesine yol açıyor.

Adım 4: Taksit ve Kart Ailesi Ayarlarını Yapılandırın

Hangi kart ailelerinin (Advantage, Axess, Bonus, World, CardFinans, Maximum, Paraf, SağlamKart, Ziraat Bankkart Combo) ve kaç aya kadar taksitin aktif olacağını Sipay panelinden belirliyorsunuz. Faaliyet alanınıza göre taksit üst sınırı 18 aya kadar çıkabiliyor; bu sınırı ürün kategorinize göre ayarlamak, yüksek tutarlı ürünlerde dönüşümü doğrudan etkiliyor.

Adım 5: Test İşlemi Yapın

Canlıya almadan önce düşük tutarlı bir test siparişiyle hem tek çekim hem taksitli ödemeyi deneyin. Ödeme sonucunun Shopify sipariş ekranına doğru yansıdığını ve ödeme onayının hesabınıza belirlediğiniz süre içinde (ertesi gün veya 7 gün sonra) düştüğünü doğrulayın.

Adım 6: Canlıya Alın

Test işlemleri sorunsuz tamamlandıktan sonra entegrasyonu canlı moda geçirin. İlk gerçek siparişleri yakından takip edip komisyon kesintisinin panelde beklediğiniz oranla eşleştiğini kontrol edin.

Sipay'in Öne Çıkan Özellikleri ve Komisyon Yapısı

Sipay'i tekli banka anlaşmasından ayıran temel fark, 9 kart ailesini tek entegrasyonla kabul edip komisyon oranını işlem hacmine göre esnetebilmesidir.

Özellik Detay
Desteklenen Kart Aileleri Advantage, Axess, Bonus, World, CardFinans, Maximum, Paraf, SağlamKart, Ziraat Bankkart Combo
Taksit Süresi Faaliyet alanına göre 18 aya kadar
Komisyon Oranı %1 - %11 arası, işlem hacmine göre değişken
Ödeme Aktarım Süresi Ertesi gün veya 7 gün sonra (Üye iş yeri tercihine göre)
Aidat / Sözleşme Yıllık/aylık aidat yok, sözleşme zorunluluğu yok
Ek Ürünler Fiziksel POS, açık bankacılık, dijital cüzdan, EFT/havale

Sipay verilerine göre işlem hacmi arttıkça üye iş yerleri daha düşük komisyon oranına geçebiliyor; bu, sabit oranlı sağlayıcılardan farklı olarak büyüyen mağazalar için doğrudan maliyet avantajı sağlıyor.

İpucu: Sözleşme zorunluluğu olmaması, düşük hacimli veya mevsimsel satış yapan mağazalar için deneme amaçlı entegrasyonu ucuzlatıyor. Ancak komisyon oranının hacme göre değişmesi, düşük hacimli bir mağazanın üst banttaki %11 oranına yakın kesinti ödeyebileceği anlamına geliyor; entegrasyon öncesi kendi işlem hacminize karşılık gelen oranı Sipay'den yazılı teyit alın.

Nodus Works olarak API tabanlı ödeme entegrasyonlarında gördüğümüz ortak risk, entegrasyonu kuran ajansın sonradan destek vermeyi bırakmasıdır. Sipay'in resmi bir Shopify uygulaması olmadığı için bu risk PayTR veya iyzico'ya göre daha yüksek; entegrasyonu kim kurarsa kursun, API anahtarlarının ve dokümantasyonun mağaza sahibinde de yedekli tutulması gerekiyor.

Sipay ile iyzico/PayTR/Craftgate Karşılaştırması

Sipay'i diğer üç sağlayıcıdan ayıran temel eksen, resmi bir Shopify uygulamasının olmaması ve komisyon oranının sabit değil hacme bağlı belirlenmesidir.

Kriter Sipay iyzico PayTR Craftgate
Shopify App Store Uygulaması Yok, API tabanlı özel entegrasyon Var, yaygın kullanım Var, yaygın kullanım Var (0 yorum)
Kurulum Yöntemi Business API + geliştirici / ajans desteği Tek tık uygulama kurulumu Tek tık uygulama kurulumu Uygulama + banka tanımlama adımları
Komisyon Modeli %1 - %11, işlem hacmine göre değişken Sabit oran, hesap türüne göre Sabit oran, hesap türüne göre Bağlı bankaların kendi oranları
Taksit Üst Sınırı 18 aya kadar (Faaliyet alanına göre) Banka ve kart programına göre değişir Banka ve kart programına göre değişir Bağlı banka anlaşmasına göre değişir
En Uygun Mağaza Profili Yüksek hacimli, komisyon pazarlığı yapmak isteyen mağazalar Hızlı kurulum isteyen küçük-orta ölçekli mağazalar Hızlı kurulum isteyen küçük-orta ölçekli mağazalar Birden fazla banka anlaşması olan mağazalar

Yönettiğimiz projelerdeki gözlemimize göre, teknik ekibi olmayan ve hızlı kurulum isteyen bir mağaza için Sipay'in API tabanlı modeli iyzico veya PayTR'nin tek tık kurulumuna kıyasla gereksiz bir engel oluşturuyor. Sipay'in asıl avantajı, aylık işlem hacmi arttıkça komisyon oranını aşağı çekebilen ve bu esnekliği önemseyen orta-büyük ölçekli mağazalarda ortaya çıkıyor.

Yaygın Hatalar ve Dikkat Edilmesi Gerekenler

Sipay entegrasyonunda en sık karşılaşılan sorun, "Shopify Sipay uygulaması" aranarak App Store'da resmi bir sonuç beklenmesi; böyle bir uygulama yok, bu yüzden kurulum planı en baştan API tabanlı olarak yapılmalı.

Kritik Not: Bazı üçüncü parti ajans sayfaları "Sipay Shopify entegrasyonu tek tıkla" gibi ifadeler kullanıyor. Bu ifadeler, ajansın kendi geliştirdiği aracı bir uygulamayı tanımlıyor olabilir; Sipay'in resmi Business API'siyle doğrudan bağlantı kurulup kurulmadığını, entegrasyonu satın almadan önce ajanstan yazılı olarak teyit edin.

İkinci yaygın hata, komisyon oranının başvuru sırasında sözlü olarak verilen tek bir rakamla sabitlenmiş sanılmasıdır. Sipay'in komisyon yapısı işlem hacmine göre değiştiği için, ilk ay düşük hacimle başlayan bir mağaza üst banttaki orana yakın bir kesinti görebiliyor; bu durum "gizli komisyon artışı" gibi algılansa da aslında hacme bağlı önceden tanımlanmış bir mekanizma.

İpucu: Entegrasyonu bir ajans üzerinden kurduysanız, API anahtarlarınızın ve merchant key bilgilerinizin bir kopyasını kendi kayıtlarınızda tutun. Ajansla ilişkiniz sona erdiğinde bu bilgiler olmadan entegrasyonu başka bir geliştiriciye devretmek zorlaşıyor.

Üçüncü nokta, taksit üst sınırının faaliyet alanına göre değiştiğinin gözden kaçırılmasıdır. 18 aya kadar taksit imkanı her ürün kategorisi için otomatik tanımlı değil; hangi kategorinin hangi taksit sınırına sahip olduğunu Sipay panelinden kontrol etmeden checkout'a yansıtmak, müşteriye görünen taksit seçeneğiyle gerçekte onaylanan taksit sayısının uyuşmamasına yol açabiliyor.

SSS: Shopify Sipay Entegrasyonu

Shopify'da Sipay nasıl kurulur? Sipay'in Shopify App Store'da resmi bir uygulaması yok; kurulum, Sipay Business API dokümantasyonu üzerinden özel entegrasyon kurularak veya bu entegrasyonu sunan bir ajans aracılığıyla yapılıyor. API anahtarlarınızı aldıktan sonra Shopify'ın özel ödeme entegrasyonu alanına veya ajansın uygulamasına tanımlıyorsunuz.

Sipay'in Shopify uygulaması var mı? Hayır, apps.shopify.com/partners/sipay sayfası Sipay'in App Store'da yayınlanmış bir uygulaması olmadığını gösteriyor. Entegrasyon, API tabanlı özel bir bağlantı veya üçüncü parti ajans çözümü üzerinden kuruluyor.

Sipay'in komisyon oranı ne kadar? Sipay verilerine göre komisyon oranı %1 ile %11 arasında değişiyor ve işlem hacmi arttıkça oran düşüyor. Kesin oranı, kendi işlem hacminize göre Sipay'den yazılı olarak almanız gerekiyor.

Sipay ile kaç aya kadar taksit yapılabilir? Faaliyet alanınıza göre 18 aya kadar taksit imkanı sunuluyor. Taksit üst sınırı ürün kategorisine göre değişebildiği için hangi kategorinin hangi sınıra sahip olduğunu panelden kontrol etmeniz gerekiyor.

Sipay mi PayTR mi tercih edilmeli? Hızlı ve tek tık kurulum isteyen küçük-orta ölçekli mağazalar için PayTR'nin resmi Shopify uygulaması daha az teknik yük getiriyor. İşlem hacmi yüksek ve komisyon oranını hacme göre esnetmek isteyen mağazalar için Sipay'in API tabanlı modeli daha uygun.

Sonuç

Sipay, Shopify tarafında resmi bir uygulama sunmadığı için iyzico, PayTR veya Craftgate'e kıyasla daha fazla teknik hazırlık gerektiriyor. Karşılığında sunduğu esnek komisyon yapısı ve 18 aya kadar taksit imkanı, işlem hacmi yüksek mağazalar için bu ek kurulum yükünü karşılayabiliyor.

Entegrasyon yöntemine karar vermeden önce kendi teknik ekibinizin API tabanlı bir kurulumu üstlenip üstlenemeyeceğini netleştirin; üstlenemiyorsa ajans desteği almak kaçınılmaz hale geliyor. Shopify'da ödeme entegrasyonunu kargo ve ERP bağlantılarıyla birlikte uçtan uca kurmak isteyen mağazalar için Shopify entegrasyon hizmetimiz API tabanlı ödeme sağlayıcılarının bakımını da kapsıyor. Türkiye'de Shopify'a bağlanan diğer ödeme sağlayıcılarını (Craftgate, Paratika, Lidio) Shopify sanal POS kurulumu rehberimizde karşılaştırmalı olarak inceledik.