Shopify Craftgate Nedir? Shopify Craftgate entegrasyonu, birden fazla ödeme sağlayıcısını tek bir API bağlantısıyla Shopify mağazanıza bağlayan ödeme orkestrasyon (payment orchestration) çözümüdür.
Craftgate, 2020 yılında Türkiye’de kurulan bir ödeme orkestrasyon platformudur. iyzico ve PayTR gibi ödeme sağlayıcıları yalnızca kendi altyapılarını sunarken Craftgate; iyzico, PayTR, Stripe, Garanti Pay, Akbank ve daha fazlasını tek bir entegrasyonla Shopify mağazanıza bağlar. Bu yapı özellikle birden fazla ödeme kanalı kullanmak isteyen veya ödeme başarı oranlarını optimize etmek isteyen mağazalar için güçlü bir çözümdür.
Craftgate Ödeme Orkestrasyon Modeli Nasıl Çalışır?
Geleneksel entegrasyonda her ödeme sağlayıcısı ayrı bir API bağlantısı gerektirir. Craftgate bu karmaşıklığı ortadan kaldırır.
Şu şekilde işler:
- Shopify, Craftgate API’sine ödeme talebini iletir.
- Craftgate yapılandırdığınız kurallar doğrultusunda ödemeyi en uygun sağlayıcıya yönlendirir.
- Ödeme başarısız olursa Craftgate otomatik olarak alternatif sağlayıcıya geçer (fallback).
- Tüm işlemler Craftgate’in merkezi paneliyle izlenir ve raporlanır.
Bu yapı tek sağlayıcıyla çalışmaya kıyasla ödeme başarı oranını artırır; bir sağlayıcıda kesinti yaşandığında mağaza çalışmaya devam eder.
Craftgate Kimler İçin Uygundur?
Craftgate her mağaza için optimal seçim değildir. Şu durumlarda güçlü bir tercih olur:
- Aylık ödeme işlem hacmi yüksek ve komisyon optimizasyonu kritik
- Birden fazla banka veya ödeme sağlayıcısıyla çalışmak isteniyor
- Ödeme kesintilerine karşı yedekli (redundant) altyapı gerekiyor
- Taksit kampanyalarını banka bazında optimize etmek gerekiyor
- Teknik ekip API entegrasyonunu yönetebilecek kapasitede
Aylık işlem hacmi düşük ve tek bir ödeme sağlayıcısı yeterli olan mağazalar için iyzico veya PayTR’nin doğrudan entegrasyonu daha basit ve uygun maliyetli olabilir.
Craftgate ile Doğrudan Ödeme Sağlayıcı Karşılaştırması
| Özellik | Craftgate (Orkestrasyon) | iyzico / PayTR (Doğrudan) |
| Entegrasyon Sayısı | Tek API, çoklu sağlayıcı | Her sağlayıcı ayrı entegrasyon |
| Fallback (Yedekleme) | Otomatik | Yok |
| Komisyon Optimizasyonu | Sağlayıcılar arası yönlendirme | Sabit sağlayıcı |
| Raporlama | Merkezi, çok sağlayıcılı | Sağlayıcı paneli |
| Kurulum Karmaşıklığı | Orta-Yüksek | Düşük-Orta |
| Ek Maliyet | Craftgate işlem ücreti + sağlayıcı komisyonu | Yalnızca sağlayıcı komisyonu |
| Uygun Kitle | Yüksek hacimli, çok sağlayıcılı | Küçük-orta hacimli |
Shopify Craftgate Kurulumu: Adım Adım
Craftgate’in Shopify entegrasyonu API tabanlıdır. Shopify App Store’da resmi bir uygulama yerine API bağlantısı tercih edilir.
Craftgate Hesabı Kurulumu:
Adım 1: craftgate.io adresinden merchant başvurusu yapın. Craftgate hesabı için şirket kaydı zorunludur.
Adım 2: Başvuru onaylandıktan sonra Craftgate Dashboard’a giriş yapın.
Adım 3: Ayarlar → API Anahtarları bölümünden şu bilgileri alın:
- API Key
- Secret Key
Adım 4: Craftgate Dashboard üzerinden bağlamak istediğiniz ödeme sağlayıcılarını (iyzico, PayTR, Garanti Pay vb.) ekleyin. Her sağlayıcı için o sağlayıcının API bilgilerini Craftgate’e girin. Craftgate bu noktada size aracı rolünü üstlenir.
Shopify Tarafında Kurulum:
Adım 5: Shopify Admin → Ayarlar → Ödemeler bölümüne gidin.
Adım 6: Üçüncü taraf sağlayıcılar listesinden Craftgate’i seçin (veya Craftgate’in Shopify uygulama linki üzerinden yükleme yapın).
Adım 7: Craftgate API Key ve Secret Key bilgilerini Shopify ödeme ayarlarına girin.
Adım 8: Shopify’ın ürettiği webhook URL’ini kopyalayın. Craftgate Dashboard → Bildirimler bölümüne bu URL’i yapıştırın.
Adım 9: Craftgate Dashboard’dan ödeme yönlendirme kurallarını yapılandırın:
- Hangi kartlar için hangi sağlayıcıya yönlendirme yapılacak
- Fallback sırası (birincil sağlayıcı başarısız olursa ikincil sağlayıcı devreye girer)
- Taksit seçenekleri sağlayıcı bazlı
Adım 10: Test ortamında birden fazla senaryo için ödeme testi yapın: başarılı ödeme, başarısız ödeme (fallback testi), iade işlemi.
Craftgate’in fallback özelliğini test etmeden canlıya geçmeyin. Birincil sağlayıcıyı kasıtlı olarak devre dışı bırakıp test ödemesi yaparak yedek sağlayıcının devreye girdiğini doğrulayın. Bu test, gerçek bir kesinti durumunda mağazanızın çalışmaya devam ettiğini garantiler.
Craftgate ile Taksit Optimizasyonu
Craftgate’in en güçlü özelliklerinden biri, farklı bankalar ve sağlayıcılar arasında taksit kampanyalarını merkezi olarak yönetmesidir.
Banka bazlı taksit yönlendirmesi şu şekilde çalışır:
- Müşteri belirli bir bankanın kartıyla ödeme yapmak ister.
- Craftgate o bankanın taksit kampanyasının en avantajlı olduğu sağlayıcıya yönlendirir.
- Müşteri daha fazla taksit veya daha düşük taksit farkıyla ödeme yapar.
- Mağaza sahibi ise komisyonu optimize etmiş olur.
Bu özellik özellikle yüksek ortalama sipariş değerli (3.000 TL üzeri) ürünler satan mağazalar için anlamlı bir maliyet avantajı sunar.
Craftgate Taksit Yönetimi ve Sağlayıcı Esnekliği
| Senaryo | Tek Sağlayıcıda | Craftgate ile |
| Garanti kartı 12 taksit | Yalnızca Garanti anlaşmalı sağlayıcı | En uygun Garanti anlaşmalı sağlayıcıya yönlendirme |
| Sağlayıcı kesintisi | Ödeme başarısız | Otomatik ikincil sağlayıcıya geçiş |
| Komisyon karşılaştırma | Manuel, zaman alıcı | Merkezi dashboard’dan anlık |
| Yeni sağlayıcı ekleme | Yeni teknik entegrasyon | Craftgate panelinden birkaç dakika |
Kurulum Sonrası İzleme
Craftgate entegrasyonunun kurulumdan sonra düzenli izlenmesi gerekir. Kritik metrikler:
- Ödeme başarı oranı: Craftgate Dashboard’dan sağlayıcı bazında başarı oranlarını karşılaştırın. Bir sağlayıcının başarı oranı sürekli düşüyorsa fallback önceliğini güncelleyin.
- Fallback tetiklenme sıklığı: Sık fallback tetiklenmesi birincil sağlayıcıda yapısal bir sorun olduğunu gösterir.
- Taksit kullanım dağılımı: Hangi taksit seçeneğinin en çok kullanıldığını izleyin; bu veri taksit kampanyası planlamanıza yol gösterir.
- İade süreci: İadelerin doğru sağlayıcıya yönlendirildiğini doğrulayın.
Craftgate’in API dokümantasyonu (docs.craftgate.io) ve test ortamı oldukça kapsamlıdır. Kurulum öncesinde Sandbox ortamında tüm senaryoları test etmek için en az bir hafta süre ayırın; bu süre üretim ortamında yaşanabilecek aksaklıkları minimize eder.
Sık Sorulan Sorular
Craftgate kullanmak için birden fazla ödeme sağlayıcısıyla anlaşma yapmam gerekiyor mu? Evet. Craftgate bir orkestrasyon katmanıdır; kendi ödeme lisansı yoktur. Bağlamak istediğiniz her sağlayıcıyla (iyzico, PayTR, Garanti Pay vb.) ayrı merchant anlaşması yapmanız gerekir. Craftgate bu anlaşmaları tek API altında birleştirir.
Craftgate’in Shopify’da ek işlem ücreti var mı? Evet. Craftgate her başarılı işlem için sağlayıcı komisyonuna ek olarak kendi işlem ücreti uygular. Bu ücret Craftgate’in sunduğu orkestrasyon değeriyle dengelenmelidir. Aylık hacim ve beklenen başarı oranı artışını hesaplayarak net maliyet-fayda analizi yapın.
Shopify’da Craftgate ile iyzico aynı anda çalışabilir mi? Hayır, Shopify’da aynı anda yalnızca bir birincil ödeme sağlayıcısı aktif olabilir. Craftgate kurulduğunda tüm ödemeler Craftgate üzerinden akar; Craftgate arkasında hem iyzico hem de diğer sağlayıcılar çalışır. Kullanıcı bu teknik ayrımı görmez.
Craftgate entegrasyonu için teknik ekip gerekiyor mu? API entegrasyonu temel düzeyde geliştirici bilgisi gerektirir. Craftgate’in kapsamlı dokümantasyonu ve Shopify uyumlu örnek kodları bu süreci kolaylaştırır. Teknik ekibiniz yoksa Craftgate ile entegrasyon deneyimi olan bir Shopify geliştiricisiyle çalışmanız önerilir.
Küçük mağazam var, Craftgate gerçekten gerekli mi? Muhtemelen değil. Craftgate’in değeri yüksek işlem hacminde, birden fazla sağlayıcıyla çalışma ihtiyacında ve ödeme başarı oranı optimizasyonunda ortaya çıkar. Aylık birkaç yüz sipariş alan küçük bir mağaza için iyzico veya PayTR’nin doğrudan entegrasyonu hem daha basit hem de daha ekonomiktir.
Craftgate Türkiye dışındaki sağlayıcıları da destekliyor mu? Evet. Craftgate Stripe ve bazı uluslararası ödeme sağlayıcılarını da destekler. Türkiye’den uluslararası satış yapan ve hem Türk hem de yabancı ödeme yöntemleri sunmak isteyen mağazalar için bu çok sağlayıcılı yapı değerlidir.
Sonraki Adım
Craftgate kurulumunu tamamladıktan sonra ödeme altyapınızın yanı sıra mağazanızın yasal çerçevesini gözden geçirin. ETBİS bildirimi, KVKK uyumu ve e-fatura entegrasyonu teknik altyapıyla birlikte kurulduğunda Türkiye’de sağlam bir e-ticaret temeli oluşturulmuş olur.