Entegrasyon
iyzico Entegrasyonu ve Sanal POS: PayTR, Banka POS'ları ve 3D Secure
iyzico entegrasyonu, kart ödemelerini iyzico'nun ödeme formu ya da API'siyle sitenize veya mobil uygulamanıza bağlar; PayTR ve banka sanal POS'larında da mantık aynıdır. 3D Secure, taksit ve iadeyi siparişe işliyoruz.
iyzico entegrasyonu, sitenizde ya da mobil uygulamanızda kartla ödeme almanın yollarından biridir: Müşteri kart bilgisini iyzico'nun ödeme formuna girer, 3D Secure doğrulamasından geçer, sonuç sitenize döner ve sipariş ödenmiş olarak işaretlenir. PayTR'de ve bankaların sanal POS'larında da akış aynı mantıkla çalışır; değişen, ödeme isteğinin biçimi ve sonucun nasıl doğrulandığıdır.
Ödeme sistemi entegrasyonu yalnızca ödeme formunu sayfaya koymak değildir. Taksit seçenekleri, iptal ve iade, aynı bildirimin iki kez gelmesi, ödemesi alınmış ama siparişe düşmemiş işlemler ve muhasebe mutabakatı da bu işin parçasıdır. Bu sayfada özel geliştirilen e-ticaret siteleri, mobil uygulamalar ve portallar için sanal POS entegrasyonunu anlatıyoruz. Shopify kullanıyorsanız ödeme tarafı farklı kurgulanır; ayrıntılar Shopify ödeme yöntemleri sayfasında. Diğer bağlantılar için e-ticaret ve ERP entegrasyonu sayfasına bakabilirsiniz.
Ödeme kuruluşu mu, banka sanal POS'u mu?
Türkiye'de kartlı internet ödemesi iki yoldan alınır: iyzico ve PayTR gibi lisanslı ödeme kuruluşları ya da bir bankayla yapılan sanal POS sözleşmesi. Komisyon ve para aktarım koşulları sözleşmeye göre değiştiği için burada oran vermiyoruz. Karar verirken şu farklara bakın:
| Kriter | Ödeme kuruluşu (iyzico, PayTR) | Banka sanal POS'u |
|---|---|---|
| Başvuru | Çevrimiçi başvuru, belge ve site kontrolü | Bankayla üye işyeri sözleşmesi |
| Taksit | Farklı bankaların kartlarında tek sözleşmeyle | Çoğunlukla bankanın kendi kart programıyla sınırlı |
| Para aktarımı | Sağlayıcının aktarım takvimine göre | Bankanın sözleşme koşullarına göre |
| Entegrasyon | Ortak ödeme formu ve API | Bankanın altyapısına göre (3D Pay, 3D Host gibi modeller) |
| Uygun olduğu durum | Hızlı açılış, başlangıç ve orta hacim | Yüksek hacim, bankayla koşul görüşme imkanı |
Hacmi büyüyen işletmeler çoğu zaman ikisini birlikte kullanır: Kart, bankanın kendi kart programına aitse banka POS'una, değilse ödeme kuruluşuna yönlendirilir. Bu yönlendirme kartın ilk hanelerine (BIN) bakılarak yapılır ve entegrasyonun bir kuralı olarak yazılır.
Ödeme akışı 3D Secure ve sunucu tarafında doğrulamayla ilerler
- Sipariş sunucuda oluşturulur, ödeme isteği sepet tutarı ve sipariş numarasıyla sunucudan gönderilir. Tutar tarayıcıdan alınmaz.
- Müşteri kart bilgisini sağlayıcının ödeme formuna ya da sayfaya gömülü çerçevesine (iframe) girer. Kart numarası sunucunuza uğramaz.
- 3D Secure adımında banka, kart sahibini SMS ya da mobil uygulama onayıyla doğrular.
- Sonuç sağlayıcıdan sunucunuza bildirim olarak gelir. Bildirimin imzası doğrulanır ya da sonuç sağlayıcıdan ayrıca sorgulanır.
- Sipariş ödendi olarak işaretlenir. Stok, fatura ve kargo akışı bu noktadan başlar.
- Aynı bildirim birden fazla gelirse tekrar koruması devreye girer ve sipariş yalnızca bir kez işlenir.
Sık yapılan hata, ödemenin sonucunu müşterinin döndüğü teşekkür sayfasına bağlamaktır. Müşteri ödemeden sonra sekmeyi kapatabilir ya da bağlantısı kopabilir; asıl kaynak, sağlayıcının sunucuya gönderdiği bildirimdir. Kart bilgisini kendi formunuzda alıp sunucunuzdan geçirmek de PCI DSS yükümlülüklerini ciddi biçimde artırır; sağlayıcının ödeme formu bu yükü büyük ölçüde sağlayıcıya bırakır.
Taksit, iptal, iade ve diğer ödeme senaryoları
- Taksit seçenekleri kartın ilk hanelerine göre sağlayıcıdan sorgulanır ve ödeme sayfasında gösterilir. Vade farkını müşteriye yansıtacaksanız toplam tutar ödemeden önce açıkça görünmelidir.
- Çoğu altyapıda gün sonu kapanmadan önce işlem iptal edilir, sonrasında iade yapılır. Entegrasyon iptal ile iadeyi ayırt eder ve iade tutarını siparişin iade satırlarıyla eşler.
- Bazı sağlayıcılarda kısmi iade sepet kalemi bazında yapılır. Bu yüzden ödeme isteğindeki sepet kalemlerini siparişin satırlarıyla birebir göndeririz.
- Kart saklama ve abonelik gerektiren tekrarlayan ödemelerde kart, sağlayıcının kart saklama hizmetinde tutulur. Sizde yalnızca karta ait bir anahtar kalır.
- Kapıda ödeme ve havale sanal POS'tan geçmez. Sipariş ayrı bir ödeme durumuyla izlenir, tahsilat kargo firmasından ya da banka hareketinden eşlenir.
- Birden fazla satıcı adına ödeme aldığınız pazaryeri modelinde tutar, ödeme kuruluşlarının alt üye işyeri yapısıyla satıcılar arasında bölünür.
Ödemeyi siparişe ve muhasebeye bağlamak
Ödeme alındıktan sonra iş bitmez. Sağlayıcının işlem numarası siparişe yazılır, fatura ödeme onayıyla kesilir ve tahsilat ERP'de ilgili cari hesaba işlenir. Sağlayıcı parayı kendi takvimine göre ve komisyonunu düşerek aktardığı için muhasebede bu farkın da kaydı tutulur. Fatura tarafını e-fatura entegrasyonu, ERP tarafını ERP entegrasyonu sayfalarında anlattık.
Günlük bir mutabakat işi, sağlayıcının işlem listesini siparişlerle karşılaştırır ve iki tür farkı listeler: ödemesi alınmış ama siparişe düşmemiş işlemler ile ödendi görünen ama sağlayıcıda karşılığı olmayan siparişler. İlki genellikle bildirimin ulaşmadığı durumlarda çıkar ve müşteri hizmetlerini en çok yoran sorundur.
Mobil uygulamalarda ve randevu sistemlerinde ödeme
Mobil uygulamada fiziksel ürün ya da hizmet satıyorsanız ödeme sanal POS ile alınabilir; ödeme formu uygulama içinde açılan bir web görünümünde çalışır. Dijital içerik ve abonelik satışlarında ise App Store ve Google Play genel kural olarak kendi ödeme sistemlerini şart koşar. Ayrıntılar mobil uygulama geliştirme sayfasında. Randevu ve rezervasyon sistemlerinde kapora ya da ön ödeme de aynı altyapıyla alınır; örnek kurgu için online randevu sistemi sayfasına bakabilirsiniz.
Canlıya geçiş kontrol listesi
- Sitenizde mesafeli satış sözleşmesi, ön bilgilendirme formu, iade koşulları, gizlilik metni ve iletişim bilgileri hazır olmalı; çoğu sağlayıcı bunları başvuruda kontrol eder.
- Test anahtarlarıyla başarılı, başarısız, 3D doğrulaması yarıda kalan ve zaman aşımına uğrayan ödemeler denenir.
- Canlı anahtarlar yalnızca sunucuda, kod deposunun dışında tutulur.
- Bildirim adresi HTTPS üzerinden erişilebilir olmalı, güvenlik duvarı sağlayıcının isteklerini engellememelidir.
- İndirimli tutarlar, KDV ve kuruş yuvarlaması sepet toplamıyla birebir tutmalıdır.
- Canlıda küçük tutarlı gerçek bir ödeme ve iadesi yapılarak akış kontrol edilir.
- Sağlayıcı ve model seçimi. Ödeme kuruluşu, banka POS'u ya da ikisi birlikte; ödeme formu, iframe ya da API.
- Başvuru ve test anahtarları. Siz sağlayıcıyla sözleşmeyi yaparsınız, biz test ortamında çalışmaya başlarız.
- Geliştirme. Ödeme isteği, sonuç bildirimi, iptal, iade ve işlem kayıtları yazılır.
- Test. Yukarıdaki senaryolar ve çift bildirim durumu denenir.
- Canlı ve mutabakat. Canlı anahtarlara geçilir, günlük mutabakat ve hata bildirimleri açılır.
Ödeme altyapınızı birlikte kuralım
Çalıştığınız ya da çalışmayı düşündüğünüz sağlayıcıyı, sitenizin altyapısını ve taksit, iade ihtiyaçlarınızı yazın; kapsamı birlikte çıkaralım.
Ödeme entegrasyonu maliyetini belirleyen kalemler
- Sağlayıcı sayısı: tek sağlayıcı ya da birden fazla POS ve yönlendirme kuralı
- Ödeme modeli: ödeme formu, iframe ya da API
- Taksit, vade farkı ve kampanya kuralları
- İptal, iade ve kısmi iade akışları
- Kart saklama, abonelik ya da alt üye işyeri modeli
- ERP ve muhasebe mutabakatı
- Mobil uygulama desteği
Sağlayıcının işlem komisyonu bu kalemlerden ayrıdır ve sağlayıcıyla yapacağınız sözleşmeye bağlıdır.
Ödeme ve sipariş akışlarındaki deneyimimiz
- Shopify mağaza kurulumlarında iyzico ve PayTR ödeme uygulamalarının kurulumu
- Laravel kuyruklarıyla çalışan, canlıdaki sipariş, e-fatura ve kargo entegrasyonları: Nebim V3, Paraşüt ve Yurtiçi Kargo
SSS