Ödeme ve kargo entegrasyonu, bir mağazanın "sipariş alabilen" bir yazılıma dönüştüğü noktadır. Vitrin, kategori ve ürün sayfası müşteriyi karar anına taşır; entegrasyonlar ise o karardan sonra devreye girer. Bu iki entegrasyon birbirinden bağımsız görünse de aynı sipariş kaydının iki farklı ucuna bağlanır: biri tahsilatın doğrulanmasını, diğeri fiziksel teslimatın izlenmesini sağlar. Aşağıda ikisinin de nasıl kurulduğunu, hangi verinin hangi yönde aktığını anlatıyoruz. Ticari koşullar bankanız ve kargo firmanızla aranızdaki sözleşmenin konusudur; bu sayfa yalnızca teknik tarafı kapsar.
Ödeme entegrasyonu adım adım nasıl çalışır?
Müşteri ödeme ekranında bilgilerini girdiğinde mağaza yazılımı doğrudan tahsilat yapmaz; siparişi hazırlar ve ödeme sağlayıcısına devreder. Akış tipik olarak şöyledir:
- Mağaza, sipariş için benzersiz bir referans üretir ve sepet içeriğini bu referansa bağlar.
- Ödeme isteği, sağlayıcının beklediği biçimde imzalanır. İmza, mağaza ile sağlayıcı arasında paylaşılan gizli anahtarla üretilir ve isteğin yolda değiştirilmediğini kanıtlar.
- Kart bilgisi, sağlayıcının barındırdığı güvenli alanda toplanır. Doğru kurulumda kart verisi mağazanın sunucusuna hiç uğramaz; bu hem güvenlik hem uyum açısından tercih edilen yöntemdir.
- 3D Secure aşamasında müşteri bankasının doğrulama ekranına yönlendirilir, doğrulama sonucu sağlayıcıya döner.
- Sağlayıcı sonucu iki kanaldan bildirir: tarayıcıyı geri döndürerek ve sunucudan sunucuya bir bildirim (webhook) göndererek. Sipariş durumunu her zaman sunucu bildirimine göre kesinleştiririz; çünkü müşteri tarayıcıyı kapatsa bile bildirim ulaşır.
- Sipariş "ödendi" durumuna geçtiğinde stok düşülür, bildirim e-postaları tetiklenir ve sipariş kargo aşamasına açılır.
Bu akışta en sık atlanan nokta, aynı bildirimin birden fazla kez gelebileceğidir. Entegrasyonu, tekrarlanan bildirimlerde siparişi ikinci kez işlemeyecek şekilde kuruyoruz; aksi hâlde tek sipariş iki kez stoktan düşebilir.
Sanal POS ile ödeme kuruluşu arasındaki fark
Banka sanal POS'unda mağaza doğrudan bir bankayla çalışır ve her banka için ayrı bir entegrasyon tanımlanır. Ödeme kuruluşu ya da ödeme hizmeti sağlayıcısı kullanıldığında ise tek bir entegrasyon üzerinden birden çok bankanın kartı kabul edilir; sağlayıcı arkada yönlendirmeyi kendisi yapar. Teknik olarak fark, mağazanın kaç ayrı sistemle konuştuğu ve mutabakat kayıtlarının nereden alındığıdır. Hangisinin size uygun olduğu ticari bir karardır ve bankanızla görüşmenize bağlıdır; biz her iki modelde de entegrasyonu kurup test ederiz.
Taksit ve kampanya tablosu teknik olarak nasıl kurulur?
Taksit seçenekleri mağaza içinde sabit bir liste olarak tutulmaz. Müşteri kart numarasının ilk hanelerini girdiğinde mağaza, bu haneleri (BIN) sağlayıcıya sorar; dönen cevapta kartın hangi banka ve programa ait olduğu ile o kart için tanımlı seçenekler yer alır. Ekranda gösterilen seçenekler bu cevaba göre anlık kurulur. Böylece banka tarafında bir kampanya değiştiğinde mağazada kod güncellemeye gerek kalmaz. Bu tablonun içeriği tamamen bankanızla yaptığınız anlaşmaya bağlıdır; mağaza yalnızca gelen veriyi doğru göstermekle yükümlüdür.
Kargo entegrasyonu neyi otomatikleştirir?
Kargo entegrasyonu olmayan mağazalarda süreç manuel yürür: sipariş listesi indirilir, kargo firmasının paneline elle girilir, takip numarası tek tek kopyalanır. Entegrasyon bu döngüyü ortadan kaldırır ve şu işleri mağaza panelinin içine taşır:
- Gönderi oluşturma: Sipariş kaydındaki alıcı, adres, telefon ve paket bilgisi kargo firmasının servisine iletilir; karşılığında bir gönderi kaydı ve takip numarası döner.
- Etiket üretimi: Barkodlu kargo etiketi doğrudan panelden yazdırılır; el yazısı adres ve okunamayan etiket kaynaklı iadeler biter.
- Takip bilgisinin müşteriye ulaşması: Takip numarası sipariş kaydına işlenir, müşteriye bildirim gönderilir ve hesabındaki sipariş detayında görünür.
- Durum güncellemeleri: Kargo firması "şubeye teslim", "dağıtımda", "teslim edildi" gibi durumları bildirdikçe sipariş durumu otomatik ilerler.
- Toplu işlem: Gün sonunda bekleyen tüm siparişler için gönderi kayıtları tek seferde oluşturulur.
Paket bilgisi, teslimat kuralları ve teslimat noktaları
Kargo servisi bir gönderi oluşturabilmek için paketin ağırlık ve hacim bilgisini bekler. Bu yüzden ürün kayıtlarına desi ve ağırlık alanlarını baştan ekliyoruz; sepet bu alanları toplayarak gönderiyi doğru sınıfta açıyor. Teslimat kuralları da aynı veriye dayanır: hangi bölgeye hangi sürede teslimat yapılacağı, hangi ürünlerin ayrı paketleneceği, kırılabilir ürünlerde özel işaretleme gerekip gerekmediği. Şubeden veya teslimat noktasından teslim seçeneği kullanılacaksa nokta listesi kargo firmasının servisinden çekilir ve müşteri sepet ekranında haritadan seçim yapar.
İptal, iade ve kısmi iade akışı
İade tarafı çoğu mağazada eksik kurulur ve sonradan sorun çıkarır. Teknik olarak iki ayrı işlem vardır: sipariş henüz gün sonu kapanmadan iptal edilirse işlem tamamen geri alınır; kapandıktan sonra iade edilirse ayrı bir iade kaydı oluşur. Kısmi iadelerde sipariş satırlarından yalnızca iade edilenler işaretlenir, kalan satırlar geçerliliğini korur. Kargo tarafında ise iade gönderisi ayrı bir kayıt olarak açılır ve müşteriye iade kodu iletilir. Bu akışları mağaza paneline yerleştirmek, müşteri hizmetlerinin her iade için sizi aramasını engeller.
Test ortamı, canlıya geçiş ve mutabakat
Her entegrasyon önce sağlayıcının test ortamında kurulur. Test kartlarıyla başarılı ödeme, başarısız ödeme, 3D doğrulamanın yarıda kesilmesi ve bildirim gecikmesi senaryolarını tek tek deneriz. Kargo tarafında test gönderisi oluşturulup etiket çıktısı kontrol edilir. Canlıya geçişte anahtarlar değiştirilir ve gerçek bir sipariş üzerinden uçtan uca doğrulama yapılır. Yayın sonrasında ise mağaza kayıtlarıyla sağlayıcı kayıtlarının düzenli karşılaştırılabilmesi için sipariş referanslarını iki tarafta da aynı biçimde tutarız; mutabakat ancak bu sayede pratik olur.
Mağazanız henüz kurulmadıysa entegrasyonlar e-ticaret sitesi kurulumu kapsamında hazır gelir. Sürecin baştan sona nasıl ilerlediğini e-ticaret sitesi nasıl açılır sayfasında, bayi yapıları için gereken farklı akışları ise b2b toptan satış sitesi sayfasında bulabilirsiniz.