Neden Hata Alıyorum?

Aköde Validasyon Timestamp Hataları hk.

Aköde Sanal POS için test bağlantısı veya ödeme denediğinizde karşılaşılan validasyon hatalarını WordPress > Ayarlar > Genel zaman dilimi seçeneğini İstanbul seçerek giderebilirsiniz. Aköde POS Saat zaman dilimini kontrol ettiği için bu hata meydana gelmektedir.

PRO Özelliklerin Aktif Olarak Gözükmemesi Sorunu hk.

POS Entegratör’ün PRO sürümüne sahip olduğunuz halde PRO’da olan özellikleri kullanamıyor veya ödeme kuruluşunuz veya bankanız aktif olarak gözükmüyorsa eklentilerin en güncel sürümde olduğundan lütfen emin olunuz. Eklentilerimizin en güncel versiyonlarının kaç olduğuna buraya tıklayarak görüntüleyebilirsiniz. WordPress eklentiler sayfası üzerinden güncellenme gözükmüyor ise lütfen WordPress admin panelinizin en üst sol köşesinde olan başlangıç > güncellemeler kısmını kontrol ediniz burada POS Entegratör eklentilerimizin güncellemesi var ise tamamlayınız. Güncelleme gözükmüyor ve PRO özellikleri hala kapalı gözüküyor ise; POS Entegratör’e ait her hangi bir güncelleme gözükmüyor ise satın alım gerçekleştirdiğiniz gurmehub.com hesabınızdan POS Entegratör’ün en güncel sürümlerini indirebilir ve manuel olarak güncelleme yapabilirsiniz.

⭐ Hatalı Ödemelerin Detaylarını Görüntüleme

POS Entegratör işlemler sayfası sitenizde gerçekleşen işlemlerin tüm detaylarını görüntülemenizi sağlar. Her hangi bir ödeme işleminde hata alıyorsanız ve ödeme kuruluşu/banka tarafından dönen hata mesajı anlamlı bir ifade içermiyorsa teknik log kayıtlarını inceleyebilirsiniz. Detaylı Teknik Log Kayıtlarını İncelemek Her hangi bir işlemin detay sayfasına girdiğinizde ödeme kuruluşunuz ile haberleştiğiniz kayıtlar burada tutulur ve bu kayıtları “Göz İkonuna” basarak görüntüleyebilirsiniz. Kayıtlar bölümündeki Geri Dönüş size ödeme kuruluşundan gelen son cevaptır. Detayları görmek istediğinizde sizlere sitenizden atılan istek ve geri dönen cevabı görüntüleyebilirsiniz burada işleminiz hakkında tüm detayları görüntüleyebilirsiniz bu sayede ödemenizin neden başarısız olduğunu anlayabilir ve bu bilgiler ile anlaşmalı olduğunuz ödeme kuruluşu veya banka ile iletişime geçebilirsiniz. Ödeme Kuruluşu / Bankaların Sanal POS iletişim Mailleri - Payten altyapısı kullanan bankalar için sanal POS destek Mail adresi (Akbank, İşbankası, Ziraat Bankası…): destek@payten.com - Paratika : destek@paratika.com.tr - Iyzico : destek@iyzico.com - PayTR : tekops@paytr.com  - Garanti Bankası : eticaretdestek@garantibbva.com.tr - Vakıfbank: vpos724@vakifbank.com.tr - PayNKolay: kolayposdestek@nkolay.com.tr Süreç boyunca sizlere destek olacağız.

Hash Mismatch! hatası hk.

Hash Mismatch! hatası genel olarak bankaların hatalı API bilgileri sebebiyle geri döndüğü hatadır. Anlaşmalı olduğunuz bankanın API bilgilerini kontrol edip tekrar işlemler deneyebilirsiniz. Özellikle kullanıcılar “3D Key” oluşturma bölümlerinde bu hatayı sıkça almaktadırlar. API bilgilerinizden eminseniz ve hala bu hatayı almayı devam ediyorsanız bu bağlantıdan hatanın detaylarını öğrenebilir ve bankanız ile iletişime geçebilirsiniz.

PayTR Geçersiz Entegrasyon Hatası hk.

Eğer POS Entegratör ve PayTR Direct API kullanıcısıysanız ve ödeme sırasında bu hatayı alıyorsanız PayTR ile iletişime geçerek Direct API izni almalısınız. PayTR ile iletişime geçerken POS Entegratör ürününü kullandığınızı ve bu yüzden Direct API izni istediğinizi belirtmeniz sürecin hızlanmasında fayda sağlayacaktır. Konuyla ilgili olarak hata almaya hala devam ediyorsanız gurmehub.com üzerinden destek talebinde bulunabilirsiniz.

Paratika İşlemlerin “Başarısız” Gözükme Hatası (API_QUERYTRANSACTION)

Paratika Ödeme Kuruluşu kullanan kullanıcılarımız için işlemlerinde kredi kartından ücret tahsil edilmesine ve Paratika panelinde işlemin başarılı görünmesine rağmen WooCommerce üzerinde başarısız olarak görünmesinin sebebi, Paratika’nın API kullanıcısına “API_QUERYTRANSACTION” yetkisi vermemesinden kaynaklanmaktadır. Paratika ile iletişime geçerek “User does not have API_QUERYTRANSACTION permission to perform this action” şeklinde hata aldığınızı bildirerek gerekli yetkilendirmeleri alabilirsiniz. Bu sayede WooCommerce panelinizde de ödeme başarılı olarak görünecektir.

Garanti Bankası ErrorId: 0809 SubMerchantID Hatası hk.

Garanti Sanal POS entegrasyonunu tamamlandıktan sonra işlem denemelerinizde “ErrorId: 0809 SubMerchantID alanında bayii kodunun gönderilmesi zorunludur” şeklinde hata alıyor iseniz Sanal POS’unuz banka tarafında B2B yetkisinde tanımlıdır. Garanti bankasına mail atarak (eticaretdestek@garantibbva.com.tr) konuyla ilgili olarak yetkilendirme düzenlemesi talep edebilirsiniz.

Garanti Bankası: “Guvenlik Kodu hatali” hatası hk.

Garanti Sanal POS üzerinden ödeme işlemlerinizde “mdstatus: 7” hatasını alıyorsanız, bu genellikle “Güvenlik Kodu hatalı” anlamına gelir ve API bilgilerinde bir hata olduğunu işaret eder. Bu hatanın en yaygın nedeni, 3D Secure anahtarının (3D Key) yanlış ya da eksik olmasıdır. Özellikle “3D Anahtarı”nı kontrol etmenizi tavsiye ederiz. Daha fazla bilgi ve detaylar için Garanti Bankası’nın dökümantasyonuna aşağıdaki bağlantıdan ulaşabilirsiniz. Hata almaya devam ediyorsanız lütfen bizlerle iletişime geçmekten çekinmeyin.

Callback URL’lerinin Cache Eklentilerinde Hariç Tutulması Hakkında

POS Entegratör eklentimiz, bazı ödeme sistemleriyle entegre çalışırken, ödeme işlemlerinin doğruluğunu sağlamak için belirli URL’ler aracılığıyla geri bildirim alır. Örneğin, PayTR gibi ödeme sağlayıcıları, ödeme işlemi tamamlandığında web sitenize bir “callback” sorgusu gönderir. Bu sorgu, işlemin başarılı olup olmadığını doğrulamak amacıyla yapılır ve yanıt olarak sistemden "OK" cevabı beklenir. Ancak, bazı cache eklentileri (örn. WP Super Cache, W3 Total Cache, LiteSpeed Cache vb.), bu callback URL’lerini cache’leyerek sorguların doğru şekilde çalışmasını engelleyebilir. Bu da ödeme süreçlerinde hatalara ve işlemlerin doğru sonuçlanmamasına neden olabilir. Neden Cache Hariç Tutulmalı? Callback URL’lerinin cache’lenmesi, ödeme sağlayıcıları ile web siteniz arasındaki iletişimi kesintiye uğratabilir. Cache eklentileri, dinamik içerik yerine önceden kaydedilmiş statik bir yanıt dönebilir. Ödeme sağlayıcıları, bu statik yanıt karşısında bekledikleri dinamik doğrulama verisini alamaz ve bu durumda ödeme işlemi başarısız olarak kabul edilebilir. Bu sorunların önüne geçmek için POS Entegratör’ün kullandığı belirli callback URL’lerinin cache eklentilerinden hariç tutulması gerekmektedir. Cache Eklentilerinde Hariç Tutulması Gereken URL’ler POS Entegratör’ün sorunsuz çalışabilmesi için aşağıdaki URL’lerin cache eklentilerinden hariç tutulması önerilir: - /gpos-notify - /gpos-paytr-callback - /gpos-callback - /gpos-redirect - /gpos-test-callback Bu URL’ler, ödeme işlemleri sonrasında gelen sorguların yönetildiği sayfalardır ve her biri, doğru çalışması için cache’lenmemelidir. Bu sayfaların cache dışında bırakılması, ödeme süreçlerinde olası sorunları önleyecek ve işlemlerin sağlıklı bir şekilde sonuçlanmasını sağlayacaktır.

Akbank JSON iade işleminde hata

Akbank JSON İade İşlemlerinde Müşteri E-Posta Adresi Zorunluluğu Akbank JSON entegrasyonlarında iade işlemleri gerçekleştirilirken, müşteri e-posta adresi alanı zorunlu olarak belirtilmiştir. Eğer iade işlemi sırasında sistemden “geri dönüşü olmayan hata” alınıyorsa, bunun nedeni büyük olasılıkla müşteri e-posta bilgisinin iletilmemiş olmasıdır. Detaylar: Müşteriden ödeme sayfasında bir mail adresi istemeniz gerekmektedir. Akbank, iade işlemleri sırasında müşteriye bilgi maili gönderebilmek için email alanının dolu olmasını zorunlu kılar. Bu alan boş bırakıldığında, işlem hata verir ve iade tamamlanamaz. İlgili hata: