Yönettiğimiz Shopify projelerinde birden fazla banka anlaşması olan mağazalarda tekrar eden bir sorunla karşılaştık: tek bankaya bağlı bir sanal POS, o banka geçici olarak ödeme reddettiğinde satışı tamamen durduruyor. Craftgate, bu riski dağıtmak için kurulmuş bir Shopify ödeme entegrasyonu. Banka sanal POS'larını ve alternatif ödeme yöntemlerini tek panelde birleştiren bir ödeme altyapısı sağlayıcısı olarak çalışıyor; iyzico veya PayTR gibi tek bir ödeme kuruluşuna bağlı kalmak yerine, mağazanızın anlaştığı birden fazla bankayı aynı entegrasyon üzerinden yönetmenize izin veriyor.
Shopify Craftgate Entegrasyonu Nedir?
Craftgate entegrasyonu, Shopify mağazanızı birden fazla banka sanal POS'una ve alternatif ödeme yöntemine tek bir API bağlantısıyla bağlayan bir ödeme yönlendirme katmanıdır. Craftgate'in kendi tanımına göre platform, ödeme kuruluşları ve bankalarla ayrı ayrı entegrasyon yapmak yerine tek bir altyapı üzerinden çoklu sağlayıcı yönetimi sunuyor.
Fintechistanbul.org'un 2022 tarihli duyurusuna göre Craftgate ile Shopify arasındaki iş birliği o yıl resmileşti ve Craftgate Payment Gateway uygulaması Shopify App Store'a eklendi. Uygulama, Craftgate'in kendi geliştirici dokümantasyonunda tanımlandığı şekliyle iki farklı ödeme deneyimi sunuyor: Ortak Ödeme Sayfası (Common Payment Page/CPP), yani müşterinin Craftgate'in barındırdığı bir ekrana yönlendirildiği model, ve site içi (on-site) ödeme, yani müşterinin Shopify checkout'undan hiç ayrılmadan kart bilgisini girdiği model.
Craftgate'in Shopify entegrasyonunu diğer tekli ödeme sağlayıcılarından ayıran üç teknik özellik var:
- Gerçek zamanlı senkronizasyon: Ödeme sonucu, işlem tamamlanır tamamlanmaz Shopify sipariş ekranına yansıyor; ayrı bir webhook yapılandırması veya manuel senkronizasyon adımı gerekmiyor.
- Ödeme Tekrar Deneme ve Otomatik Pilot (Payment Retry & Autopilot): Bir işlem reddedildiğinde sistem, önceden tanımlanmış kurallara göre işlemi otomatik olarak başka bir bankaya yönlendirip yeniden deniyor.
- Akıllı ve Dinamik Ödeme Yönlendirme (Smart/Dynamic Payment Routing): Craftgate, hangi işlemin hangi banka sanal POS'una gideceğini işlem tutarı, kart türü veya başarı oranı gibi kriterlere göre otomatik belirliyor.
Kritik Not: Craftgate Payment Gateway uygulamasının Shopify App Store listesinde, 2022'deki yayın tarihinden bu yana 0 yorum bulunuyor. Bu, uygulamanın işlevsiz olduğu anlamına gelmiyor; Craftgate'in Shopify entegrasyonunu doğrudan kendi geliştirici dokümantasyonu üzerinden destekleyip App Store yorumlarını önceliklendirmediğini gösteriyor. Kuruluma başlamadan önce Craftgate'in kendi destek kanalından güncel entegrasyon adımlarını teyit edin.
Çoklu banka yönetimi gerektirmeyen, tek bir sanal POS'la çalışan küçük ölçekli bir mağaza için bu katman gereğinden karmaşık kalabilir; Craftgate'in asıl değeri birden fazla banka anlaşması olan mağazalarda ortaya çıkıyor.
Craftgate Hesabı Açmak: Başvuru ve Sandbox Testi
Craftgate hesabı açmak için craftgate.io üzerinden başvuru formunu doldurup şirket bilgilerinizi ve banka anlaşma detaylarınızı iletmeniz gerekiyor; onay sonrası API anahtarlarınız canlı panelden veriliyor.
Canlı Ortam Başvurusu
Craftgate'in resmi web sitesi üzerinden yapılan başvuru, klasik bir sanal POS başvurusundan farklı olarak tek bir bankayla değil, mağazanızın anlaştığı tüm bankalarla ilgili bilgileri topluyor. Başvuru onaylandıktan sonra Craftgate panelinden bir API Key ve Secret Key çifti alıyorsunuz; bu anahtarlar Shopify tarafındaki uygulama kurulumunda kullanılacak.
Başvuru sürecinde netleştirilmesi gereken nokta, hangi bankaların hangi sırayla tanımlanacağı. Birden fazla banka anlaşmanız varsa, bunları tek seferde mi yoksa aşamalı mı ekleyeceğinizi Craftgate'in satış ekibiyle önceden görüşmek, kurulum sırasında karışıklığı önlüyor.
Sandbox (Test) Ortamı
Craftgate, canlı panelden tamamen ayrı bir sandbox-panel.craftgate.io adresi üzerinden test ortamı sunuyor. Sandbox hesabı, canlı hesaptan bağımsız bir kayıtla açılıyor; yani canlı API anahtarlarınızla sandbox'ta işlem yapamazsınız, ayrı bir test kaydı oluşturmanız gerekiyor.
Sandbox ortamında gerçek para hareketi olmadan tam bir ödeme akışını (kart girişi, 3D Secure doğrulama, ödeme sonucu) test edebiliyorsunuz. Craftgate dokümantasyonuna göre sandbox ortamı, canlı ortamdaki tüm özellikleri (Ödeme Tekrar Deneme, Akıllı Yönlendirme dahil) simüle ediyor; bu yüzden canlıya geçmeden önce yalnızca tek bir test kartıyla değil, en az iki farklı senaryoyla (başarılı işlem, reddedilen işlem) test yapmak, canlı ortamda karşılaşılacak sürprizleri önceden ortaya çıkarıyor.
Shopify Craftgate Entegrasyonu: Adım Adım Kurulum
Kurulum, Craftgate hesabınızı açmanızla başlar ve Shopify App Store üzerinden yüklediğiniz uygulamayı canlı ortamda test etmenizle biter; aradaki adımlar bağlı bankaları tanımlamayı ve ödeme deneyimini seçmeyi kapsar.
Adım 1: Craftgate Hesabı Açın ve API Anahtarlarını Alın
Bir önceki bölümde anlattığımız başvuru sürecini tamamlayıp API anahtarlarınızı Craftgate panelinden alın. Bu anahtarlar olmadan Shopify tarafındaki uygulama hesabınızla eşleşmez.
Adım 2: Shopify App Store'dan Craftgate Payment Gateway'i Yükleyin
Shopify Admin panelinizden Uygulamalar bölümüne gidip Craftgate Payment Gateway'i arayın ve mağazanıza yükleyin. Uygulama ücretsiz; kurulum sırasında mağaza bilgilerinize erişim izni istiyor.
Adım 3: Bağlı Bankaları ve Sanal POS'ları Tanımlayın
Uygulama içinden Craftgate hesabınızı API anahtarlarıyla bağladıktan sonra, hangi banka sanal POS'larının ve ödeme kuruluşlarının aktif olacağını Craftgate panelinden tanımlarsınız. Doğrudan Shopify entegrasyonu olmayan bir bankayla anlaşmanız varsa, o sanal POS'u da bu adımda sisteme dahil edebiliyorsunuz.
Adım 4: Ödeme Deneyimini Seçin (Ortak Ödeme Sayfası veya Site İçi)
Müşterinizin Craftgate'in barındırdığı ekrana mı yönlendirileceğine, yoksa Shopify mağazanızdan hiç ayrılmadan mı ödeme yapacağına burada karar verirsiniz. Site içi seçenek Multinet ve Edenred Hediye Kartı gibi alternatif yöntemleri de kapsıyor.
Adım 5: Sandbox'ta Test İşlemi Yapın
Canlıya almadan önce sandbox hesabınızla gerçek para hareketi olmadan bir test siparişi tamamlayın. Ödeme sonucunun Shopify sipariş ekranına doğru şekilde ve gerçek zamanlı yansıdığını doğrulayın; bu adım atlanırsa "ödendi ama sipariş görünmüyor" senaryosu canlı ortamda fark edilir.
Adım 6: Canlıya Alın
Test işlemi sorunsuz tamamlandıktan sonra Craftgate panelinden canlı moda geçin. Shopify ödeme ayarlarınızda Craftgate'in aktif sağlayıcı olarak göründüğünü teyit edip ilk gerçek siparişi yakından takip edin.
Craftgate'in Öne Çıkan Özellikleri
Craftgate'i tek bankalı bir sanal POS kurulumundan ayıran temel fark, birden fazla ödeme kaynağını tek panelden yönetip aralarında otomatik yönlendirme yapabilmesidir.
Nodus Works olarak birden fazla ödeme sağlayıcısıyla çalışan mağazalarda gördüğümüz ortak sorun, sağlayıcı başarısız olduğunda satışın tamamen durmasıdır. Craftgate'in otomatik yönlendirme mantığı bu riski tek sağlayıcıya bağımlılıktan çıkarıp dağıtıyor; ancak bu, kurulumun karmaşıklığını da artırıyor, bu yüzden tek banka yeterli olan küçük ölçekli mağazalar için gereğinden fazla bir katman olabilir.
Craftgate ile iyzico/PayTR Karşılaştırması
Craftgate, iyzico ve PayTR'nin aksine tek bir ödeme kuruluşu değil, birden fazla banka ve ödeme kuruluşunu tek entegrasyon üzerinden yöneten bir katman olarak konumlanıyor. Bu fark hangi mağazanın hangi sağlayıcıyı seçmesi gerektiğini doğrudan belirliyor.
Nodus Works olarak yönettiğimiz projelerdeki gözlemimize göre, tek bir banka sanal POS'u yeterli olan bir mağaza için Craftgate'in çoklu yönlendirme katmanı gereksiz bir karmaşıklık ekliyor; iyzico veya PayTR'nin tek entegrasyonu o mağaza için daha az bakım yükü demek. Craftgate'in asıl değeri, birden fazla banka anlaşması olan ve ödeme reddi oranını düşürmek isteyen orta-büyük ölçekli mağazalarda ortaya çıkıyor.
Yaygın Hatalar ve Dikkat Edilmesi Gerekenler
Craftgate kurulumunda en sık karşılaşılan sorun, sandbox testinin atlanıp doğrudan canlı ortama geçilmesi; bu durumda ödeme sonucu Shopify sipariş ekranına yansımadığında sorunun kaynağını canlı ortamda aramak zorunda kalırsınız.
Kritik Not: Craftgate Payment Gateway uygulamasının Shopify App Store listesinde, 2022'deki yayın tarihinden bu yana 0 yorum bulunuyor. Bu, uygulamanın işlevsiz olduğu anlamına gelmiyor; Craftgate'in Shopify entegrasyonunu doğrudan kendi geliştirici dokümantasyonu üzerinden destekleyip App Store yorumlarını önceliklendirmediğini gösteriyor. Kuruluma başlamadan önce Craftgate'in kendi destek kanalından güncel entegrasyon adımlarını teyit edin.
İkinci yaygın hata, birden fazla banka sanal POS'u tanımlandığında yönlendirme kurallarının test edilmeden bırakılmasıdır. Akıllı Yönlendirme aktifken hangi işlemin hangi bankaya gideceği önceden belirlenmiyor; bu yüzden düşük tutarlı bir test siparişiyle sadece tek bir bankanın çalıştığını doğrulamak yeterli olmuyor, en az iki farklı banka sanal POS'u üzerinden test işlemi yapılmalı.
İpucu: Ödeme Tekrar Deneme (Payment Retry) özelliğini aktif ettikten sonra, müşteriye kaç deneme hakkı tanındığını ve bu denemelerin checkout ekranında nasıl göründüğünü mutlaka test edin. Bu ayar varsayılan bırakılırsa müşteri kart bilgisini defalarca girmek zorunda kalabilir, bu da sepet terk oranını artırır.
Üçüncü nokta, Multinet veya Edenred Hediye Kartı gibi alternatif ödeme yöntemlerinin Craftgate panelinde aktif edilmesiyle Shopify checkout ekranında otomatik görünmesi arasında ayrı bir adım var; panel tarafında aktif edilen bir yöntem, Shopify ödeme ayarlarında ayrıca görünür hale getirilmediği sürece müşteri ekranına yansımıyor.
SSS: Shopify Craftgate Entegrasyonu
Shopify'da Craftgate nasıl kurulur? Craftgate.io üzerinden hesap açıp API anahtarlarınızı aldıktan sonra Shopify App Store'dan Craftgate Payment Gateway'i yükleyin ve anahtarları uygulama ayarlarına girin. Bağlı bankaları tanımlayıp sandbox ortamında test işlemi yaptıktan sonra canlıya alın.
Craftgate ücretsiz mi? Shopify uygulamasının kendisi ücretsiz; maliyet, bağladığınız banka sanal POS'larının komisyon oranlarından ve varsa Craftgate'in kendi hizmet bedelinden oluşuyor. Güncel komisyon bilgisini Craftgate'in satış ekibinden almanız gerekiyor, çünkü bu oran mağazadan mağazaya değişiyor.
Craftgate ile hangi bankalar çalışır? Craftgate, anlaştığınız banka sanal POS'larını tek panelde birleştiriyor; hangi bankaların desteklendiği Craftgate'in güncel banka listesine göre değişiyor. Yeni bir bankayla anlaşma yaptığınızda bu bankayı panelden ayrıca tanımlamanız gerekiyor.
Craftgate mi PayTR mi tercih edilmeli? Tek bir banka sanal POS'u yeterli olan küçük-orta ölçekli mağazalar için PayTR'nin tek entegrasyonu daha az bakım gerektiriyor. Birden fazla banka anlaşması olan ve ödeme reddi oranını düşürmek isteyen mağazalar için Craftgate'in çoklu yönlendirme katmanı daha uygun.
Craftgate'in sandbox ortamı nasıl kullanılır? sandbox-panel.craftgate.io üzerinden ayrı bir test hesabı açıp gerçek para hareketi olmadan test siparişi tamamlayabilirsiniz. Canlı hesap bilgileriyle sandbox hesabı birbirinden bağımsız, bu yüzden canlıya geçmeden önce sandbox'ta ayrı bir kayıt oluşturmanız gerekiyor.
Sonuç
Craftgate, tek bankalı bir sanal POS kurulumunun yetersiz kaldığı, birden fazla ödeme kaynağını yönetmek isteyen Shopify mağazaları için bir orta katman çözümü. Kurulumu iyzico veya PayTR'ye göre daha fazla adım gerektiriyor, ama karşılığında ödeme reddi oranını düşürecek otomatik yönlendirme ve tekrar deneme mekanizmaları sunuyor.
Hangi ödeme sağlayıcısının mağazanıza uygun olduğuna karar vermeden önce mevcut komisyon yapınızı ve sipariş hacminizi çıkarın; tek banka yeterliyse Craftgate'in kurulum yükü gereksiz kalır. Ödeme entegrasyonunu Shopify'ın diğer teknik bileşenleriyle (kargo, ERP, muhasebe) birlikte uçtan uca kurmak isteyen mağazalar için Shopify entegrasyon hizmetimiz banka sanal POS bağlantısından ERP senkronizasyonuna kadar tüm süreci tek elden yürütüyor. Türkiye'de Shopify'a bağlanan diğer ödeme sağlayıcılarını (Sipay, Paratika, Lidio) Shopify sanal POS kurulumu rehberimizde karşılaştırmalı olarak inceledik.
