Ticimax PayTR Kurulumu ve Sık Hatalar

Son güncelleme: 30 Ekim 2026. Bu sayfa yalnız PayTR içindir: Ticimax panelinde Mağaza No, Key ve Salt karşılığının nereye yazılacağı, bildirim adresinin neden boş veya yanlış kaldığı, test ile canlı modun karışması, tahsilat PayTR’de görünüp siparişte ödenmiş durmaması, taksit listesi ve 3D Secure kutusu. Banka POS’u ile ödeme kuruluşunu ayıran genel sıra sanal POS kurulumu ve hataları rehberindedir. Hangi adın dokümanda geçtiği hangi sanal POS rehberindedir. Kurulum bittikten sonra gelen kart reddi ödeme hataları rehberindedir. Bu sayfa o üç metni tekrar etmez.

Burak Oğuz, 10 yıl boyunca Ticimax Destek Departmanı Yöneticisi olarak çalıştı. Aşağıdaki menü adları, 30 Ekim 2026’da açık duran Ticimax ödeme servis kurulumu sayfasından ve PayTR’nin Direkt API entegrasyon süreci ile bildirim URL sayfalarından okunmuştur. Ekranda aynı yazı yoksa sürüm farkıdır. Olmayan kutuyu açmayın. Bu sayfa resmi destek hattı değildir. İş birliği sayfasındaki kampanya ve oran cümleleri buraya kopyalanmaz. Komisyon, aidat ve valör sözleşmededir.

İki PayTR ekranı

Ticimax’in aynı destek sayfası PayTR’yi iki yerde anlatır. Birincisi Ayarlar, Genel Ayarlar, Ödeme Yöntemleri’dir. Sayfa, PayTR’yi bu alandan kurarsanız taksitin önce PayTR tarafında girileceğini, Ticimax alanına token yazılacağını ve ödeme adımında PayTR’nin kendi sayfasının geleceğini yazar. İkincisi Ayarlar, Ödeme Servis Kurulumu’dur. Sayfa, API kullanacaksanız işlemin bu ekrandan yapılacağını yazar. Servis listesinden PayTR seçilince API bilgilerinin yazılacağı alanlar açılır.

İki ekrana birden, birbirinden kopyalanmış değer yapıştırmayın. Token, merchant_key değildir. Ödeme yöntemlerindeki token alanına salt yapıştırmak, servis ekranındaki key alanına da token yapıştırmak aynı kurulum değildir. Hangi yolu açtığınızı kurulum notuna tek satır yazın: “PayTR kendi sayfası” veya “ödeme servisi API”.

Aynı destek sayfası, kredi kartı ödeme parametresinin aktif edilmesini de yazar. O anahtarın banka POS’uyla ilişkisi sanal POS rehberindedir. PayTR alanları dolu, vitrinde kart yoksa önce parametreye bakın.

Mağaza No, Key ve Salt

PayTR’nin Direkt API sayfası, entegrasyonda üç değer ister ve menüyü PayTR Mağaza Paneli, Destek ve Kurulum, Entegrasyon Bilgileri diye yazar. Ticimax destek sayfası aynı bilgileri PayTR Mağaza Paneli, Bilgi, API Entegrasyon Bilgileri altında aratır ve mağaza numarası, merchant_key, merchant_salt diye not ettirir. 30 Ekim 2026’da iki menü adı da kamu sayfasındadır. Sizde hangi başlık duruyorsa ordan kopyalayın. Üçüncü bir panel uydurmayın.

Bu rehberdeki ad	PayTR’nin yazdığı ad	Kod
Mağaza No	Mağaza No	merchant_id
Key	Mağaza Parola	merchant_key
Salt	Mağaza Gizli Anahtar	merchant_salt

Ticimax tarafında yol, Ayarlar, Ödeme Servis Kurulumu’dur. Servis olarak PayTR seçilir. Anlaşmada olan bankalar ve açık olacak taksitler aynı ekranda belirtilir. Sayfa, alanların adını “gerekli API bilgileri” diye bırakır. Etiket sizde Mağaza Parola veya merchant_key ise key oraya gider. Mağaza Gizli Anahtar veya merchant_salt ise salt oraya gider. Etiket bu kelimelerden biri değilse üç değeri yer değiştirmeyin. PayTR ekranındaki sırayı, Ticimax’te açılan sırayla yan yana okuyun. Boşluk ve satır sonu yapıştırmayın. Başka mağazanın üçlüsünü bu mağazaya koymayın.

Mağaza paneline girerken kullandığınız üye şifresi bu üç değerden biri değildir. İlk yazışmada üç değeri de göndermeyin. Mağaza adresi ve “PayTR, ödeme servisi” cümlesi yeter.

Bildirim adresi

Ticimax sayfasının PayTR notu, bildirimin PayTR Mağaza Paneli, Ayarlar, Bildirim URL Ayarı bölümünden ekleneceğini yazar. Ticimax panelinde size özel üretilen bildirim adresini seçersiniz. Protokol, sitede SSL varsa HTTPS, yoksa HTTP olur. Numaralı liste aynı işi şöyle yazar: değiştir düğmesine basılır, Ticimax düğmesiyle adres eklenir, protokol siteye göre seçilir.

PayTR’nin kendi bildirim sayfası menüyü Mağaza Paneli, Destek ve Kurulum, Ayarlar, Bildirim URL Ayarları diye yazar. SSL varsa protokol HTTPS olmalıdır. SSL yokken HTTPS’li adres kullanılmaz. Entegrasyondan sonra SSL kurulduysa aynı ayara dönüp protokol HTTPS yapılır. SSL sonradan kaldırıldıysa protokol HTTP’ye çekilir. Ticimax’teki “Ticimax” düğmesinin ürettiği adres ile bu protokol aynı kayıttır. Başka ödeme kuruluşunun bildirim yolunu buraya yazmayın. Adresi elle, eski alan adıyla veya deneme alan adıyla tamamlamayın.

Esas adresin www’li mi www’süz mü olduğu alan adı ve SSL rehberindedir. Bildirim satırındaki host, müşterinin açtığı host olmalıdır. Bu sayfa DNS kaydını tekrar etmez. Sertifika uyarısı varken yeni bir 3D denemesi de açmayın. Uyarının kendisi o rehberdedir.

PayTR, bildirim adresinin müşterinin gördüğü sayfa olmadığını ve üye girişi duvarının arkasına konmaması gerektiğini yazar. Düz yazı OK yanıtı, özel yazılım anlatımıdır. Ticimax kurulumunda o yanıtı tema dosyasına siz yazmazsınız. Adresi düğmeyle ekleyip işlem listesine bakarsınız. Örnek kodu panele yapıştırmayın.

Test modu ve canlı mod

30 Ekim 2026’da aynı Ticimax sayfasında iki test cümlesi durur. Üstteki PayTR notu, test için PayTR’nin test kartı bilgilerinin kullanılabileceğini yazar. Alttaki numaralı liste, test kartına gerek olmadığını ve iFrame’de kart bilgisinin gömülü geldiğini yazar. Denemede PayTR’nin kendi sayfası açılıyorsa gömülü kart cümlesi o ekrana uyar. Açılmıyorsa test kartı cümlesine bakın. Bu rehber kart numarası yazmaz. Kart numarasını destek kaydına da koymayın.

Sonuç PayTR panelinden okunur. Ticimax sayfası Satışlar bölümünde “Ödeme Başarılı” ifadesini aratır. “Devam Ediyor” görürseniz detaya girip bildirim hatasını PayTR desteğe iletmenizi söyler. PayTR’nin kendi sayfası aynı ayrımı İşlemler’de “Başarılı” ve “Devam Ediyor” diye yazar. Detay, bildirim adresinden dönen yanıtı gösterir. Ekrandaki başlığı yazın.

Test sorunsuz bitmeden canlı talebi gitmez. Ticimax sayfası talebin yerini PayTR Mağaza Paneli, Destek diye yazar ve cümleyi aynen verir: “Canlı moda geçmek istiyorum.” Testte geçen işlem, bu talep gönderilmeden canlı tahsilat sayılmaz. PayTR, bildirimdeki test_mode alanının mağaza testteyken veya canlıdayken yapılan test işlemde 1 gönderildiğini yazar. 1 gördüğünüz satırı müşteri siparişi sanmayın.

PayTR’de var, siparişte ödenmiş yok

Bu belirti tek başına “POS bozuk” değildir. Önce PayTR’deki durum kelimesini okuyun. Devam Ediyor ise PayTR, bildirim adresinden OK almadığını yazar. Açılış cümlesi, bildirim tamamlanmazsa ödeme işleminin tamamlanmayacağını ve tarafa aktarılmayacağını söyler. Ticimax cümlesi de aynı kapıya çıkar: bildirim URL’si doğru tanımlanmadığında ödemeler sisteminize düşmeyebilir. Müşteri 3D ekranında onayladım diyorsa bile siparişi elle ödendi işaretlemeden Detay’daki yanıtı kaydedin.

Adres http kalmış ve site https açılıyorsa, SSL yokken https yazılmışsa, adres başka mağazadan kopyalandıysa veya host müşterinin açtığı ad değilse önce onu düzeltin. Taksit ve 3D kutusuna ondan sonra bakın.

PayTR’de Ödeme Başarılı veya Başarılı yazıyor, Ticimax siparişi tahsilatsız duruyorsa iki ekranın sipariş numarasını yan yana koyun. Numara tutmuyorsa başka bir denemeye bakıyorsunuz. Günlük kart reddi, limit ve tek müşteri sorunu bu sayfanın konusu değildir. O ayrım ödeme hataları rehberindedir. Sepet ödeme adımını hiç açmıyorsa sepetten ödeme adımı rehberi açılır.

test_mode 1 olan satır canlı satış değildir. İade süresi bu rehberde yoktur.

Taksit

Ödeme servisi ekranındaki Taksitler alanı, virgül veya Enter ile birden fazla sayı alır. Sayfanın örneği 2, 3, 4, 5, 6’dır. Aynı örnek, tek çekimin ayrı bir bankadan, taksitin PayTR’den gidebileceğini göstermek için Garanti adını kullanır. Bu, her mağazanın tek çekimini o bankaya bağlaması değildir. Yalnız PayTR kullanıyorsanız servis PayTR kalır. Anlaşmaya girmeyen bankayı doldurmayın.

Aynı sayfanın hatırlatması açıktır: taksit seçeneğinin görünmesi için tanım hem Ticimax panelinde hem ödeme sağlayıcıda olmalıdır. Ödeme yöntemleri yolunda sayfa, taksiti önce PayTR’de girmenizi ve token sayesinde listenin çekileceğini yazar. API yolunda taksit, ödeme servisi ekranına yazılır. Token yolunun listesini API ekranına elle, token yoluna da 2, 3, 4, 5, 6 dizisini ikinci kez, birbirini ezerek yazmayın.

PayTR hata tablosunda kod 8, “Bu karta taksit yapılamamaktadır.” Kod 9, “Bu kart ile işlem yetkisi bulunmamaktadır.” Kod 8 tek kartta çıkıyor, tek çekim aynı kartta geçiyorsa paneldeki bütün taksitleri silmeyin. O kartın taksit yetkisi yoktur. Bütün kartlarda hiç taksit yoksa önce PayTR tarafındaki taksit tanımına, sonra Ticimax’teki Taksitler alanına bakın. Sözleşmede açılmayan sayı bu rehberde vaat edilmez.

3D Secure

Ödeme servisi ekranında iki kutu vardır: 3D Aktif ve 3D Zorunlu. Sayfa, birincisini 3D Secure’u açmak, ikincisini zorunlu kılmak için yazar. İkisini de, ne işe yaradığını yazmadan kapatmayın. Kapalı kutu, hatayı “kart geçmiyor” cümlesine çevirir.

PayTR’nin bildirim hata tablosu mağaza tarafına şunları bırakır. Kod 10: “Bu işlemde 3D Secure kullanılmalıdır.” Kod 1: kimlik doğrulama yapılmadı, müşteri cep adımını bırakmıştır. Kod 2: kimlik doğrulama başarısız, şifre yanlış girilmiştir. Kod 6: müşteri ödeme sayfasından ayrılmıştır. Kod 0’ın örneği kart limiti veya bakiyedir. Kod 0 ve tek müşteri, ödeme hataları rehberine gider. Kod 10 görüyorsanız 3D Aktif ve 3D Zorunlu kutularına bakın. Kodu 1 veya 2 olan tek deneme için kutuyu kapatmayın.

Adres http ile https arasında kaldıysa önce protokolü düzeltin. PayTR hash kontrolünü kendi yazdığınız bildirim sayfası için ister. Hazır Ticimax bağında örnek koddaki merchant_key satırını temaya yapıştırmayın.

Aynı gün kontrol

1. Yol tek: ödeme yöntemleri ve token, ya da ödeme servisi ve API.
2. API yolunda Mağaza No, merchant_key ve merchant_salt yer değiştirilmeden duruyor.
3. Token yolu seçildiyse token key yerine konmamış.
4. Bildirim adresi Ticimax düğmesiyle eklenmiş. SSL varsa HTTPS, yoksa HTTP.
5. Devam Ediyor ise Detay’daki yanıt duruyor. Başarılı görünmeden canlı talep yok.
6. Canlı talep cümlesi “Canlı moda geçmek istiyorum.” Test_mode 1 canlı satış değildir.
7. Taksit iki tarafta da var. Kod 8 tek kart mı, bütün kartlar mı ayrılmış.
8. 3D Aktif ve 3D Zorunlu, kod 10 ile okunmuş. Kod 1 ve 2 için kutu kapatılmamış.

Birlikte bakılacak kayıt

Sekiz satır tutuyorsa tahsilatı kendi ekibiniz izleyebilir. Bildirim Detay’da OK yok, iki ekrandan biri eski değerle dolu veya canlı talep test satırının üstüne yazılmışsa kapsam Ticimax danışmanlığı içinde ayrılır. Kimin bakacağı Ticimax uzmanı sayfasındadır. Mağaza satışa hazırlanırken PayTR de bağlanacaksa iş Ticimax kurulum hizmetine yazılır. Kuruluş hesabı onaylanmadan canlı tahsilat testi yok. Bu sınır sanal POS rehberindedir.

İlk not için iletişim formu yeter. WhatsApp hattına da dört bilgi yazılır: mağaza adresi, ödeme yöntemleri mi ödeme servisi mi, PayTR’de gördüğünüz durum kelimesi ve bildirim protokolünün http mi https mi olduğu. İlk mesajda Mağaza No, merchant_key, merchant_salt, token, panel şifresi veya kart numarası göndermeyin.