Ticimax Sanal POS Kurulumu ve Hataları
14 Ekim 2026 · 7 dk · Burak Oğuz
Banka başvurusu ve panel ayarı
Sanal POS kurulumu iki kapıdan oluşur. Birincisi bankanın veya ödeme kuruluşunun mağazaya hesabı açmasıdır. İkincisi Ticimax panelinde o hesabın bilgilerinin doğru alana yazılmasıdır. Başvuru onaylanmadan panele anahtar yapıştırmak ödeme aldırmaz. Panel doldurulmadan onaylı hesap da tek başına satış açmaz.
Hangi kuruluşun kullanılacağı işletmenin sözleşmesidir. Bu rehber komisyon, valör veya limit söylemez. O rakamlar sözleşmededir ve mağazadan mağazaya değişir. Kurulumun işi, test işleminin başarılı ve başarısız senaryoda nerede göründüğünü netleştirmektir.
Menü adları sürüme göre değişir. Alan adını ezberlemek yerine elinizdeki kuruluş dokümanındaki alanla paneldeki alanı eşleyin. Eşleşmeyen bir alanı 'boş kalsın' diye uydurmayın. Boş bırakılan zorunlu alan, hatayı ödeme anına erteler.
Test modu ve canlı mod
Test ortamında başarılı olan işlem, canlı anahtarlarla tekrar denenmeden bitti sayılmaz. Test kartı canlıda çalışmaz. Canlı kart test ortamında da çalışmayabilir. Hangi modda olduğunuzu işlemden önce yazın. Modu işlem sırasında değiştirmek, yarıda kalan sipariş üretir.
Canlıya geçerken test siparişi küçük tutarın işletme kartıyla yapılır. Amaç ciro değildir. Amaç siparişin panelde doğru tutar, taksit ve durumla durması, başarısız denemede siparişin 'ödendi' görünmemesidir. Bu iki sonuç yan yana not edilir.
Eski kuruluşun anahtarları yeni kuruluşun alanına yapıştırılmış olabilir. Anahtar seti tek bir yerden, o kurulumun kendi dokümanından alınır. Bir önceki projeden kopyalanan değerler çoğu zaman sessizce reddedilir.
3D Secure ve dönüş adresi
3D Secure, kart sahibinin bankasına gidip geri dönmesidir. Dönüş adresi yanlışsa müşteri bankada onaylar, mağaza bunu göremez. Sipariş askıda kalır veya hiç oluşmaz. Dönüş adresinin sitede gerçekten açılan bir adres olması gerekir. Alan adı yeni bağlandıysa bu adres eski domaine gidiyor olabilir. Alan adı ve SSL rehberi bu yüzden ödeme işinden önce okunur.
SSL yokken veya tarayıcı sertifikaya güvenmezken 3D penceresi açılmayabilir. Müşteri bunu 'kartım geçmiyor' diye anlatır. Sertifika uyarısını kendi tarayıcınızda, üye olmadan deneyin. Uyarı sizde de varsa sorun kart limiti değildir.
Bazı kuruluşlar 3D olmadan da işlem dener. Bunu açmak işletmenin risk kararıdır. Rehber, 3D'yi kapatmanızı söylemez. Kapalıysa başarısız işlemlerin nedeni değişir; destek kaydına '3D açık mı' diye yazın.
Taksit, para birimi ve tutar
Taksit tablosu bankanın mağazaya açtığı taksitlerle sınırlıdır. Panelde 9 taksit yazmak, banka 3 taksit açtıysa 9 taksit aldırmaz. Taksit hatasında önce bankanın açtığı sayıyı sorun, sonra paneli ona çekin.
Sipariş para birimi ile POS'un beklediği para birimi farklıysa işlem reddedilir veya yanlış kurla gider. Mağaza TL ise POS'un da TL olduğundan emin olun. Çoklu para biriminde hangi POS'un hangi paraya baktığı yazılır. Yazılmazsa yabancı kart denemesi yerli işlemi de karıştırabilir.
Kargo ve kapıda ödeme seçiliyken sanal POS hatası aramak zaman kaybıdır. Ödeme yöntemi gerçekten kart mı, onu sipariş satırından okuyun. Yöntem karışması, ödeme hataları rehberindeki ayrımdır.
Hata mesajını sahiplenmek
Ekrandaki kodun bir kısmı bankadan, bir kısmı panelden gelir. Kodu olduğu gibi kuruluşa iletmeden önce test modunda mısınız, anahtar canlı mı, dönüş adresi bu domain mi, üçünü yazın. Bu üçü yanlışken kuruluşa giden kayıt, size 'bilgi hatalı' diye döner ve gün kaybedersiniz.
Müşterinin kart limiti, internet alışverişine kapalılığı veya 3D şifresini yanlış girmesi mağaza ayarı değildir. Aynı kartla ikinci bir küçük tutar, farklı bir kartla aynı sepet denenir. Yalnızca bir kart düşüyorsa mağazayı yeniden kurmayın.
Başarılı çekim olup sipariş oluşmuyorsa para iadesi kuruluşun ekranından kontrol edilir. Bu rehber iade süresi vaat etmez. İade, kuruluşun kendi kuralıdır. Panelde sipariş yok diye çekimin olmadığını varsaymayın.
Anahtar ve erişim
İlk yazışmada POS şifresi, mağaza anahtarı veya API gizli anahtarı göndermeyin. Kapsam netleşince işletmenin kendi paylaşım yöntemi kullanılır. Anahtarı e-postanın gövdesine yapıştırmak, kurulumun parçası değildir.
Kurulum bittikten sonra anahtarı değiştirirseniz paneli de güncellemeniz gerekir. Banka yeniledi, panel eski kaldıysa ertesi gün bütün ödemeler düşer. Değişiklik gününü not edin.
Sanal POS, site kurulum içinde ödeme adımı olarak konuşulur. Kuruluş onayı sizde değilse bu adım bekler. Beklerken ürün ve tema ilerleyebilir; canlı tahsilat testi ilerleyemez.
Kurulumu canlıya almadan önce
Canlı tahsilat, kurulumun ödeme adımıdır. Onay yoksa bu adım bekler, ürün girişi beklemeyebilir.
- Kuruluş onayı. Hesap onay yazısı yokken canlı anahtar aramayın.
- Alan eşlemesi. Dokümandaki alan ile paneldeki alan aynı işi görüyor mu, isme göre değil işe göre bakın.
- Test kartı. Test kartının yalnızca test modunda geçtiğini not edin.
- Canlı kart. Küçük tutarlı işletme kartıyla canlı çekim deneyin.
- Başarısız senaryo. Kartı bilerek yarıda kesin. Sipariş ödendi görünmemelidir.
- Dönüş adresi. Bankadan dönüş, esas domaine gelmelidir.
- SSL. Sertifika uyarısı varken 3D denemeyin.
- Taksit. Paneldeki taksit, bankanın açtığından fazla olmasın.
- Para birimi. Vitrin ile POS aynı para birimini konuşsun.
- Eski anahtar. Önceki projeden kopyalanan değerleri silin.
- Bildirim. Başarılı çekimde sipariş mektubu gidiyor mu bakın.
- Not. Anahtarı değiştirdiğiniz günü yazın. Ertesi gün toplu red, çoğu zaman eski anahtardır.
İade süresi kuruluşun kuralıdır. Bu liste gün vaat etmez.
Anahtar ilk e-postaya yazılmaz. İletişim için mağaza adresi ve kuruluş adı yeter.
Aynı gün içinde not
Kuruluş onayı. Hesap onay yazısı yokken canlı anahtar aramayın. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Alan eşlemesi. Dokümandaki alan ile paneldeki alan aynı işi görüyor mu, isme göre değil işe göre bakın. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Test kartı. Test kartının yalnızca test modunda geçtiğini not edin. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Canlı kart. Küçük tutarlı işletme kartıyla canlı çekim deneyin. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Başarısız senaryo. Kartı bilerek yarıda kesin. Sipariş ödendi görünmemelidir. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Dönüş adresi. Bankadan dönüş, esas domaine gelmelidir. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
SSL. Sertifika uyarısı varken 3D denemeyin. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Taksit. Paneldeki taksit, bankanın açtığından fazla olmasın. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Para birimi. Vitrin ile POS aynı para birimini konuşsun. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Eski anahtar. Önceki projeden kopyalanan değerleri silin. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Bildirim. Başarılı çekimde sipariş mektubu gidiyor mu bakın. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Not. Anahtarı değiştirdiğiniz günü yazın. Ertesi gün toplu red, çoğu zaman eski anahtardır. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.
Sık sorulan sorular
Test ödemesi geçti, canlıda geçmiyor. Ne bakılır?
Canlı anahtarların yapıştırıldığını, modun testten çıktığını ve dönüş adresinin canlı domaine gittiğini kontrol edin. Test kartı canlıda çalışmaz.
3D ekranı açılmadan hata veriyor.
Önce SSL uyarısı ve dönüş adresi kontrol edilir. Tek bir kartta oluyorsa kartın internet alışverişi veya 3D şifresi de ayrıca sorulur.
Taksit seçenekleri eksik.
Paneldeki liste, bankanın mağazaya açtığı taksitle sınırlıdır. Önce kuruluştan açılan taksit sayısını öğrenin.
POS şifresini forma yazar mıyım?
Hayır. İlk mesajda anahtar veya şifre göndermeyin. Mağaza adresi ve hangi kuruluşu kullandığınız yeter.
