Sanal POS ve Ödeme Sistemi Entegrasyonu
Web sitenizden kartla ödeme alabilmeniz için iki şeye ihtiyacınız vardır: bir ödeme altyapısı hesabı ve bu hesabı sitenize güvenle bağlayan bir entegrasyon. Hesabı ödeme kuruluşu veya bankanız açar; bağlantıyı, testleri ve canlıya geçişi biz yaparız.
iyzico ve PayTR gibi ödeme kuruluşlarıyla da, bankanızdan aldığınız doğrudan sanal POS ile de çalışıyoruz. Siteniz WooCommerce, OpenCart, PrestaShop veya size özel yazılmış bir sistem olabilir.
Hangi altyapı size uygun?
| Ölçüt | Ödeme kuruluşu (iyzico, PayTR vb.) | Banka sanal POS’u |
|---|---|---|
| Başvuru | Çevrim içi, genellikle hızlı | Şube ve müşteri temsilcisi üzerinden |
| Farklı bankaların kartları | Tek entegrasyonla çoğu kart | Taksit için ek banka anlaşmaları gerekebilir |
| Para hesabınıza geçişi | Kuruluşun belirlediği süre | Bankayla yapılan anlaşmaya göre |
| Kimler için | Yeni açılan veya küçük ölçekli mağazalar | Yüksek cirolu ve bankasıyla güçlü ilişkisi olan işletmeler |
Hangi kuruluşun koşullarının size uygun olduğunu kendi tekliflerini karşılaştırarak siz seçersiniz; biz teknik açıdan farkları ve entegrasyon zorluğunu anlatırız.
Entegrasyon adımları
- Hesap bilgileri: Ödeme kuruluşu başvurunuzu onayladıktan sonra size verilen mağaza numarası ve API anahtarları güvenli bir kanalla bize iletilir.
- Test ortamı: Kuruluşun test anahtarlarıyla sitenizin kopyası veya bakım modundaki hâli üzerinde ödeme akışı kurulur.
- 3D Secure ve geri dönüş adresleri: Başarılı, başarısız ve iptal edilen ödemelerden sonra müşterinin hangi sayfaya döneceği ayarlanır.
- Taksit ve kart görünümü: Taksit seçenekleri, ödeme sayfasının dili ve mağaza adınız düzenlenir.
- Canlıya geçiş: Gerçek anahtarlarla küçük bir deneme ödemesi yapılır, iade edilerek sürecin iki yönü de sınanır.
Test ettiğimiz senaryolar
- Başarılı tek çekim ödeme
- Taksitli ödeme
- Yetersiz bakiye veya yanlış doğrulama koduyla reddedilen ödeme
- Müşterinin 3D Secure ekranında sayfayı kapatması
- Sipariş durumunun panelde doğru güncellenmesi
- Tam ve kısmi iade
Ödemeyi neye göre onaylıyoruz?
Müşterinin ödemeden sonra gördüğü “ödeme başarılı” sayfası, siparişi onaylamak için güvenilir bir kaynak değildir; o sayfa yalnız müşteriyi bilgilendirir. Bu yüzden kurduğumuz entegrasyonlarda sipariş, ödeme kuruluşunun yöntemine göre ya sitenizin sunucusuna doğrudan gönderdiği sonuç bildirimine ya da sunucudan yapılan sonuç sorgusuna göre onaylanır. Örneğin PayTR, siparişin başarılı ödeme sayfasında değil, bildirim adresinde onaylanması gerektiğini geliştirici belgelerinde açıkça belirtir.
- İmza kontrolü: Bildirimin gerçekten ödeme kuruluşundan geldiği, kuruluşun verdiği gizli anahtarla üretilen imza (hash) karşılaştırılarak doğrulanır; doğrulanamayan bildirim işlenmez.
- Tekrarlanan bildirim: Aynı ödeme için birden fazla bildirim gelebilir. Sipariş numarasıyla kontrol edilir; zaten onaylanmış ya da iptal edilmiş sipariş ikinci kez işlenmez.
- Beklenen yanıt: Bildirimi alan sayfa kuruluşun beklediği yanıtı vermezse işlem kuruluşun kayıtlarında tamamlanmamış görünebilir. Bu nedenle canlıya geçmeden önce sipariş durumunun doğru güncellendiğini test ederiz.
Banka sanal POS’u ile ödeme kuruluşu arasındaki farkları e-ticaret sitesi kurma eğitimimizin ödeme modülünde anlattık.
Kart bilgisi sitenizde saklanmaz
Kurduğumuz entegrasyonlarda kart numarası sitenizin veritabanına yazılmaz. Ödeme ya ödeme kuruluşunun sayfasında ya da kuruluşun sağladığı güvenli form alanında alınır. Böylece siteniz kart verisini taşımaz ve güvenlik riski önemli ölçüde azalır. Sitenizin tüm sayfalarında geçerli bir SSL sertifikası bulunması ise ön koşuldur.
Hangi altyapılarla çalışıyoruz?
- WooCommerce ve diğer açık kaynaklı e-ticaret yazılımları
- Özel yazılım veya Laravel, Node.js tabanlı web uygulamaları
- Abonelik ya da tekrarlayan ödeme gerektiren üyelik siteleri
- Bağış ve etkinlik bileti toplayan tek sayfalık formlar
Mağazanızı sıfırdan kuruyorsanız WooCommerce kurulumu çözümümüz ödeme entegrasyonunu da içerir. Sitenizin barındırıldığı ortam için e-ticaret hosting paketlerimize bakabilirsiniz. Pazaryeri, ERP veya muhasebe yazılımı bağlantıları API entegrasyon hizmetimizin konusudur. Tüm işletme çözümlerimiz çözümler sayfasında.
Başlamadan önce elinizde olması gerekenler
- Ödeme kuruluşu veya bankadan alınmış üye işyeri hesabı
- Panelden alınan API anahtarları ve test ortamı bilgileri
- Sitenizin yönetici erişimi ve SSL sertifikasının etkin olması
- Ödeme sonrası müşteriye gösterilecek teşekkür ve hata sayfalarının metinleri
Bu bilgilerden biri eksikse hangi adımı izlemeniz gerektiğini ilk görüşmede birlikte belirleriz.
Sanal POS entegrasyonu hakkında sık sorulan sorular
Sanal POS başvurusunu sizin adınıza yapabilir misiniz?
Başvuru işletmenizin bilgileri ve belgeleriyle ödeme kuruluşuna veya bankaya sizin tarafınızdan yapılır. Biz başvuru formundaki teknik alanların, örneğin site adresi ve geri dönüş adreslerinin, doğru doldurulmasına yardım ederiz.
Birden fazla ödeme altyapısını aynı sitede kullanabilir miyim?
Evet. Örneğin taksitli satışlar için bankanızın POS’unu, diğer kartlar için bir ödeme kuruluşunu aynı ödeme sayfasında seçenek olarak sunabilirsiniz.
Havale ve kapıda ödeme de eklenebilir mi?
Eklenebilir. Bu yöntemler kart entegrasyonu gerektirmez, ancak sipariş durumlarının doğru akması için birlikte ayarlanır.
Ödeme sayfası mobilde nasıl görünür?
Kuruluşun ortak ödeme sayfası kullanılıyorsa onun mobil tasarımı geçerlidir. Sitenin içinde gömülü form kullanılıyorsa alanlar mobil klavyeye uygun hâle getirilir.
Özel yazılımlı sitemiz için de entegrasyon yapıyor musunuz?
Yapıyoruz. Ödeme kuruluşunun API belgelerine göre sunucu tarafında ödeme başlatma ve sonuç doğrulama kodu yazılır, kodun kendisi size teslim edilir.
Entegrasyondan sonra bir ödeme hatası olursa kime başvururuz?
Para hareketiyle ilgili sorular ödeme kuruluşunun destek ekibine, siteyle ödeme sayfası arasındaki bağlantıyla ilgili sorunlar bize iletilir. Hata kayıtlarına birlikte bakarak hangisi olduğunu hızla ayırırız.
Ödeme alındı ama sipariş beklemede görünüyor, neden olur?
Olası nedenlerden biri, ödeme kuruluşunun sonuç bildiriminin sitenize ulaşmaması ya da bildirimi alan sayfanın beklenen yanıtı vermemesidir. Bildirim adresinin doğru tanımlandığı, sunucunun bu isteği engellemediği ve imza kontrolünün geçtiği kontrol edilir; para hareketiyle ilgili sorular ise ödeme kuruluşuna iletilir.
Test ödemelerinde gerçek kart kullanılır mı?
Hayır. Test ortamında ödeme kuruluşunun test anahtarları ve kendi yayımladığı test kartları kullanılır, gerçek para hareketi olmaz. Canlıya geçişte gerçek anahtarlarla küçük bir deneme ödemesi yapılır ve iade edilerek süreç iki yönüyle sınanır.
Ödeme sonucunu yalnız tarayıcıdaki dönüş sayfasına bakarak onaylamak neden risklidir?
Dönüş sayfası müşterinin tarayıcısında açılır ve yalnız bilgilendirme amaçlıdır; müşteri sayfayı kapatabilir ya da bağlantı yarıda kalabilir. Ödeme kuruluşunun sunucunuza gönderdiği ve imzasıyla doğrulanan bildirim ise ödemenin gerçek sonucunu taşır. PayTR örnek kodunda da başarılı ödeme sayfasının sipariş onayı için kullanılmaması gerektiği yazılıdır.