Kısa cevap: Sanal POS entegrasyonu için önce banka veya ödeme kuruluşundan üye işyeri numaranızı, API anahtarlarınızı ve test ortamı erişiminizi alırsınız. Ardından ödeme formu, 3D Secure yönlendirmesi, başarılı ve başarısız dönüş adresleri, iptal ve iade işlemleri sitenize kodlanır. Dönüş yanıtları imza ile doğrulanıp siparişle eşleştirilir, tüm senaryolar test edildikten sonra canlı ortama geçilir.
Entegrasyondan önce netleşmesi gerekenler
Teknik çalışmaya başlamadan önce sözleşmenin imzalanmış ve sağlayıcının sitenizi onaylamış olması gerekir. Bu aşamayı sanal POS nasıl alınır yazımızda anlattık. Ayrıca şu kararları baştan vermek, entegrasyonu hızlandırır:
- Ödeme formu sitenin içinde mi görünecek, yoksa müşteri sağlayıcının ortak ödeme sayfasına mı yönlenecek?
- Hangi kartlarda kaç taksit sunulacak, taksit farkı yansıtılacak mı?
- Tek POS mu kullanılacak, yoksa birden fazla sağlayıcı arasında yönlendirme mi yapılacak?
- Kayıtlı kartla tekrar ödeme veya abonelik gerekecek mi?
- Ödeme sonrası e-fatura, stok ve muhasebe akışı nasıl tetiklenecek?
Entegrasyon modelleri
Ortak ödeme sayfası
Müşteri ödeme adımında sağlayıcının güvenli sayfasına yönlendirilir, kart bilgilerini orada girer ve işlem sonunda sitenize geri döner. Kurulumu daha basittir ve kart verisi hiç sitenize uğramadığı için güvenlik yükü azdır. Dezavantajı, ödeme deneyiminin tasarımı üzerinde kontrolünüzün sınırlı olmasıdır.
API ile site içi ödeme
Ödeme formu sitenizin tasarımına uygun şekilde görünür, arka planda sağlayıcının API’si ile çalışır. Daha akıcı bir deneyim sunar; ancak kart verisinin güvenli alanlarla ya da sağlayıcının bileşenleriyle işlenmesi, güvenlik standartlarına dikkat edilmesi gerekir.
Hazır eklenti yerine özel entegrasyon
Kiralık paketlerde ödeme eklentileri genellikle tek tip çalışır. Kendi altyapısıyla geliştirilen bir sitede ise taksit tablosu, POS yönlendirme kuralları ve sipariş akışı işletmenin ihtiyacına göre kurgulanabilir.
Sanal POS entegrasyonu adım adım
- Erişim bilgilerini alın: Üye işyeri numarası, kullanıcı bilgileri, API anahtarı ve gizli anahtar, test ve canlı ortam adresleri. Bu bilgileri kodun içine gömmek yerine güvenli yapılandırma alanlarında saklayın.
- Dokümantasyonu inceleyin: Sağlayıcının istek ve yanıt formatlarını, imza (hash) oluşturma yöntemini, hata kodlarını ve 3D Secure akışını okuyun.
- Ödeme isteğini oluşturun: Sipariş numarası, tutar, para birimi, taksit sayısı ve dönüş adresleriyle bir ödeme isteği hazırlanır ve imzalanır.
- 3D Secure yönlendirmesini kurun: Müşteri bankanın doğrulama ekranına gider, doğrulama sonrası sağlayıcı sonucu sizin dönüş adresinize iletir.
- Dönüş yanıtını doğrulayın: Gelen yanıttaki imzayı kendi gizli anahtarınızla yeniden hesaplayıp karşılaştırın. Doğrulanmayan yanıtla sipariş onaylanmamalıdır.
- Siparişi eşleştirin: Başarılı işlemde sipariş onaylanır, stok düşülür, müşteriye bilgilendirme gider. Başarısız işlemde sepet korunur ve anlaşılır bir hata mesajı gösterilir.
- İşlem sorgulamayı ekleyin: Müşteri dönüş sayfasına gelmeden tarayıcıyı kapatırsa ödeme bankada tamamlanmış ama siparişiniz beklemede kalmış olabilir. Sağlayıcıdan işlem durumunu sorgulayan bir kontrol, çift çekim ve kayıp siparişi önler.
- İptal ve iade işlemlerini bağlayın: Sipariş ekranından tam ve kısmi iade yapılabilmeli, sonuç kayıtlara işlenmelidir.
- Taksit tablosunu gösterin: Kartın ilk haneleri girildiğinde ilgili kart ailesine ait taksit seçenekleri dinamik olarak listelenmelidir.
- Test edin: Sağlayıcının test kartlarıyla başarılı, yetersiz limit, 3D başarısız, zaman aşımı, iptal, kısmi iade senaryolarını tek tek deneyin.
- Canlıya geçin ve izleyin: Canlı anahtarlara geçtikten sonra ilk günlerde düşük tutarlı gerçek işlemlerle kontrol yapın, hata kayıtlarını izleyin.
Güvenlik açısından olmazsa olmazlar
- Kart numarası, son kullanma tarihi ve güvenlik kodu asla kendi veritabanınıza, kayıt dosyalarınıza veya e-postalara yazılmamalı.
- Tüm site SSL ile şifreli bağlantı üzerinden çalışmalı.
- Gizli anahtarlar yalnızca sunucu tarafında tutulmalı, tarayıcıya gönderilmemeli.
- Tutar, sunucu tarafında siparişten yeniden hesaplanmalı; tarayıcıdan gelen tutara güvenilmemeli.
- Kayıtlı kart özelliği gerekiyorsa sağlayıcının tokenizasyon yapısı kullanılmalı.
- Yönetim paneline erişim yetkileri sınırlandırılmalı ve iade yetkisi kontrol altında tutulmalı.
Sık yapılan hatalar
- Dönüş yanıtının imzasını doğrulamadan siparişi onaylamak.
- Test ortamı anahtarlarını canlıda unutmak veya tam tersi.
- İşlem sorgulama olmadığı için ödenmiş siparişleri “ödeme bekleniyor” durumunda bırakmak.
- Hata mesajlarını teknik kodlarla göstermek, müşteriyi ne yapacağını bilemez halde bırakmak.
- İade işlemini sağlayıcı panelinden yapıp sipariş sistemine işlememek.
Entegrasyon sonrası e-fatura ve muhasebe bağlantısı
Ödeme başarılı olduğunda iş bitmez; sipariş için fatura kesilmesi, tahsilatın muhasebe kayıtlarına işlenmesi ve hakediş raporlarıyla mutabakat yapılması gerekir. Entegrasyonu bu adımlarla birlikte kurgulamak, ay sonunda elle eşleştirme yükünü ortadan kaldırır. Fatura ve kayıt yükümlülüklerine ilişkin güncel durumu mali müşavirinize teyit ettirin.
Entegrasyon maliyetini ve süresini belirleyen kalemler
Entegrasyonun kapsamı işletmeye göre değişir. Sağlayıcı sayısı, site içi ödeme mi yönlendirme mi tercih edildiği, taksit ve kampanya kuralları, kayıtlı kart ve abonelik ihtiyacı, e-fatura ve ERP bağlantıları, çoklu para birimi ve test süreci iş yükünü belirler.
Racoun nasıl yardımcı olur?
Racoun, e-ticaret sitelerini hazır tema veya kiralık paket kullanmadan kendi altyapısı üzerinde kodlar; sanal POS entegrasyonu, 3D Secure akışı, işlem sorgulama, kısmi iade, çoklu POS yönlendirme ve e-fatura bağlantısı bu yapının içinde gelir. Ödeme akışının nasıl işlediğini merak ediyorsanız sanal POS nasıl çalışır yazımıza, altyapı detayları için e-ticaret yazılımı sayfamıza göz atabilirsiniz.
Sık sorulan sorular
Sanal POS entegrasyonu için yazılımcı gerekir mi?
Ortak ödeme sayfası modelinde bile dönüş yanıtlarını doğrulamak ve siparişle eşleştirmek teknik bilgi ister. Sağlam bir entegrasyon için deneyimli bir yazılım ekibiyle çalışmak önerilir.
Birden fazla sanal POS aynı siteye entegre edilebilir mi?
Evet. Altyapı destekliyorsa kart ailesine, taksit sayısına veya sağlayıcı erişilebilirliğine göre işlemler farklı POS’lara yönlendirilebilir.
Test ortamında başarılı olan entegrasyon canlıda neden hata verir?
En sık neden canlı anahtarların veya dönüş adreslerinin yanlış tanımlanmasıdır. Sağlayıcı tarafında canlı ortam yetkilerinin açılmamış olması da hataya yol açabilir.
Racoun ile konuşun: İstanbul merkezli ekibimizle Türkiye genelindeki markalara hizmet veriyoruz. WhatsApp üzerinden yazabilir ya da teklif formunu doldurabilirsiniz. İlk görüşme ücretsizdir.
