PayTR Entegrasyonu Nasıl Yapılır?

Dijital dünyada ticaret yaparken en kritik nokta, müşterilerinize güvenli ve hızlı bir ödeme deneyimi sunmaktır. Türkiye’nin önde gelen ödeme kuruluşlarından biri olan PayTR, sunduğu sanal POS çözümleriyle işletmelerin işini kolaylaştırıyor. Peki, web sitenize PayTR entegrasyonu nasıl yapılır? İşte merak edilenler:

1.Hazırlık Süreci: PayTR Başvurusu

Entegrasyona başlamadan önce, şirketinizin PayTR tarafından onaylanmış bir sanal POS hesabına sahip olması gerekir. PayTR web sitesi üzerinden başvuru formunu doldurup gerekli evrakları ileterek süreci başlatabilirsiniz. Başvurunuz onaylandığında size özel bir Mağaza Paneli erişimi tanımlanacaktır.

2. API Bilgilerinin Alınması

PayTR panelinize giriş yaptıktan sonra entegrasyon için ihtiyaç duyacağınız 3 temel anahtara ulaşmanız gerekir:

• Mağaza No (Merchant ID): Mağazanızı tanımlayan benzersiz numara.
• Mağaza Parola (Merchant Key): API haberleşmesinde kullanılan anahtar.
• Mağaza Gizli Anahtar (Merchant Salt): Güvenlik için kullanılan özel değer.

Bu bilgileri, panelinizdeki “Destek & Kurulum > Entegrasyon Bilgileri” sekmesinden bulabilirsiniz.

3. Teknik Entegrasyon Adımları (iFrame Yöntemi)

PayTR, en güvenli ve yaygın kullanılan iFrame API yöntemini önerir. Bu yöntemde ödeme formunu kendi sitenizde barındırmanıza gerek kalmaz; ödeme ekranı PayTR sunucuları üzerinden güvenli bir çerçeve (iFrame) ile sitenize yüklenir.

• Adım 1: Sitenizden PayTR sunucularına bir POST isteği göndererek ödeme için gerekli olan token verisini alın.
• Adım 2: Aldığınız bu token ile oluşturulan iFrame kodunu ödeme sayfanızda ilgili alana yerleştirin.
• Adım 3 (Bildirim URL): PayTR’ın ödeme sonuçlarını (başarılı/başarısız) sitenize iletebilmesi için bir Bildirim URL (Callback URL) oluşturmanız şarttır. Bu URL, ödeme sonrasında PayTR’dan gelen veriyi alıp veritabanınızda sipariş durumunu güncelleyen bir script olmalıdır.

4. Test ve Canlı Mod

Doğrudan canlı ödeme almadan önce mutlaka “Test Modu“nu kullanın.

Test işlemleriniz sorunsuz tamamlandığında, canlı moda geçmek için yine aynı panel üzerinden bildirimde bulunun.

PayTR panelinden “Test Modu”nu aktifleştirin.

Sitenizden deneme kart bilgileriyle gerçek para çekilmeden bir ödeme simülasyonu yapın.

Siparişin veritabanına “Başarılı” olarak kaydedildiğinden emin olun.

5. Profesyonel Destek ile Güvenli Entegrasyon

PayTR entegrasyonu, temel aşamalarıyla standart görünse de, sitenizin altyapısına uygun yapılandırılması (token hatalarının giderilmesi, taksit parametrelerinin doğru işlenmesi veya hata dönüşlerinin yönetilmesi) ciddi bir teknik titizlik gerektirir.

Yanlış yapılan bir entegrasyon, ödemelerin tahsil edilememesine veya sipariş onay mekanizmalarının bozulmasına yol açabilir. Webinok Dijital E-Ticaret Çözümleri olarak, işletmenizin ödeme sistemlerini uçtan uca yönetiyor; sanal POS kurulumundan, API hata giderme süreçlerine ve ödeme sayfası optimizasyonuna kadar ihtiyacınız olan tüm teknik desteği sağlıyoruz.

6. Düzenli Bakım ve Hata İzleme

E-ticaret sitenizi profesyonel bir altyapıyla güçlendirmek ve ödeme süreçlerinizi sorunsuz hale getirmek için Webinok uzmanlığıyla tanışabilir, işletmeniz için en hızlı ve güvenli çözüm süreçlerini başlatabilirsiniz.

Entegrasyon sadece bir kurulum aşaması değildir; sitenizin canlı yayında olduğu süre boyunca ödeme trafiğinin kesintisiz devam etmesi gerekir. API sürüm güncellemeleri, sunucu bazlı zaman aşımı (timeout) hataları veya PayTR tarafından iletilen hata kodları, ödeme sürecinizi anlık olarak etkileyebilir. Özellikle “token geçersizliği” veya “hatalı imza” gibi durumlarla karşılaşmamak için, arka planda log kayıtlarını tutan bir izleme mekanizmasının kurulması hayati önem taşır. Sisteminizi düzenli olarak test etmek ve olası teknik aksaklıklara karşı proaktif bir koruma sağlamak, dijital mağazanızın satış performansını korumanın tek yoludur.

7. Bildirim URL (Callback) Yapılandırması ve Güvenlik

Ödeme formunu başarıyla görüntülemek işin ilk adımıdır; ancak asıl önemli olan, PayTR sunucularının ödeme sonucunu sitenize başarılı bir şekilde iletmesidir. Buna Bildirim URL (Callback) süreci denir. Ödeme gerçekleştiğinde veya reddedildiğinde, PayTR sitenizdeki bu özel dosyaya arka planda bir POST isteği gönderir. Bu dosyayı yapılandırırken şu üç kuralı asla atlamamalısınız:

• İmza (Hash) Doğrulama: PayTR’dan gelen verinin gerçek olduğunu doğrulamak için, size özel Merchant Salt değerini kullanarak gelen verileri tekrar şifrelemeli ve PayTR’ın gönderdiği “imza” ile karşılaştırmalısınız. Bu kontrolü yapmadan veritabanında işlem onayı vermek, dışarıdan yapılabilecek sahte bildirim saldırılarına kapı aralar.
• Sipariş Durum Kontrolü: Bildirim dosyası tetiklendiğinde, siparişinizin durumunu güncellerken mutlaka “zaten onaylanmış mı?” kontrolünü yapmalısınız. Mükerrer (tekrar eden) bildirimlerin veritabanınızı veya stok takibinizi bozmasını bu şekilde engelleyebilirsiniz.
• Hızlı Yanıt: Bildirim URL dosyanız, PayTR sunucusundan gelen veriyi aldıktan sonra PayTR sistemine en kısa sürede “OK” yanıtını dönmelidir. Eğer dosyanız ağır bir işlem yapmaya çalışırsa (yavaş çalışan veritabanı sorguları gibi), PayTR isteği zaman aşımına uğratabilir ve ödemeyi almış olsanız dahi siparişinizi sistemde “bekliyor” olarak görebilirsiniz.

Not: Bu teknik süreçler, özellikle API hataları ile karşılaşıldığında (örneğin eksik parametre veya geçersiz token durumları) sitenizin ödeme almasını tamamen durdurabilir. Eğer bu süreçlerin kurulumunda veya hata loglarının yönetilmesinde bir zorluk yaşıyorsanız, Webinok Dijital E-Ticaret Çözümleri olarak teknik altyapınızı optimize etmek için buradayız.

8. Platform Bağımsız Entegrasyon Çözümleri

E-ticaret ekosisteminde her işletmenin teknik altyapısı farklılık gösterir. Bazı projeler WordPress ve WooCommerce gibi popüler içerik yönetim sistemleri üzerinde şekillenirken, bazıları Shopify gibi hazır altyapılarda veya tamamen özel yazılım (custom API) geliştirilmiş platformlarda hayat bulur.

Webinok Dijital E-Ticaret Çözümleri olarak, platform fark etmeksizin her türlü sisteme PayTR entegrasyonu sağlıyoruz:

WooCommerce ve WordPress: Eklenti tabanlı yapıların doğru konfigürasyonu ve tema ile uyumlu ödeme sayfası tasarımları.

Shopify: PayTR API bağlantılarının özel webhook yapılandırmaları ile mağazanıza entegre edilmesi.

Özel Yazılımlar (Custom API): Herhangi bir hazır sisteme bağlı kalmadan, doğrudan kendi kod tabanınız üzerine kurulan güvenli ve hızlı API entegrasyonları.

Hangi altyapıyı kullanırsanız kullanın, ödeme sisteminizin sitenizle “bir bütün” olarak çalışması için gerekli teknik tüm süreçleri yönetiyoruz. Teknolojik altyapınız ne olursa olsun, işletmeniz için en uyumlu ve performanslı ödeme çözümünü hayata geçirmek adına bizimle iletişime geçebilirsiniz.

9.PayTR Entegrasyonu Nasıl Yapılır ve Nelere Dikkat Edilmelidir?

“PayTR entegrasyonu nasıl yapılır?” sorusu, özellikle e-ticarete yeni başlayan işletmeler için oldukça karmaşık görünebilir. Bu süreçte en sık karşılaşılan durum, API bilgilerinin yanlış girilmesi veya test modundan canlı moda geçişin unutulmasıdır. Sürecin her adımında, PayTR panelinden alınan Mağaza No ve Gizli Anahtar gibi verilerin güvenli bir şekilde saklanması, hem teknik hataların önüne geçer hem de veri güvenliğinizi sağlar.

10. Ödeme Entegrasyonunda Hata Giderme ve Performans

Sıkça sorulanlar arasında yer alan bir diğer konu ise, ödeme ekranı açılmadığında veya hata verdiğinde ne yapılması gerektiğidir. Eğer ödeme formunuz yüklenmiyorsa, genellikle bir “token” üretimi hatası veya sunucu tarafında bir güvenlik kısıtlaması yaşanıyordur. “PayTR entegrasyonu nasıl yapılır” diye araştırırken, mutlaka log kayıtlarını incelemeyi öğrenmelisiniz. Webinok Dijital E-Ticaret Çözümleri olarak, API hata kodlarını analiz ederek sitenizde ödeme akışının kesintisiz sürmesini sağlıyoruz.

11. PayTR ile Güvenli Satışın Temelleri

Son olarak, işletme sahipleri sıklıkla “Sadece PayTR entegrasyonu yapmak satışlarımı artırır mı?” diye soruyor. Doğru entegre edilmiş bir sistem, sadece ödeme almanızı sağlamaz; aynı zamanda iade süreçlerini, kısmi iadeleri ve taksitli satış yönetimini kolaylaştırarak müşteri memnuniyetini maksimuma çıkarır. “Profesyonel bir PayTR entegrasyonu nasıl yapılır?” sorusunun cevabı, aslında müşteriye güvenli bir ödeme alanı sunmaktan geçer. Biz, tüm platformlarda (WooCommerce, Shopify, Özel Yazılımlar) bu güveni teknik altyapınıza işliyoruz.

12. Ön Başvuru Formunu Doldurun

PayTR resmi web sitesindeki Hemen Başvur sayfasını ziyaret edin. Burada sizden istenen;

• Yetkili Adı – Soyadı
• E-posta adresi
• Web sitenizin adresi
• İletişim bilgileri gibi temel bilgileri girerek ön başvuru formunu gönderin. Formu doldurduğunuzda size bir Referans Numarası verilecektir; bu numara ile sürecinizi başvuru takip ekranından sorgulayabilirsiniz.

13. Değerlendirme ve Teklif

PayTR ekipleri, paylaştığınız bilgileri ve web sitenizi inceleyerek başvurunuzu değerlendirir. Başvurunuz olumlu sonuçlandığında, size özel çalışma koşulları ve komisyon oranlarını içeren bir teklif e-posta yoluyla iletilir.

14. Evrak Yükleme Süreci

Teklifi onayladıktan sonra, e-posta adresinize gönderilen özel linke tıklayarak gerekli belgeleri online sisteme yüklemeniz gerekir. Şirket türüne göre istenen belgeler genel olarak şöyledir:

• Şahıs İşletmeleri İçin:
  • Güncel Vergi Levhası
  • Kimlik görüntüsü
  • İmza beyannamesi
  • Banka hesap bilgilerini gösteren bir evrak (IBAN doğrulaması için)
• Limited ve Anonim Şirketler İçin:
  • Güncel Vergi Levhası
  • Ticaret Sicil Gazetesi
  • İmza sirküleri
  • Şirket ortaklarının kimlik görüntüleri
  • Banka hesap bilgilerini teyit eden evrak

15. Sözleşme ve Onay

Yüklediğiniz belgeler incelenip onaylandıktan sonra üye iş yeri sözleşmesi düzenlenir. Sözleşme onay aşamasından sonra dijital olarak veya gerekli görülen durumlarda fiziki olarak tamamlanır.

16. Entegrasyon ve Canlıya Geçiş

Sözleşme süreci bittiğinde, PayTR size Mağaza No (Merchant ID), Mağaza Parola (Merchant Key) ve Mağaza Gizli Anahtar (Merchant Salt) bilgilerini tanımlar. Bu bilgileri alarak;

• Web sitenizin altyapısına (WooCommerce, Shopify, Özel Yazılım vb.) uygun entegrasyonu yaparsınız.
• Test modunda ödeme simülasyonları gerçekleştirerek sistemin çalıştığını doğrularsınız.
• Her şey yolundaysa Canlı Modu aktif ederek gerçek ödeme almaya başlayabilirsiniz.