İçeriğe geç
Ondokuzon

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

  1. Sipariş sunucuda oluşturulur, ödeme isteği sepet tutarı ve sipariş numarasıyla sunucudan gönderilir. Tutar tarayıcıdan alınmaz.
  2. 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.
  3. 3D Secure adımında banka, kart sahibini SMS ya da mobil uygulama onayıyla doğrular.
  4. 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.
  5. Sipariş ödendi olarak işaretlenir. Stok, fatura ve kargo akışı bu noktadan başlar.
  6. 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.
  1. Sağlayıcı ve model seçimi. Ödeme kuruluşu, banka POS'u ya da ikisi birlikte; ödeme formu, iframe ya da API.
  2. 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.
  3. Geliştirme. Ödeme isteği, sonuç bildirimi, iptal, iade ve işlem kayıtları yazılır.
  4. Test. Yukarıdaki senaryolar ve çift bildirim durumu denenir.
  5. 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.

Teklif alın

Ö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

Sık sorulan sorular

iyzico entegrasyonu nasıl yapılır?
Önce iyzico'ya üye işyeri başvurusu yapılır ve test anahtarları alınır. Sitenizde ödeme formu ya da API ile ödeme isteği oluşturulur, sonuç sunucu tarafında doğrulanarak siparişe işlenir. Taksit, iade ve hata senaryoları test ortamında denendikten sonra canlı anahtarlara geçilir.
Sanal POS mu, ödeme kuruluşu mu seçmeliyim?
Hızlı açılış, farklı bankaların kartlarında taksit ve tek entegrasyon istiyorsanız iyzico ya da PayTR gibi ödeme kuruluşları pratik bir başlangıçtır. İşlem hacminiz yüksekse ve bankanızla koşul görüşebiliyorsanız banka sanal POS'u avantajlı olabilir. Birçok işletme ikisini birlikte kullanır.
Kart bilgileri sunucumuzda saklanır mı?
Hayır. Sağlayıcının ödeme formu ya da iframe'i kullanıldığında kart numarası doğrudan sağlayıcıya girilir ve sunucunuza uğramaz. Tekrarlayan ödemeler için kart saklama gerekiyorsa bu da sağlayıcının kart saklama hizmetiyle yapılır; sizde yalnızca karta ait bir anahtar tutulur.
3D Secure zorunlu mu?
3D Secure, kart sahibini banka onayıyla doğrulayarak sahte işlem riskini azaltır ve çoğu üye işyeri sözleşmesinde varsayılan yöntemdir. 3D Secure olmadan ödeme alabilmek sağlayıcının ya da bankanın ayrıca onay vermesine bağlıdır. Sözleşme koşullarınızı sağlayıcınızla netleştirmenizi öneririz.
Shopify'da iyzico nasıl kurulur?
Türkiye'de Shopify Payments olmadığı için iyzico ve PayTR, Shopify'a kendi uygulamalarıyla bağlanır; özel kod gerekmez. Uygulama kurulur, sağlayıcıdan alınan anahtarlar girilir ve test siparişiyle kontrol edilir. Ayrıntıları Shopify ödeme yöntemleri sayfamızda anlattık.
Kısmi iade yapılabilir mi?
Evet. Siparişin bir kısmı iade edildiğinde yalnızca o tutar karta iade edilir. Çoğu altyapıda gün sonu kapanmadan önce işlem iade yerine iptal edilir; entegrasyon bu iki durumu ayırt edecek şekilde kurulur.
Ödeme entegrasyonunun maliyetini neler belirler?
Sağlayıcı sayısı, ödeme modeli (form, iframe ya da API), taksit ve iade kuralları, kart saklama ya da abonelik ihtiyacı ve muhasebe mutabakatı geliştirme maliyetini belirler. Sağlayıcının işlem komisyonu bundan ayrıdır ve sağlayıcıyla yapacağınız sözleşmeye bağlıdır.

Hadi birlikte bir şeyler yapalım!

Projenizi anlatın, ihtiyacınızı netleştirelim ve size uygun yol haritasını birlikte çıkaralım.

Projeni anlat