PayTR entegrasyonu: bilet ödemesini PayTR ile alın, sonucu sunucudan doğrulayın

PayTR, işletmelere sanal POS ve ödeme hizmetleri sunan bir ödeme ve elektronik para kuruluşudur. TCMB'nin yetkili elektronik para kuruluşları listesinde Paytr Ödeme ve Elektronik Para Kuruluşu A.Ş. unvanıyla yer alır. DIJI.TECH'in uçak bileti yazılımı PayTR'yi kart ödeme sağlayıcılarından biri olarak bilet satış akışına bağlar.

PayTR entegrasyonu nasıl çalışır?

PayTR entegrasyonunda kart bilgisi ödeme ekranında alınır, PayTR'ye iletilir ve müşteri 3D Secure doğrulaması için bankasının sayfasına yönlendirilir. Doğrulamadan sonra yazılım ödemenin sonucunu PayTR'ye durum sorgusu yaparak kesinleştirir; ödeme onaylanınca bilet kesme adımı başlar.

Bu yapıda ödeme sonucu iki yoldan gelir:

• Tarayıcı dönüşü: Müşteri doğrulamayı tamamladıktan sonra yazılımın sonuç sayfasına döner.
• PayTR bildirimi: PayTR, panelde tanımlı bildirim adresine sonucu ayrıca gönderir. Yazılım bu bildirimin imzasını doğrular.

Ödemenin kesin durumu, tarayıcı dönüşünde yazılımın PayTR'ye yaptığı durum sorgusuyla belirlenir; tarayıcıdan gelen bilgi tek başına ödeme kanıtı sayılmaz.

Kurulum adımları

PayTR kurulumu beş adımdan oluşur ve banka POS'larından farklı olarak PayTR panelinde bildirim URL'sinin ayarlanmasını içerir.

1. Acenteniz PayTR ile üye işyeri anlaşması yapar ve mağaza bilgilerini alır.
2. Mağaza numarası ve gizli anahtarlar yazılımın yönetim paneline girilir.
3. PayTR panelindeki Bildirim URL alanı, yazılımın PayTR bildirim adresine ayarlanır.
4. Test ortamında deneme ödemesi yapılır; sonuç hem tarayıcıda hem panelde kontrol edilir.
5. Hesap canlıya alınır.

Bildirim adresi ayarlanmazsa PayTR bildirimleri yazılıma ulaşmaz ve PayTR bildirimi tekrar göndermeye devam eder; kurulumu test ortamında tamamlamadan canlıya geçmemek gerekir.

Taksit: oranlar PayTR'den gelir

Kartın ilk 6 hanesi (BIN) yazıldığında yazılım PayTR'den o karta uygulanabilecek taksit oranlarını alır ve müşteriye toplam tutar ile aylık taksit olarak gösterir. Banka sanal POS'larında olduğu gibi acentenin taksit tablosu girmesi gerekmez; oranlar ödeme kuruluşunun kendi tarifesinden gelir.

PayTR bildirimine verilen cevap da önemlidir: PayTR, bildirimin alındığını gösteren onay cevabını bekler. Yazılım imzası doğrulanan bildirime bu cevabı otomatik verir; ödemenin kesin durumu ise tarayıcı dönüşünde yapılan durum sorgusuyla belirlenir. Bu sayede aynı ödeme için gelen tekrar bildirimleri işlem kaydını bozmaz.

PayTR hangi kanallarda kullanılır?

PayTR tanımı B2B acente portalında alt acentelerin kartlı ödemelerinde, B2C satış sitesinde son kullanıcı ödemelerinde ve panelden gönderilen ödeme linklerinde aynı hesapla kullanılır. Her kanal için ayrı PayTR bağlantısı kurmanız gerekmez; kanal bazında tahsilatın nasıl göründüğü şöyledir:

B2B portalda alt acenteler kartın yanında kredi limiti veya depozito bakiyesiyle de ödeme yapabilir; bu ödemeler PayTR'ye gitmez, finans ekranlarındaki hesap hareketleri olarak izlenir. Markup kurallarındaki satış kanalı kriteriyle her kanala farklı kâr uygulayabilirsiniz.

Sık yapılan kurulum hataları

PayTR kurulumunda üç adımın atlanması ödeme akışını bozar: bildirim URL'sinin ayarlanmaması, sağlayıcının test modunda bırakılması ve mağaza bilgilerinin PayTR panelindeki değerlerle eşleşmemesi. Bu üç kontrol test ödemesiyle doğrulanmadan hesap canlıya alınmamalıdır:

• Bildirim URL'sinin ayarlanmaması: PayTR bildirimleri yazılıma ulaşmaz ve PayTR bildirimi tekrar göndermeye devam eder.
• Test modunda kalınması: Canlı mağaza bilgileri girilse bile sağlayıcı test modunda bırakılırsa gerçek tahsilat yapılmaz.
• Gizli anahtarların karıştırılması: Mağaza numarası, anahtar ve gizli anahtar PayTR panelindeki değerlerle birebir eşleşmelidir.

Ödeme sonucu ve satış sonrası

Sonuç ekranında ödeme işleniyor, başarılı, başarısız, iade edildi veya zaman aşımı olarak gösterilir. Başarısız ödemeler yönetim panelindeki operasyon kuyruğunda toplanır. B2C sitesinde müşteri ödeme butonuna iki kez bassa bile çift çekim yapılmaz.

PayTR'yi tek başına veya banka sanal POS'larıyla birlikte kullanabilirsiniz; yazılımda birden fazla ödeme sağlayıcısı aktif olabilir ve biri varsayılan seçilir. Diğer ödeme kuruluşlarıyla karşılaştırma için sanal POS entegrasyonu sayfasına bakabilirsiniz.