Yükleniyor...
Contact Us
For quotes and information
PayTR sanal POS başvurusu ve ikas entegrasyonu adım adım nasıl yapılır, canlı moda nasıl geçilir? Evraklar, Direkt API yetkisi, merchant id/key/salt'ı ikas'a girme, test kartıyla test siparişi, Canlı Mod sihirbazı (Entegrasyon/Test/Bildirim/Kimlik Doğrulama) ve test modunu kapatma.
Kısa cevap: PayTR sanal POS'unu ikas'a bağlayıp canlı moda geçmek 9 adımda tamamlanır. Adımları sırayla uygulayın ve tamamladıkça işaretleyerek kontrol listesi gibi kullanın. Sıralama önemlidir: bilgileri ikas'a Direkt API yetkisi aktif olmadan girerseniz kaydederken hata alırsınız.
Bu rehber, ikas e-ticaret sitenize PayTR sanal POS'unu adım adım nasıl kurup canlı moda geçireceğinizi anlatır. Her adımı sırasıyla uygulayın; takıldığınız yerde ikas kurulum ekibimizden destek alabilirsiniz.
PayTR entegrasyonu, ikas mağazanızın PayTR sanal POS'una bağlanarak müşterilerden kredi/banka kartıyla ödeme almanızı sağlayan kurulumdur. İkas'ta ürününüzü satışa açsanız bile, kart tahsilatı yapabilmek için bir ödeme altyapısı (sanal POS) bağlamanız gerekir. PayTR, Türkiye'de yaygın kullanılan ödeme sağlayıcılarından biridir ve ikas ile hazır entegrasyonu vardır.
Başlamadan önce hangi altyapının size uygun olduğunu ve komisyon farklarını değerlendirmek isterseniz ikas ödeme altyapısı karşılaştırması ve ödeme altyapısı komisyon oranları yazılarımıza göz atabilirsiniz.
PayTR–ikas kurulumunda adımların sırası kritiktir; yanlış sırada ilerlerseniz "kaydet" aşamasında hata alırsınız. Özetle akış şudur: önce PayTR'de Direkt API yetkisini açtırırsınız, PayTR'den "yetkiniz aktif edildi" yanıtı gelir, ancak ondan sonra entegrasyon bilgilerini ikas'a girersiniz. Aksi hâlde ikas ödeme yöntemini kaydederken PayTR tarafında Direkt API URL'i tanımlı olmadığı için hata oluşur.
Kurulumun tamamı şu sırayla ilerler:
İlk adım PayTR'ye üye iş yeri başvurusu yapmaktır. Başvuru sonrası PayTR müşteri hizmetleri size e-posta veya telefonla dönüş yapar.
PayTR başvurusu için gerekli evraklar:
| Belge | Açıklama |
|---|---|
| İmza sirküleri | Şirket yetkilisine ait güncel imza sirküleri |
| Kimlik (ön/arka) | Yetkilinin kimlik belgesinin ön ve arka yüzü |
| Vergi levhası | Güncel vergi levhası |
| IBAN bilgisi | Tahsilatın yapılacağı şirket IBAN'ı |
| IBAN'ı gösterir belge | Şirket adına olmalı. Örneğin ilgili şirket hesabından başka bir hesaba yaptığınız bir dekont da IBAN'ı gösterir belge olarak yüklenebilir. |
Evraklar onaya düşer. Başvurunuz kabul edilirse onaylandığına dair bir bildirim gelir; bu bildirimde mağaza numaranız, e-posta adresiniz ve geçici şifreniz yer alır.
Onay bildirimindeki bilgilerle PayTR mağaza panelinize giriş yapın ve entegrasyon için gereken anahtarları alın.
| PayTR'deki alan | Teknik karşılığı |
|---|---|
| Mağaza No | merchant_id |
| Mağaza Parola | merchant_key |
| Mağaza Gizli Anahtar | merchant_salt |
Önemli: Bu bilgileri şimdilik yalnızca not edin; ikas'a girmeyi Adım 4'e bırakın. Çünkü bilgileri ikas'a girip kaydedebilmeniz için önce Direkt API yetkinizin (Adım 3) aktif olması gerekir. Mağaza Gizli Anahtar (merchant_salt) gizli bilgidir; kimseyle paylaşmayın ve güvenli saklayın.
PayTR paneline girer girmez yapmanız gereken ilk iş, Direkt API yetkinizi açtırmaktır. PayTR hesabı varsayılan olarak iFrame ödeme yöntemiyle gelir; ikas entegrasyonu Direkt API üzerinden çalıştığı için bu yetkinin PayTR ekibince aktifleştirilmesi gerekir.
Merhabalar, Direkt API yetkimizi aktif eder misiniz?
Önemli: PayTR ekibinden "Direkt API yetkiniz aktif edildi" yanıtı gelmeden ikas'a bilgi girmeyin; girerseniz kaydetme aşamasında hata alırsınız. Bu talebi panele girer girmez oluşturun ve onayı bekleyin; onay geldikten sonra Adım 4'e geçin.
Not — iFrame mi, Direkt API mı? PayTR iki entegrasyon modeliyle çalışır: iFrame ödeme (varsayılan) — kart bilgileri PayTR'nin güvenli iframe penceresinde girilir, PCI/güvenlik yükü PayTR tarafındadır; Direkt API — ödeme, mağazanın kendi sayfasında (ikas ödeme adımında) tamamlanır ve veriler sunucudan sunucuya PayTR'ye iletilir. ikas kendi ödeme ekranını kullandığı için Direkt API gerekir; bu yüzden hesabınıza bu yetkinin eklenmesi şarttır.
Bu adıma yalnızca PayTR'den "Direkt API yetkiniz aktif edildi" yanıtı geldikten sonra geçin. Yetki aktifse PayTR anahtarlarını ikas paneline girip ödeme yöntemini eklersiniz.
Kaydederken hata mı aldınız? Bu, PayTR Direkt API URL'inizin henüz aktifleşmemiş olduğunun işaretidir. Adım 3'teki Direkt API talebini tekrar oluşturun, PayTR ekibinden yetkinizin aktif olduğunu teyit alın, ardından tekrar kaydedin.
Entegrasyonun çalıştığını doğrulamak ve PayTR canlı mod sürecini başlatmak için sitenizden bir test siparişi geçin. Test modundaki bu sipariş gerçek tahsilat yapmaz.
| Alan | Test değeri |
|---|---|
| Ad Soyad | PAYTR TEST |
| Kart No | 4355 0843 5508 4358 |
| Son Kullanma | 12/30 |
| CVV | 000 |
Not: Bu kart yalnızca test içindir; gerçek para çekmez. Test modu açık olduğu sürece tüm ödemeler bu şekilde simüle edilir.
Bu adım opsiyoneldir ama dönüşüm oranınızı artırabilir. İkas'ın "Akıllı 3D Yönlendirme" özelliği, güvenilir bulunan ödeme işlemlerini 3DS doğrulamasına yönlendirmez; böylece ödeme adımındaki sürtünme azalır ve tamamlanan sipariş oranı artabilir. Bu özelliği açmak için PayTR tarafında non secure (3D'siz) ödeme yetkinizin aktifleştirilmesi gerekir.
Merhaba PayTR ekibi,
ikas e-ticaret sitemizde akıllı 3DS yönlendirme özelliğimizi açmak istiyoruz, bunun için non secure ödeme yetkimizin aktifleştirilmesini istiyoruz.
Teşekkürler.
Uyarı: Bu ayarı ikas panelinden açmadan önce mutlaka PayTR ekibinden bilgi alın ve non secure yetkinizin aktif olduğundan emin olun.
PayTR, canlı mod onayı için sitenizde belirli bilgi ve sözleşmelerin erişilebilir olmasını ister. Ayrıca varsa test/demo amaçlı ürün, kategori ve içerikleri kaldırın.
Bu sözleşmeler eksikse ya da güncel mevzuata uygun değilse canlı mod talebiniz onaylanmayabilir. Mesafeli satış sözleşmesi, gizlilik/KVKK aydınlatma metni, iade-iptal ve teslimat koşullarını eksiksiz ve güncel mevzuata uygun hazırlamanız gerekir. Bu sözleşmeleri tek tıkla, eksiksiz ve güncel mevzuata uygun üretmek için SözleşmeGO'yu kullanabilirsiniz.
Test siparişiniz başarılıysa PayTR panelinde canlı mod sürecini başlatabilirsiniz. Sipariş tamamlandıktan sonra PayTR panelinde üstte şu uyarı görünür: "DİKKAT Mağazanız test modundadır. Entegrasyon, test ve kimlik doğrulama işlemini tamamladıysanız Canlı Mod bölümünden süreci tamamlayarak talep gönderin." Buradaki Canlı Mod bağlantısına tıklayın.
Canlı Mod sihirbazı dört aşamayı otomatik kontrol eder; her aşama birkaç dakika sürebilir, bu sırada sayfayı terk etmeyin:
| Aşama | Ne kontrol edilir |
|---|---|
| 1. Entegrasyon Süreci | PayTR–ikas entegrasyonunun kurulu olduğu doğrulanır. |
| 2. Test İşlem Süreci | Geçtiğiniz test siparişi kontrol edilir ("Test İşlemi Başarılı, Yönlendiriliyorsunuz"). |
| 3. Bildirim Süreci | Test işleminin bildirim (callback) durumu kontrol edilir ("Bildirim Süreci Başarılı, Yönlendiriliyorsunuz"). |
| 4. Kimlik Doğrulama Süreci | Güvenli kimlik doğrulama tamamlanır ("Kimlik Doğrulama Süreci Tamamlandı"). |
Dört aşama da yeşil (tamamlandı) olduğunda "Canlı Moda Geçmeye Hazırsınız" ekranı gelir. Son kontrollerinizi yaptıysanız Canlı Moda Geç butonuna tıklayın. Talebiniz PayTR'ye iletilir; "Mağazanızı test modundan çıkararak canlı moda aldınız" bildirimini görürsünüz ve bundan sonra PayTR tarafından onay beklersiniz. Süreçle ilgili ek sorular olursa PayTR, Destek bölümünden veya e-posta bildirimleriyle size döner.
PayTR canlı mod onayından sonra ikas'a dönüp PayTR ödeme yönteminde Test Modu'nu kapatın. Test modu açık kaldığı sürece siteniz gerçek tahsilat yapmaz; müşteri ödemeleri yalnızca test modu kapalıyken ve PayTR canlı moddayken gerçekleşir. Bu adımı atlarsanız, çalışıyor görünen ama aslında test modunda takılı kaldığı için gerçek ödeme alamayan bir mağazayla karşılaşırsınız.
| Sorun | Olası neden / çözüm |
|---|---|
| ikas'ta bilgileri kaydederken hata | Direkt API yetkiniz henüz aktif değil. Adım 3'teki talebi tekrarlayın, "aktif edildi" yanıtını alın, sonra kaydedin. |
| Test siparişi canlı mod adımında görünmüyor | Test modunun ikas'ta açık olduğundan ve test kartıyla ödemeyi tamamladığınızdan emin olun; birkaç dakika bekleyip sayfayı yenileyin. |
| 3D ekranında ilerleyemiyorum | Şifre alanına paytr yazıp devam edin (test modu doğrulaması). |
| Canlı mod talebi onaylanmadı | Sitenizde sözleşmeler, iletişim veya iade koşulları eksik olabilir; yukarıdaki listeyi tamamlayın. |
| Canlı moda geçtim ama ödeme alamıyorum | ikas'ta test modunu kapatmayı unutmuş olabilirsiniz (Son Adım). |
PayTR başvurusu, evrak süreci, ikas entegrasyonu, test siparişi ve canlı moda geçişte zaman kaybetmek istemiyorsanız kurulumu uçtan uca biz yapalım. İkas çözüm ortağı olarak mağaza kurulumu, ödeme ve kargo entegrasyonları ile canlı moda geçişi tamamlıyoruz. Kayseri ve çevresindeki işletmeler dahil Türkiye genelinde uzaktan da destek veriyoruz. Kurulum ve büyütme için ücretsiz ön analiz talebi oluşturabilir veya ikas kurulum hizmetimizi inceleyebilirsiniz.
