E-pin veya dijital ürün satan bir siteniz varsa, kullanıcının parayı görüp kodu 30 saniye içinde teslim alması sizin için hem güven hem de satış meselesidir. Ama bu güveni sağlayan asıl mekanizma, arka planda çalışan kartlı ödeme entegrasyonudur — ve tam da burada çoğu girişimci PayTR, Shopier, 3D Secure ve API dokümantasyonları arasında kaybolur. Peki bu entegrasyonu doğru kurmanın, hem güvenli hem de hızlı teslimat sağlayan bir sisteme dönüştürmenin yolu nedir?
E-Pin Sitesinde Kartlı Ödeme Neden Sıradan Bir Entegrasyondan Farklıdır?
Normal bir e-ticaret sitesinde ödeme alındıktan sonra kargo süreci başlar; müşteri günler içinde ürünü bekler ve bu bekleme aslında hataları gizler. E-pin sitelerinde ise durum tam tersi: ödeme onaylandığı anda ürün (kod) saniyeler içinde teslim edilmek zorundadır. Bu da ödeme sisteminin sadece "para al" değil, "ödemeyi doğrula ve stok sistemine anında haber ver" görevini de üstlenmesi gerektiği anlamına gelir.
Bu yüzden e-pin scriptinde kartlı ödeme entegrasyonu üç katmanı aynı anda yönetmelidir:
- Kart bilgisinin güvenli şekilde bankaya/sanal POS'a iletilmesi
- Ödeme sonucunun (başarılı/başarısız/bekliyor) anında ve doğru şekilde sisteme dönmesi
- Onaylanan ödemenin, stoktaki kodu otomatik olarak kilitleyip müşteriye teslim etmesi
Bu üç katmandan biri eksik kurulursa ya müşteri parasını ödeyip kod alamaz ya da daha kötüsü, aynı kod iki kişiye birden gider. Entegrasyonun teknik detaylarına girmeden önce bu üç katmanın birbirine nasıl bağlandığını anlamak, ilerideki hataların çoğunu baştan önler.
Bir de işin "görünmeyen" tarafı var: müşteri gözünde her şey bir tık meselesi olsa da, arka planda ödeme sağlayıcısı, sizin sunucunuz ve stok/tedarikçi sisteminiz arasında en az üç ayrı ağ isteği gerçekleşir. Bu isteklerden biri gecikirse veya zaman aşımına uğrarsa, "ödeme yapıldı ama sipariş görünmüyor" gibi destek talepleriyle boğuşmaya başlarsınız. Dolayısıyla iyi bir entegrasyon, sadece "çalışan" değil, gecikmeye ve hataya karşı da dayanıklı olmalıdır.
PayTR mı, Shopier mı? Hangi Sanal POS E-Pin İşine Daha Uygun?
Türkiye'de dijital ürün satan siteler için pratikte iki isim öne çıkıyor: PayTR ve Shopier. İkisi de banka sözleşmesi gerektirmeden kartlı ödeme almanızı sağlıyor, ama e-pin özelinde farkları var.
- PayTR, API tabanlı doğrudan entegrasyona daha uygun; ödeme formu kendi sitenizde kalabilir (iframe ile), bu da kullanıcı deneyimini kesintisiz tutar ve terk oranını düşürür.
- Shopier, kurulumu daha basittir ama genelde kullanıcıyı kendi ödeme sayfasına yönlendirir; bu ekstra bir yönlendirme adımı demektir.
- Dijital ürün ve oyun kodu satışında risk skorlaması yapan altyapılar (PayTR gibi) chargeback oranını daha iyi yönetir, çünkü bu sektör kart dolandırıcılığı için sık hedef alınır.
- Havale/EFT seçeneğiyle birlikte sunulduğunda müşteri güveni artar; ama otomatik teslimat sadece anlık doğrulanan kartlı ödemede tam anlamıyla çalışır.
Pinova'da her iki altyapı da hazır modül olarak geliyor; hangisini seçeceğiniz komisyon oranınıza, hedef kitlenize ve mevcut Shopier/PayTR üye iş yeri hesabınıza bağlı. İkisini birlikte açıp müşteriye seçenek sunmak da mümkün — bu da dönüşüm oranını gözle görülür şekilde yükseltiyor.
| Kriter | Manuel / Elle | Pinova ile |
|---|---|---|
| Ödeme altyapısı kurulum süresi | Günler, API dokümantasyonu okuma+test | Panelden API bilgisi girip dakikalar içinde aktif |
| 3D Secure yönlendirme/doğrulama | Elle kodlanmış callback, hata riski yüksek | Hazır callback + imza doğrulama katmanı |
| Ödeme sonrası kod teslimatı | Personel manuel kontrol edip kod gönderir | Onay anında otomatik, 7/24 anlık teslimat |
| Başarısız/iptal ödeme takibi | Excel veya elle log kontrolü | Panelde otomatik işlem geçmişi ve durum etiketi |
| Bayi/alt kullanıcı ödemeleri | Ayrı ayrı hesap takibi, hataya açık | Site cüzdanı üzerinden tek merkezden yönetim |
Entegrasyon Sırasında Girişimcileri En Çok Nerede Takılıyor?
Kendi başına PayTR veya Shopier entegrasyonu deneyen çoğu geliştirici, aynı üç noktada tıkanıyor. İlki, ödeme bildirim URL'sinin (callback/notification) doğru yapılandırılmaması: sanal POS ödemeyi onaylıyor ama siteniz bu bilgiyi doğru şekilde işleyemiyor ve sipariş "beklemede" kalıyor. İkincisi, imza (hash) doğrulamasının atlanması — bu da güvenlik açığına yol açıyor, çünkü kötü niyetli biri sahte bir "ödeme başarılı" isteği gönderip kod çalmaya çalışabilir.
Üçüncü ve en can sıkıcı sorun ise eşzamanlılık (concurrency): aynı anda iki müşteri aynı ürünü satın almaya çalıştığında, stoktaki tek kalan kod ikisine de gösterilebiliyor. Bu, doğru kilitleme mekanizması olmadan kartlı ödeme entegre edilen scriptlerde sıkça görülen bir hata.
- Callback URL'nin sunucu tarafında (server-to-server) çalıştığından emin olun, sadece tarayıcı yönlendirmesine güvenmeyin
- Her bildirimde imza/hash kontrolü zorunlu olsun, aksi halde işlem reddedilsin
- Stok kilidi, ödeme "başarılı" olarak işaretlenmeden önce değil, o an atomik şekilde uygulanmalı
- Test ortamında mutlaka başarısız ödeme, zaman aşımı ve iptal senaryolarını da deneyin — sadece başarılı senaryo yeterli değil
Pinova bu noktaların tamamını çekirdek mimarisinde çözmüş durumda; tedarikçi API'leri (Turkpin, Pinabi) ile ödeme onayı arasındaki senkronizasyon da aynı kilitleme mantığıyla çalışıyor, böylece "iki kişiye tek kod" hatası yapısal olarak önlenmiş oluyor.
Bir diğer nokta ise loglama. Elle kurulan entegrasyonlarda çoğu geliştirici, işlem geçmişini ayrıntılı kaydetmeyi es geçer — sonra bir müşteri "param gitti kod gelmedi" dediğinde, hangi adımda takıldığını bulmak saatler alabilir. Her bildirim isteğinin, her stok kilidinin ve her hata mesajının ayrı ayrı kaydedildiği bir sistem kurmak, hem destek yükünü azaltır hem de olası bir anlaşmazlıkta (chargeback itirazında) elinizde somut kanıt bulunmasını sağlar.
3D Secure Olmadan Kartlı Ödeme Almak Gerçekten Güvenli mi?
Bazı işletmeler, dönüşüm oranını artırmak için 3D Secure'suz (non-secure) ödeme akışını tercih ediyor — müşteri kart bilgisini girip tek tıkla ödüyor, ekstra SMS onayı yok. Bu kısa vadede satışı artırabilir, ama e-pin gibi anında teslimat yapan ve dolandırıcılık riski yüksek bir sektörde ciddi bir tuzak olabilir.
3D Secure'suz işlemlerde chargeback (ters ibraz) durumunda risk tamamen üye iş yerine, yani size kalır. Yani biri çalıntı bir kartla ödeme yapıp kodu aldıktan sonra kart sahibi itiraz ederse, hem parayı hem de teslim ettiğiniz kodun bedelini kaybedersiniz. 3D Secure'lu işlemlerde ise bu risk büyük ölçüde bankaya ve kart sahibinin onayına kayar.
- Yüksek tutarlı ürünlerde (örneğin toplu bayi bakiye yüklemesi) 3D Secure'u zorunlu tutmak mantıklıdır
- Düşük tutarlı, sık tekrarlanan işlemlerde (tekil oyun kodu gibi) riski azaltan ek katmanlar (IP/hız limiti, cihaz parmak izi) devreye sokulabilir
- Chargeback oranı belli bir eşiği geçtiğinde sanal POS sağlayıcısı hesabı askıya alabilir, bu yüzden risk yönetimi sadece güvenlik değil iş sürekliliği meselesidir
Pinova'da 3D Secure zorunluluğu ürün veya tutar bazında ayarlanabiliyor; yani düşük riskli ürünlerde hız, yüksek riskli işlemlerde güvenlik önceliklendirilebiliyor — tek bir kural tüm siteye dayatılmıyor.
Kartlı ödeme entegrasyonunu canlıya almadan önce mutlaka küçük tutarlı gerçek bir işlemle kendi kartınızla test edin — sadece test ortamı (sandbox) yeterli değildir, çünkü bazı bildirim gecikmeleri ve IP kısıtlamaları yalnızca canlı ortamda ortaya çıkar.
Ödeme Onaylandıktan Sonra Kod Gerçekten "Anında" Nasıl Teslim Ediliyor?
Kartlı ödemenin en cazip tarafı, bekletmeden teslimat vaadidir. Ama "anında teslimat" cümlesinin arkasında aslında birkaç adımlı bir zincir var: sanal POS ödemeyi onaylar, sisteminiz bu onayı bir bildirimle (webhook/callback) alır, siparişi "ödendi" olarak işaretler, stoktan uygun kodu seçip kilitler ve son olarak bu kodu müşteriye ekranda ve/veya e-posta ile gösterir. Bu zincirin her halkası saniyeler içinde, insan müdahalesi olmadan tamamlanmalıdır.
Bu noktada iki teslimat modeli birbirinden ayrılır:
- Statik stok modeli: Kodlar önceden yüklenmiştir, ödeme onaylanınca sıradaki kod anında verilir — en hızlı yöntem, ama stok bitince satış durur.
- API tabanlı canlı üretim modeli: Ödeme onaylanınca sistem, tedarikçi API'sine (örneğin Turkpin veya Pinabi) anlık istek atar ve kodu o an üretir/çeker — stok sınırı yoktur ama tedarikçi API'sinin yanıt hızına bağımlıdır.
Çoğu ciddi e-pin sitesi ikisini birlikte kullanır: hızlı hareket eden ürünlerde statik stok, nadir/özel ürünlerde API tabanlı üretim. Pinova'nın tedarikçi API entegrasyonu ve stok sistemi bu iki modeli aynı panelde, ürün bazında karma şekilde çalıştırabiliyor; yani hangi ürünün hangi yöntemle teslim edileceğine siz karar veriyorsunuz.
Teslimat zincirinin son halkası genellikle unutulur: bildirim. Kod üretildikten sonra müşteriye sadece ekranda göstermek yeterli değildir; e-posta ile de göndermek, müşterinin sayfayı kapatıp kodu kaybetmesi durumunda güvenlik ağı görevi görür. Aynı şekilde, panel tarafında satıcının da her satışı anlık bildirimle (site içi veya e-posta) görebilmesi, stok tükenmesi gibi durumları erken fark etmesini sağlar.
Komisyon, Chargeback ve Gizli Maliyetler: Kartlı Ödemenin Gerçek Bedeli Nedir?
Sanal POS sağlayıcısının reklamdaki "%1,99 komisyon" rakamı, işin sadece görünen kısmıdır. Gerçek maliyeti hesaplarken şu kalemleri de hesaba katmak gerekir: taksit komisyonları (varsa), chargeback başına kesilen ceza ücreti, para çekim (iade) süresindeki nakit akışı kaybı ve entegrasyonu elle kurup sürekli bakım yapan bir geliştiricinin zaman maliyeti.
Özellikle e-pin sektöründe chargeback oranı diğer sektörlere göre yapısal olarak daha yüksektir, çünkü dijital ürün "geri alınamaz" ve bu da bazı kötü niyetli kullanıcılar için cazip bir hedef haline gelir. Bu riski azaltmanın yolu tek bir önlemden değil, birden fazla katmanın bir arada çalışmasından geçer:
- Şüpheli işlem skorlaması yapan bir sanal POS seçmek
- Yüksek tutarlı siparişlerde ek doğrulama (3D Secure, telefon teyidi) istemek
- İşlem geçmişini ve chargeback oranını düzenli izlemek, ani artışları erken fark etmek
- Bayi/toptan müşterilerde site cüzdanı (ön yüklemeli bakiye) kullanarak kart işlemi sıklığını azaltmak
Pinova'nın çok seviyeli bayi sistemi ve site cüzdanı özelliği tam olarak bu son maddeyi çözüyor: sık alışveriş yapan bayiler bakiyelerini bir kez yükleyip sonraki alımlarında kart işlemine hiç gerek duymuyor, bu da hem komisyon yükünü hem de chargeback riskini önemli ölçüde azaltıyor.
Uzun vadede bakıldığında, kartlı ödeme entegrasyonunun kalitesi aslında sitenizin büyüme hızını doğrudan etkiler. Ödeme akışı ne kadar sorunsuz ve hızlıysa, terk edilen sepet oranı o kadar düşer; teslimat ne kadar güvenilirse, tekrar eden müşteri oranı o kadar yükselir. Bu yüzden entegrasyonu bir "kurulum görevi" değil, satış performansını doğrudan belirleyen bir altyapı kararı olarak ele almak gerekir.
Bu Entegrasyonu Sıfırdan mı Kuracaksınız, Yoksa Hazır Bir Altyapıyla mı Başlayacaksınız?
Pinova ile PayTR, Shopier ve havale ödemesi, otomatik teslimat ve tedarikçi API'leri tek panelde hazır geliyor; siz sadece kendi sunucunuza kurup marka bilgilerinizi giriyorsunuz.
E-pin scriptime kartlı ödeme eklemek için banka ile anlaşma yapmam gerekir mi?
Hayır. PayTR veya Shopier gibi sanal POS sağlayıcıları üzerinden, doğrudan bankayla üye iş yeri anlaşması yapmadan kartlı ödeme alabilirsiniz. Bu sağlayıcılar kendi banka altyapılarını komisyon karşılığında sizinle paylaşır.
PayTR ve Shopier'i aynı anda aktif edip müşteriye seçtirebilir miyim?
Evet, ikisini aynı anda tanımlayıp ödeme sayfasında müşteriye seçenek sunabilirsiniz. Pinova bu iki yöntemi ve havale seçeneğini aynı panelde birlikte yönetmenize izin verir.
3D Secure kapalıyken chargeback yaşarsam ne olur?
3D Secure'suz işlemlerde itiraz durumunda kanıt yükü ve mali risk büyük ölçüde size, yani üye iş yerine kalır. Bu yüzden yüksek tutarlı veya riskli görülen işlemlerde 3D Secure'u açık tutmak önerilir.
Ödeme onaylandıktan sonra kod teslimatı gerçekten kaç saniye sürer?
Statik stok kullanan ürünlerde teslimat genellikle birkaç saniye içinde tamamlanır. Tedarikçi API'sinden anlık üretilen ürünlerde ise süre, o API'nin yanıt hızına bağlı olarak birkaç saniyeyle bir dakika arasında değişebilir.