E-ticarette “İşlem Başarısız” uyarısı en büyük kâbusun. Bu uyarı senin için basit bir teknik sorun değildir. Anlamı, kaybedilmiş bir satıştır. Müşterin içinse büyük bir hayal kırıklığıdır. Marka imajına doğrudan ve ciddi bir darbe vurur.
Müşterin sepetini doldurmuş ve satın alma kararını vermiştir. Ödeme anındaki bir engel tüm emeklerini boşa çıkarır. Bu durum müşterini hızla rakip bir siteye yönlendirir. Tekrarlayan bu ödeme hataları cironu doğrudan etkiler. Sepet terk etme oranını hızla yükseltir. Müşteri sadakatinde onarılması zor yaralar açar.
Bu rehberle ödeme süreçlerini tamamen kontrol altına alacaksın. Sana en kapsamlı ve güncel kaynağı sunacağız. Sanal POS hata kodları ve çözümleri hakkında her şeyi bulacaksın. Bu sayfalarda kafa karıştırıcı kodların şifresini çözeceksin. Her sorunun kökenine inecek, pratik çözümler bulacaksın. Böylece ödeme başarı oranını kalıcı olarak artıracaksın. Param, bu kritik süreçte her an senin yanında yer alır. Sorunsuz bir ödeme deneyimi yaratmana yardım eder.
Bu rehberle bakış açını tamamen değiştireceksin. Hata kodlarını artık bir son olarak görme. Onlar, ödeme altyapından gelen önemli sinyallerdir. Yetersiz bakiye uyarısı senin için yeni bir fırsattır. Belki de müşterine hemen taksit seçeneği sunmalısın. Tekrarlanan bir hata, bir iyileştirme fırsatını gösterir. Bu yaklaşımla hataları daha oluşmadan önleyeceksin. Müşteri deneyimini sürekli daha iyiye taşıyacaksın. Haydi, her işlemi bir başarı hikayesine dönüştür.
Sanal POS Hata Kodu Nedir?
Sanal POS hata kodunu, dijital bir haberci gibi düşün. Sana, ödeme işleminin neden o an onaylanmadığını fısıldar. Yani bu kodlar birer düşman değil, aslında birer ipucudur.
Peki bu haberci sana ne anlatmaya çalışır? Bir müşteri sitenden alışveriş yaptığında, ödeme talebi aslında bir yolculuğa çıkar. Bu yolculukta bir pürüz çıkarsa, hata kodu sana sorunun tam olarak nerede olduğunu gösterir. Tıpkı bir haritadaki “Şu an buradasın” işareti gibi, sorunun kaynağını bulmanı sağlar.
Sanal POS Nedir? Kullanım avantajları nelerdir, nasıl alınır gibi aklınıza takılan temel sorularınızın cevaplarını “Sanal Pos Nedir?” blog yazımızda bulabilirsiniz.
Hata Kaynakları: Sorun Kimde? Müşteri, Mağaza, Banka?
Bir hata kodu gördüğünde ilk tepkin muhtemelen endişelenmektir. “Acaba sorun benim sitemde mi?” diye düşünürsün. Panik yapma. Bu durumu çözmek için bir dedektif gibi düşünelim. Genellikle sadece üç ana “şüpheli” vardır. Bu şüphelileri tanıdığında, çözüme ne kadar hızlı ulaştığına şaşıracaksın.
İşte senin için hazırladığımız basit yol haritası:
1. Kart Sahibi/Müşteri Kaynaklı Hatalar
Çoğu zaman sorunun kaynağı doğrudan müşterindir. Neyse ki bunların çözümü en kolay olanlardır. Müşterin heyecanla kart numarasını yanlış yazmış olabilir. Veya kartının internet alışverişine kapalı olduğunu unutmuştur. Bazen de sorun sadece yetersiz bakiyedir. Bu durumda müşterine durumu sakince açıklayan bir mesaj göstermen genellikle yeterlidir.
En sık karşılaşılan hata türleri;
- Kart bilgilerinin (kart numarası, son kullanma tarihi, CVV) yanlış girilmesi,
- Yetersiz bakiye veya kredi/banka kartı limiti
- Kartın e-ticaret işlemlerine veya yurt dışı kullanımına kapalı olması
2. Üye İşyeri/Teknik Entegrasyon Kaynaklı Hatalar
Bu hatalar, işletmenin kendi web sitesi veya teknik altyapısındaki sorunlardan kaynaklanır. Hatalı API entegrasyonu, güvenlik anahtarlarının (hash) yanlış oluşturulması, sunucuya gönderilen verilerin yanlış formatta olması veya güncel olmayan bir SSL güvenlik sertifikası gibi teknik problemler bu gruba girer. Bu tür hataların çözümü genellikle işletmenin yazılım geliştiricisinin müdahalesini gerektirir ve Param gibi ödeme sağlayıcılarının teknik dokümantasyonları bu süreçte en önemli yol göstericidir.
3. Banka/Sistem Kaynaklı Hatalar
Bazen sorun ne müşterindedir ne de sendedir. Sorun doğrudan ödeme altyapısının kendisindedir. Yani kartı veren bankanın sisteminden kaynaklanır. Banka sunucusu zamanında yanıt vermemiş olabilir (timeout). Sistemlerinde anlık bir arıza veya kesinti yaşanabilir. Bu hatalar genellikle geçici bir durumdur. Müşterinden işlemi biraz sonra tekrar denemesini istemen yeterli olacaktır.
En Sık Karşılaşılan Sanal POS Hata Kodları Tablosu
E-ticaretteki başarısız işlemlerin büyük bir çoğunluğu, tekrar eden birkaç temel hata kodundan kaynaklanır. Acil bir durumla karşı karşıya olan ve hızlı çözüme ihtiyaç duyan işletme sahipleri ve müşteri temsilcileri için aşağıdaki tablo, en kritik hataları ve onlara verilecek doğru yanıtları özetlemektedir. Bu tablo, sadece hatanın anlamını değil, aynı zamanda müşteri iletişimini nasıl yöneteceğinize ve işletme olarak hangi adımları atmanız gerektiğine dair somut öneriler sunarak sizi bir adım öne taşır.
Ödeme adımında müşteri mi kaybediyorsun? O fırsatları kazanca dönüştür.
Param Sanal POS ile 7/24 güvenli tahsilat ve bütçeni düşünen komisyon oranları seni bekliyor. Sanal POS başvurunu hemen yap, pürüzsüz deneyimin keyfini çıkar.
En Sık Karşılaşılan Hata Kodları ve Acil Eylem Planı
| Hata Kodu | Olası Anlamı | Müşterinize Ne Söylemelisiniz? | Sizin Yapmanız Gereken |
05 / 005 | Genel Red / İşlem Onaylanmadı | “Görünüşe göre bankanız güvenlik nedeniyle bu işleme onay vermedi. Kartınızın online işlemlere açık olduğundan emin olup tekrar deneyebilir veya farklı bir kart kullanabilirsiniz.” | Bu hata genellikle kartın e-ticarete kapalı olması, CVV hatası veya bankanın fraud filtresi gibi birçok nedeni kapsar. Müşteriye alternatif ödeme yöntemleri (EFT, dijital cüzdan vb.) sunun. |
12 | Geçersiz İşlem | “Teknik bir nedenle işleminiz gerçekleştirilemedi. Lütfen bilgilerinizi kontrol edip tekrar deneyin. Sorun devam ederse farklı bir kart kullanmanızı rica ederiz.” | Genellikle uyumsuz bir taksit denemesi veya banka tarafından tanınmayan bir işlem türü nedeniyle oluşur. Tek çekim denemesi önerin. Hatanın belirli bir banka kartında tekrarlayıp tekrarlamadığını loglardan kontrol edin. |
| 51 | Yetersiz Bakiye / Limit | “Görünüşe göre kartınızın bakiyesi veya kredi limiti bu işlem için yeterli olmayabilir. Dilerseniz farklı bir kartla deneyebilir veya bankanızla görüşerek limit bilgilerinizi kontrol edebilirsiniz.” | Müşteriye başka bir kartla deneme veya Havale/EFT gibi alternatif bir ödeme seçeneği sunun. Bu, terk edilmiş sepeti kurtarmak için en etkili yoldur. |
54 | Süresi Dolmuş Kart | “Lütfen kartınızın üzerindeki son kullanma tarihini kontrol eder misiniz? Görünüşe göre kartınızın kullanım süresi dolmuş olabilir.” | Ödeme formunuzda, geçmiş bir tarih girildiğinde kullanıcıyı anında uyaracak bir kontrol mekanizması (validation) ekleyin. Bu, hata oluşmadan önce sorunu çözer. |
57 | İşlem Tipine İzin Yok | “Bankanız, bu kart ile bu tür bir işleme (örneğin internetten alışveriş) izin vermiyor olabilir. Lütfen bankanızla iletişime geçerek kartınızın yetkilerini kontrol ettirin.” | Bu hata sıklıkla kartın internet veya mail-order işlemlerine kapalı olmasından kaynaklanır. Müşteriyi bankasına yönlendirmek en doğru adımdır. |
91 | Banka Yanıt Vermiyor / Zaman Aşımı | “Şu anda bankanızın sistemleriyle iletişim kurulamıyor. Bu genellikle geçici bir durumdur. Lütfen birkaç dakika sonra tekrar deneyiniz.” | Bu hata tamamen banka kaynaklıdır. Yapabileceğiniz bir şey yoktur. Müşteriye sabırlı olmasını ve bir süre sonra tekrar denemesini veya farklı bir bankanın kartını kullanmasını önermek en iyisidir. |
Kapsamlı Hata Kodları: A’dan Z’ye Tüm Kodlar
Şimdi en sık karşılaşılan hata kodlarının dünyasına dalalım. Bu bölüm, senin için pratik bir sözlük gibi olacak. Bir kod gördüğünde ne anlama geldiğini ve o an ne yapman gerektiğini hemen anlayacaksın.
Standart Banka ve BKM Hata Kodları (00-99 Serisi)
Bu liste, Bankalararası Kart Merkezi (BKM) ve Türkiye’deki bankaların büyük çoğunluğu tarafından kullanılan, ISO 8583 standardına dayalı en yaygın hata kodlarını içerir. Her bir kod, sorunu anlamanız ve çözmeniz için detaylı bir şekilde açıklanmıştır.
00 – Onaylandı: Bu bir hata değil, işlemin başarıyla tamamlandığını söyleyen bir başarı mesajıdır. Her şey yolunda gitti!
01 – Bankayı Arayın (Referral): Kartı veren banka, işlemi şüpheli bulduğunu söyler. Bu nedenle ek bir onay istemektedir. Genellikle kartın e-ticaret işlemlerine kapalı olması veya bankalar arası iletişimde anlık bir sorun yaşanmasından kaynaklanır.
- Çözüm: Müşterinin, kartını aldığı bankanın müşteri hizmetlerini aramalıdır. Online işlemler için onay vermesi gerekir.
02 – Bankayı Arayın (Özel Durum): Kod 01’e benzer şekilde, bankanın özel bir onay istediği anlamına gelir. Genellikle müşterinin normal harcama alışkanlıklarının dışına çıkması gibi nedenleri vardır.
- Çözüm: Müşterinin bankasıyla iletişime geçmesi gerekiyor.
04 – Karta El Koy / Red: Bu kod, kartın blokeli veya çalıntı gibi şüpheli bir durumda olduğunu bildirir. Sanal işlemlerde işlemin kesin olarak reddedildiğini gösterir.
- Çözüm: Bu bir güvenlik uyarısıdır. Müşterin derhal bankasıyla görüşmeli. Bu kartla yapılan sonraki denemeleri engellemelisin.
05 – İşlem Onaylanmadı / Genel Red: En sık karşılaşılan ve en genel hata kodlarından biridir. Kart bilgilerinin (CVV) hatalı girilmesi, kartın e-ticarete kapalı olması, bankanın işlemi riskli bulması gibi çok sayıda nedeni olabilir.
- Çözüm: Müşterine bilgilerini kontrol etmesini söyle. Farklı bir kart denemesini veya bankasıyla konuşmasını önerebilirsin.
Geçersiz İşlemler
12 – Geçersiz İşlem (Genellikle Taksit Hatası): Yapılmaya çalışılan işlem, banka veya POS sistemi tarafından tanınmıyor. En yaygın nedeni, üye işyerinin anlaşması olmayan bir taksit sayısını denemektir.
- Çözüm: Taksit seçeneklerini kontrol edin. Müşteriye tek çekim denemesini veya kartının ait olduğu bankanın POS’u üzerinden işlem yapmayı önerin.
13 – Geçersiz Tutar: İşlem tutarı geçersiz bir formatta veya bankanın/işyerinin izin verdiği minimum/maksimum limitlerin dışında. Örneğin, sıfır veya negatif bir tutar gönderilmesi bu hataya neden olabilir.
- Çözüm: İşletme, gönderdiği tutar formatını (örn: kuruş ayracı olmadan 1050 şeklinde) kontrol etmelidir.
14 – Geçersiz Kart Numarası: Girilen kart numarası, standart bir kredi kartı formatına (Luhn algoritması) uymuyor veya bilinen bir banka aralığına (BIN) ait değil.
- Çözüm: Müşteri kart numarasını kontrol edip tekrar girmelidir. Ödeme formunda anlık format kontrolü yapılması bu hatayı önler.
30 – Format Hatası: İşlem isteği, bankanın beklediği teknik formata uymuyor. Bu genellikle üye işyeri tarafındaki bir entegrasyon sorunudur.
- Çözüm: Yazılım geliştiricisi, ödeme ağ geçidine gönderilen verilerin (XML/JSON) yapısını ve formatını teknik dokümantasyona göre kontrol etmelidir.
Kart ile ilgili Sorunlar
33 / 54 – Süresi Dolmuş Kart: İşlemde kullanılan kartın son kullanma tarihi geçmiş.
- Çözüm: Müşteri, kartının son kullanma tarihini kontrol etmeli ve geçerli bir kart kullanmalıdır.
41 – Kayıp Kart: Kartın sahibi tarafından bankaya kayıp bildirimi yapılmış. Bu bir güvenlik alarmıdır.
- Çözüm: Bkz. Bölüm 3.2 – Güvenlik Odaklı Hata Kodları.
43 – Çalıntı Kart: Kartın sahibi tarafından bankaya çalıntı bildirimi yapılmış. Bu, en ciddi güvenlik alarmlarından biridir.
- Çözüm: Bkz. Bölüm 3.2 – Güvenlik Odaklı Hata Kodları.
51 – Yetersiz Bakiye / Limit: Kartın bağlı olduğu hesapta yeterli bakiye yok veya kartın kredi limiti işlem tutarını karşılamıyor.
- Çözüm: Müşteri farklı bir kart denemeli, hesabına para yatırmalı veya bankasından limit artırımı talep etmelidir.
55 – Hatalı Şifre (PIN): Fiziksel POS’larda PIN’in yanlış girilmesi anlamına gelir. Sanal POS’ta ise genellikle 3D Secure şifresinin yanlış girilmesi durumunda farklı kodlarla (örn: 75, 82) yansır, ancak bazı sistemler bu kodu da kullanabilir.
- Çözüm: Müşteri, bankasından gelen SMS şifresini doğru girdiğinden emin olmalıdır.
57 – İşlem Tipine İzin Yok: Kart sahibinin kartı, yapılmak istenen işleme kapalıdır. En yaygın nedenler kartın internetten alışverişe, mail order’a veya taksitli işlemlere kapalı olmasıdır.
- Çözüm: Müşteri, bankasının mobil uygulaması veya müşteri hizmetleri aracılığıyla kartının yetkilerini kontrol etmeli ve gerekli izinleri açtırmalıdır.
58 – Terminale İşlem İzni Yok: Üye işyerinin (yani sizin) Sanal POS’u, yapılmak istenen işleme kapalıdır. Örneğin, yurt dışı kartlarla işlem yapma veya belirli bir kart programıyla (örn: Amex) ödeme alma yetkiniz olmayabilir.
- Çözüm: İşlem yetkilerinizi kontrol etmek ve genişletmek için Param gibi ödeme hizmeti sağlayıcınızla iletişime geçin.
Karmaşık ödeme süreçleriyle değerli vaktini harcama.
Param Sanal POS’un pratik altyapısı sayesinde dakikalar içinde online ödeme almaya başla. Hızlı kurulum ve avantajlı Sanal POS komisyon oranlarından yararlanmak için başvurunu şimdi tamamla, işine odaklan.
62 – Kısıtlı Kart: Kart, banka tarafından belirli coğrafi bölgelerde veya belirli işlem türlerinde kullanılmak üzere kısıtlanmıştır.
- Çözüm: Müşteri, kartındaki kısıtlamaları öğrenmek için bankasıyla görüşmelidir.
75 – Şifre Deneme Sayısı Aşıldı: Müşteri, 3D Secure şifresini veya diğer kimlik doğrulama kodlarını bankanın izin verdiği maksimum sayıda yanlış girmiştir. Güvenlik nedeniyle kart geçici olarak bloke edilebilir.
- Çözüm: Müşteri bir süre beklemeli veya kart blokesini kaldırmak için bankasıyla iletişime geçmelidir.
82 – Hatalı CVV: Kartın arkasındaki 3 veya 4 haneli güvenlik kodunun (CVV2/CVC2) yanlış girildiğini belirtir.
- Çözüm: Müşteri, CVV kodunu dikkatlice kontrol edip tekrar girmelidir.
91 – Banka Yanıt Vermiyor / Zaman Aşımı: Ödeme isteği kartı veren bankaya ulaştı ancak banka sistemleri belirlenen süre içinde yanıt veremedi. Banka tarafında anlık bir yoğunluk veya sistemsel bir yavaşlık olduğunu gösterir.
- Çözüm: Genellikle geçici bir sorundur. Müşteriye birkaç dakika sonra tekrar denemesi önerilmelidir.
96 – Sistem Arızası: Ödeme altyapısında (banka, BKM veya ödeme kuruluşu) genel bir teknik arıza olduğunu belirtir. Bu, 91 kodundan daha geniş kapsamlı bir soruna işaret edebilir.
- Çözüm: Sorun genel altyapıda olduğu için beklemek ve daha sonra tekrar denemek tek çözümdür.
Sanal POS’larda Güvenlik ve Sahtekârlık (Fraud) Hata Kodları
Şimdi çok önemli bir konuya geldik: Güvenlik.
Unutma, tüm hata kodları aynı değildir. Bazıları basit bir müşteri hatasını gösterir. Ama bazıları, iş yerin için çalan bir kırmızı alarmdır. “Yetersiz Bakiye” hatası ile “Çalıntı Kart” uyarısına aynı tepkiyi vermek, yapabileceğin en büyük hatalardan biridir.
Bu kodları tanımak ve doğru protokolle hareket etmek, sizi finansal kayıplardan ve yasal sorumluluklardan korur. Standart hata listelerinde bu kodların ciddiyeti genellikle gözden kaçar; ancak “Yetersiz Bakiye” ile “Çalıntı Kart” uyarısına aynı şekilde yaklaşmak, işletmelerin yapabileceği en büyük hatalardan biridir.
Bu Kodları Gördüğünde Dur ve Düşün
Aşağıdaki kodlardan herhangi birini görürsen, bu bir “hata” değil, “tehlike” sinyalidir. Birazdan anlatacağımız güvenlik protokolünü harfiyen uygulamalısın:
04 (Blokeli Kart), 34 (Sahte Kart), 41 (Kayıp Kart), 43 (Çalıntı Kart), 59 (Sahtekârlık Şüphesi), 63 (Güvenlik İhlali)
Uygulaman Gereken 5 Adımlı Güvenlik Protokolü
1- İşlemi Asla Tekrarlamayın: Bu kodlar bir hata değil, bir uyarıdır. İşlemi tekrar denemen, dolandırıcılık yapan kişiye yardım etmek olur. Sakın yapma.
2- Müşteriye Detay Vermeyin: Müşteriye asla “Kartınız çalıntı olarak görünüyor” veya “Kartınız sahte” gibi spesifik bilgiler vermeyin. Bu, hem yasal sorunlara yol açabilir hem de dolandırıcının bilgi edinmesine neden olabilir. Bunun yerine, şu gibi genel ve sakin bir dil kullanın:
- ”Güvenlik nedeniyle işleminiz bankanız tarafından onaylanmadı. Detaylı bilgi almak ve sorunu çözmek için lütfen doğrudan bankanızla iletişime geçmenizi rica ederiz.”
3- Tüm Bilgileri Kayıt Altına Alın (Loglama): Hemen o işleme ait tüm dijital izleri kaydet. Bunlar senin kanıtların olacak.
- İşlem zamanı,
- Kartın maskeli hali (ilk 6 ve son 4 hane),
- İşlem tutarı,
- Müşterinin IP adresi ve cihaz bilgisi
Olası bir resmi incelemede bu bilgiler hayatını kurtarır.
4- Şüpheli Aktiviteyi İşaretleyin: Eğer işlemi yapan kayıtlı bir kullanıcın ise, hesabını sisteminde hemen “şüpheli” olarak işaretle. Hatta gerekirse hesabını dondur. Aynı hesaptan veya IP adresinden gelecek yeni denemeleri otomatik olarak engelle.
5- Ödeme Sağlayıcınızı Bilgilendirin: Son adım olarak, durumu hemen ödeme sağlayıcın ile paylaş. Genellikle bunun için özel “sahtekârlık bildirim” araçları bulunur. Bu bildirim, sadece seni değil, sistemdeki diğer tüm dürüst işletmeleri de korur.
Teknik ve Entegrasyon Hata Kodları (Geliştiriciler İçin)
Bu bölüm, ödeme entegrasyonunu yapan yazılım geliştiricilerinin ve IT profesyonellerinin karşılaştığı teknik sorunları çözmeye odaklanmıştır. Bu hatalar genellikle son kullanıcıya yansımaz ama arka planda ödeme sisteminin düzgün çalışmasını engeller. Başarılı bir entegrasyon, bu kodları anlamaktan ve doğru çözümleri uygulamaktan geçer. Bu hataları doğru teşhis etmek, geliştiricilerin saatler süren hata ayıklama (debugging) süreçlerinden kurtararak zaman kazanmasını sağlar ve Param gibi platformların geliştirici dostu olduğunu gösterir.
Geliştiriciler için Teknik Hata Kodları ve Çözüm İpuçları
Hata Türü / Kodu | Olası Neden | Kontrol Edilmesi Gerekenler (Checklist) | |
Hash / Token / Crypto Hatası (Örn: İşlem Hash boş, KEY SYN. HATASI, CRYPTO HATASI, mdstatus:7, paytr_token geçersiz) | Güvenlik imzasını (hash) oluşturan veriler ile sunucuya gönderilen verilerin eşleşmemesi. Bu, en yaygın entegrasyon hatasıdır. | * Doğru Anahtarlar: Test ve canlı ortam için doğru merchant_key, merchant_salt, api_key gibi değerleri mi kullanıyorsunuz? * Veri Sırası ve Formatı: Hash oluşturmak için birleştirdiğiniz string’in (tutar, sipariş no, para birimi vb.) sırası ve formatı, dokümantasyondaki örnekle birebir aynı mı? * Tutar Formatı: Tutar bilgisini doğru formatta mı gönderiyorsunuz? (Örn: 15.75 yerine 1575 olarak, ayraçsız ve kuruş cinsinden). | * Karakter Kodlaması: Gönderilen verilerde UTF-8 gibi standart bir karakter kodlaması kullanılıyor mu? Türkçe karakterler sorun yaratıyor olabilir. |
API / XML / Format Hatası (Örn: API-0002, CORE-1000, FORMAT HATASI (UYEISYERI)) | Ödeme ağ geçidine gönderilen isteğin (request) yapısı (XML/JSON) veya içeriği hatalı. | * Zorunlu Alanlar: İstek içinde gönderilmesi zorunlu olan tüm parametreler mevcut mu? * Veri Tipleri: Parametreler doğru veri tipinde mi gönderiliyor? (Örn: Tutar sayısal, tarih doğru formatta mı?) * Endpoint URL: İsteği doğru API endpoint’ine (test/canlı) mi gönderiyorsunuz? | |
Entegrasyon / Terminal Ayar Hatası (Örn: MID,TID,IP HATALI, Terminalin işlem yetkisi yok, Gecersiz isyeri) | İşlem yapılan üye işyeri (MID), terminal (TID) veya IP adresi, ödeme sağlayıcısı sisteminde tanımlı değil veya yetkisi yok. | * Doğru Kimlik Bilgileri: Kodunuzda kullandığınız Üye İşyeri Numarası (MID) ve Terminal Numarası (TID) size verilen bilgilerle aynı mı? * IP Kısıtlaması: Ödeme sağlayıcınız, işlemlere sadece belirli IP adreslerinden izin veriyor olabilir. Sunucunuzun IP adresi, izin verilen listeye ekli mi?. | * Ortam Uyumsuzluğu: Test ortamına ait MID/TID bilgileriyle canlı (production) ortama istek göndermeye çalışıyor olabilirsiniz. |
3D Secure Hataları (Örn: HATALI 3D GÜVENLİK BİLGİSİ, ECI veya CAVV bilgisi eksik) | 3D Secure doğrulama sürecinden dönen verilerin işlenmesinde veya doğrulanmasında hata oluşması. | * Callback URL: Bankanın 3D Secure sonucunu geri göndereceği callback (geri dönüş) URL’niz doğru yapılandırılmış ve erişilebilir mi? * Parametrelerin Alınması: Bankadan dönen CAVV, ECI, MD gibi 3D Secure sonuç parametrelerini doğru bir şekilde alıp, ikinci bir teyit için ödeme sağlayıcınıza gönderiyor musunuz? * Zaman Aşımı: Kullanıcı 3D Secure sayfasında çok uzun süre beklerse oturum (session) zaman aşımına uğrayabilir. |
ParamPOS Hata Kodları Nedir?
Bankaların genel hata kodlarını öğrendin. Onlar, bu ekosistemin ortak dilidir. Ama Param olarak biz, işini kolaylaştırmak için bir adım daha ileri gidiyoruz. Senin için ödeme sürecini daha anlaşılır ve çok daha güvenli hale getirmeyi hedefliyoruz. Bunun için de kendi özel kontrol sistemimizi ve sana özel hata mesajlarımızı geliştirdik.
Bu bölümü,değerli ParamPOS iş ortaklarımız için hazırladık.
Bu özel mesajları anladığında, sorunları çok daha hızlı çözeceksin. Ayrıca sunduğumuz ek güvenlik katmanlarından tam olarak faydalanacaksın.
Bazen karşına “Nonsecure işlem segment limit hatası” gibi bir mesaj çıkabilir. Bunun cevabını standart banka listelerinde bulamaman çok normal. Çünkü bu, senin güvenliğin için Param’ın geliştirdiği özel bir mesajdır.
Sana proaktif destek vermek ve şeffaf bir iş ortağı olmak, bizim için en önemli öncelik.
Hazırsan, şimdi Param’a özel hata kodlarını ve anlamlarını birlikte keşfedelim.
ParamPOS Hata Mesajları
| ParamPOS Hata Kodu / Mesajı | Anlamı ve Sebebi | Çözüm Yolu |
Güvenlik hatası | Bu hata, ödeme isteğinin yapıldığı IP adresinin Param hesabınızda tanımlı olmamasından kaynaklanır. Param, güvenliği artırmak için sadece yetkilendirilmiş IP’lerden gelen isteklere izin verir. | Param kurumsal panelinize giriş yaparak “ParamPOS -> Entegrasyon Bilgilerim” menüsünden sunucunuzun IP adresini izin verilen listeye eklemelisiniz. |
İşlem Hash geçersiz | Ödeme isteğinin güvenliğini ve bütünlüğünü doğrulamak için kullanılan hash değeri yanlış hesaplanmıştır. Hash hesaplamasına dahil edilen veriler (tutar, sipariş no vb.) ile sunucuya gönderilen veriler arasında bir uyuşmazlık vardır. | Geliştiriciniz, Param’ın “Hash Hesaplama” dokümanını inceleyerek kullandığınız servis için doğru veri sırası ve formatıyla hash oluşturulduğundan emin olmalıdır. Özellikle tutar formatı (1575 gibi) ve anahtarların (test/canlı) doğruluğu kontrol edilmelidir. |
İşlem Hash boş | Güvenlik için zorunlu olan İşlem Hash parametresi, ödeme isteği içinde hiç gönderilmemiştir. | Geliştiriciniz, ödeme isteği gönderilen kod bloğunu kontrol ederek İşlem Hash parametresinin oluşturulup isteğe eklendiğinden emin olmalıdır. |
SanalPOS_ID ye ait taksit geçersiz | İşlemde kullanılan karta ve seçilen taksit sayısına, üye işyeri hesabınızda tanımlı bir oran bulunmamaktadır. Kart yabancı bir karta ait olabilir veya o kart türü için taksit yetkiniz olmayabilir. | Kartın BIN numarasını kontrol ederek taksit seçeneklerini sorgulayın. Gerekirse, oran tanımlarının yapılması veya yabancı kart işlem yetkisinin açılması için Param ile iletişime geçin. |
Nonsecure işlem segment limit hatası | 3D Secure kullanılmadan (non-secure) yapılan işlem tutarı, hesabınız için tanımlanmış olan günlük veya işlem başına limiti aşmaktadır. Bu, sahtekarlığı önleyici bir güvenlik kuralıdır. | Daha yüksek tutarlı işlemler için 3D Secure kullanımını zorunlu hale getirin veya iş modeliniz gerektiriyorsa limit artırım talebi için Param destek ekibiyle görüşün. |
Yasaklı bilgi ile işlem yapılamaz | İşlemde kullanılan GSM numarası veya kart numarası, Param’ın güvenlik filtreleri tarafından “yasaklı” veya “riskli” olarak işaretlenmiştir. | Bu bir güvenlik uyarısıdır. Detaylı bilgi almak ve durumun nedenini öğrenmek için doğrudan Param destek ekipleriyle iletişime geçmeniz gerekmektedir. |
GUID ile Güvenlik nesnesi eşleşmiyor | İstekte gönderilen GUID (hesap benzersiz kimliği) ile Güvenlik Nesnesi (CLIENT_CODE, CLIENT_USERNAME, CLIENT_PASSWORD) bilgileri birbiriyle eşleşmemektedir. Farklı hesaplara ait kimlik bilgileri karıştırılmış olabilir. | Entegrasyon kodunuzdaki GUID ve güvenlik nesnesi parametrelerinin doğru ve aynı hesaba ait olduğunu kontrol edin. Test ve canlı ortam bilgilerini karıştırmadığınızdan emin olun. |
| Bu sipariş sonuçlandırılmıştır. İşleme devam edilemez | Ödeme isteğinde kullanılan Siparis_ID (sipariş numarası) ile daha önce başarılı bir işlem gerçekleştirilmiştir. Güvenlik ve kayıt tutarlılığı için her başarılı işlemin benzersiz bir sipariş numarası olmalıdır. | Her yeni ödeme denemesi için benzersiz bir Siparis_ID değeri üreterek isteği yeniden gönderin. |
Sanal POS Hatalarını Önle
Hataları nasıl çözeceğini öğrendin. Şimdi sıra en önemli adımda: Hataları daha ortaya çıkmadan engellemek.
Başarılı e-ticaret işletmeleri sadece sorun çözmekle yetinmez. Onlar, sorunların oluşmasını en baştan engelleyen sistemler kurar. Bu son bölüm, seni bir sorun çözücüden, bir sistem mimarına dönüştürecek. Bu stratejilerle hem müşteri deneyimini hem de kârlılığını zirveye taşıyacaksın.
Müşterinin Hata Yapmasını Engelle
Müşteri kaynaklı hataların çoğu, aslında kafa karıştırıcı bir ödeme sayfasından kaynaklanır. Tasarımını basitleştirerek başarı oranını doğrudan artırabilirsin.
- Müşterin kart bilgilerini yazarken sistemin onu anında yönlendirsin. Örneğin, 15 haneli bir numara yazdığında, “Lütfen 16 haneli kart numaranı gir” uyarısı hemen çıksın. Bu, müşterinin “Ödemeyi Tamamla” butonuna bastıktan sonra yaşayacağı hayal kırıklığını önler.
- Müşterine asla “Hata Kodu: 14” gibi teknik bir mesaj gösterme. Bunun yerine, ona ne yapması gerektiğini söyle. “Girdiğin kart numarası geçersiz görünüyor. Lütfen kontrol edip tekrar dene.” gibi basit ve yol gösterici bir dil kullan.
- Ödeme sayfanın telefon ve tablette mükemmel çalıştığından emin ol. Butonlar dokunmak için yeterince büyük mü? Yazılar kolay okunuyor mu? Unutma, mobilden gelen müşterilerin hata yapma lüksü daha azdır.
Teknik Altyapıyı Sağlamlaştır
Ödeme altyapının görünmez temelleri, tüm sisteminin sağlığını belirler. Bu temelleri sağlam tutarak beklenmedik hataları en aza indirebilirsin.
- Entegrasyonunu Güncel Tut: Param olarak biz, sistemi daha güvenli ve hızlı yapmak için sürekli güncellemeler yayınlarız. Yazılım geliştiricinin her zaman en güncel API ve SDK’yı (teknik bağlantı kitleri) kullandığından emin ol. Bu, hem seni korur hem de yeni özelliklerden faydalanmanı sağlar.
- SSL Sertifikanı Asla İhmal Etme: SSL, siten ile müşterinin tarayıcısı arasındaki konuşmayı şifreleyen bir güvenlik kilididir. Bu sertifikanın süresinin dolması, işlemleri tamamen durdurabilmektedir. Sertifikanın her zaman güncel ve geçerli olduğundan emin ol.
- Her Değişiklikten Sonra Test Et: Siten’de büyük bir değişiklik mi yaptın? Hemen ödeme sürecini bir test (sandbox) ortamında baştan sona dene. Farklı kartlar, farklı bankalar, farklı senaryolar… Her ihtimali deneyerek sisteminin her zaman sağlam olduğundan emin ol.
Sahtekârlık (Fraud) Filtrelerini Geliştir
Sahtekârlık girişimleri sadece paranı çalmaz. Aynı zamanda bankaların sana olan güvenini de sarsar. Bu durum, genel ödeme başarı oranını düşürebilir. Proaktif güvenlik önlemleri ise bu girişimleri daha başlamadan caydırır ve engeller.
- 3D Secure’ü Akıllıca Kullan: 3D Secure, SMS onayı ile sahtekârlığa karşı en güçlü kalkanındır. Ama onu akıllıca kullanmalısın. Yüksek tutarlı veya ilk kez alışveriş yapan müşterilerden mutlaka 3D Secure onayı iste. Sürekli ve güvenilir müşterilerin için ise daha esnek kurallar belirleyebilirsin. Bu, güvenlik ve kolaylık arasında mükemmel bir denge kurmanı sağlar.
- Akıllı Sahtekârlık Filtrelerini Devreye Al: Param, şüpheli işlemleri yakalamak için sana gelişmiş araçlar sunar. Bu araçlar, işlemin yapıldığı IP adresini kontrol eder. Kısa sürede farklı kartlarla yapılan denemeleri anında yakalar. Bu akıllı filtreleri iş modeline göre ayarlayarak sahtekârlık girişimlerini büyük oranda engelleyebilirsin.
Alternatifler Sun
En iyi sistemde bile bazen işler ters gidebilmektedir. Müşterinin kart limiti dolu olabilir, ya da bankasının sistemi anlık olarak kapanmıştır. Böyle bir anda müşteriye sadece tek bir seçenek sunarsan, o satışı büyük ihtimalle kaybedersin.
Ödeme sayfanda kartla ödemenin yanına başka seçenekler de ekle. Havale/EFT, dijital cüzdanlar veya “Param ile Öde” gibi alternatifler sun. Bunlar senin B planın olur.
Kartı çalışmayan müşteri, hayal kırıklığıyla sepeti terk etmek yerine diğer yönteme geçer. Böylece alışverişini kolayca tamamlar. Bu basit ekleme, satışlarını kurtarmanın ve müşteri memnuniyetini artırmanın en etkili yollarından biridir.
İşletmeler için En Uygun Sanal POS: Kontrol Artık Sende
Bu rehber boyunca uzun bir yolculuk yaptın. Artık Sanal POS hata kodlarının korkutucu birer engel olmadığını biliyorsun. Onların, işini geliştirmek için değerli veriler sunan birer iletişim aracı olduğunu anladın.
Bir işlemin neden başarısız olduğunu anlamak, her şeyin başlangıcıdır. Sorun müşteride mi, sende mi, yoksa bankada mı? Bu temel ayrımı yapmak, paniği bitirir ve seni doğrudan en doğru çözüm yoluna sokar.
En yaygın hatalar için artık acil eylem planların var. Güvenlik risklerine karşı nasıl davranacağını da öğrendin. Ama gerçek başarı, sorunları sadece çözmek değildir. Gerçek başarı, proaktif olmaktır. Ödeme sayfanı daha kullanıcı dostu yapmak, teknik temellerini sağlamlaştırmak ve müşterilerine alternatifler sunmak… İşte bu adımlar, hataları daha ortaya çıkmadan engeller.
Param olarak bizim hedefimiz, senin sadece bir altyapı kullanıcısı olman değil. Biz, senin süreçlere tam anlamıyla hakim, bilinçli bir iş ortağı olmanı istiyoruz. Bu rehber, bu hedefimizin en net yansımasıdır. Sana sadece teknolojik araçlar sunmakla kalmıyoruz. Bu araçları en verimli şekilde kullanman için gereken bilgiyi ve stratejiyi de sunuyoruz. Çünkü sen başarılı olunca, biz de başarılı oluruz.
Artık bu rehberdeki tüm bilgilerle donatıldın. Ödeme hatalarına karşı eskisinden çok daha hazırlıklı ve bilgilisin. Karşına çıkan her hata kodunu bir fırsat olarak gör:
- Müşteri deneyimini iyileştirmek için bir fırsat.
- Teknik altyapını güçlendirmek için bir fırsat.
- İşini daha güvenli hale getirmek için bir fırsat.
Ödeme süreçlerinin kontrolünü tamamen eline al. Ve her “Ödeme Yap” butonuna tıklandığı anı, başarılı bir güven ve memnuniyet anına dönüştür.