VibeFox Paytrail for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: EUR. Paytrail yalnızca euro kabul eder. Başka bir para birimindeki bir sipariş için ödeme yöntemi ödeme sayfasında gizlenir. Tutarlar sent (kuruş) cinsinden gönderilir.

Mağazanızın internet erişimi: Paytrail her ödemeyi sunucudan sunucuya bir geri çağırma (callback) ile onaylar; bu nedenle mağazanın internetten erişilebilir olması gerekir. Callback olmadan bile, müşteri Paytrail'den döndüğünde siparişler yine onaylanır.

Paytrail hesabı: Paytrail Merchant Panel'de (hesap veya entegrasyon ayrıntılarında) görüntülenen satıcı kimliğinize (merchant ID) ve gizli anahtarınıza ihtiyacınız vardır. Test için bir hesap gerekmez: test modu, Paytrail'in herkese açık test hesabını kullanır. Ödeme yöntemlerinin kendisi Paytrail hesabınızda etkinleştirilir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_paytrail_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_paytrail_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_paytrail_gateway-oc3-(version).ocmod.zip dosyasını seçin. Uzantının OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine, bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Paytrail Gateway uzantısını bulun ve Install düğmesine tıklayın (yeşil + düğmesi). Yönetici kullanıcınızın ödeme uzantıları listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Uzantıyı önce denemek için Test mode seçeneğini açın. Gerçek ödemeler için kapatın ve Merchant ID ile Secret key bilgilerinizi girin. Paytrail'de bir callback URL'si ayarlamanız gerekmez.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_paytrail_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki yüklü uzantılar listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Paytrail Gateway uzantısını bulun, Install düğmesine (yeşil + düğmesi), ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve Paytrail ayarlarını OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca callback URL'si farklıdır (bkz. Siparişler).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu kapalı olarak başlar.

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Payments > VibeFox Paytrail Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Test modu açıkken, ayarların üstünde sayfa Test modu etkin. Ödemeler Paytrail'in herkese açık test hesabını kullanır — gerçek para tahsil edilmez. mesajını gösterir. Canlı modda, merchant ID veya gizli anahtar eksikse ya da merchant ID herkese açık test hesabı 375917 ise uyarır; bu durumlarda Paytrail ödeme sayfasında gösterilmez. Mağazanın varsayılan para birimi EUR değilse de uyarır: bu durumda Paytrail yalnızca müşteri EUR ile ödeyecekse gösterilir. Uzantıyı değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz ve 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve geo zone ile sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Rakam dışında bir şey içeren bir merchant ID kaydedilmez ve şu hata gösterilir:Paytrail satıcı kimliği yalnızca rakam içermelidir. Önceki değer korundu. ve diğer ayarlar kaydedilir.

Paytrail

Bölüm, Paytrail ödeme sayfası hakkında kısa bir notla ve siparişin yalnızca Paytrail ödemeyi onayladıktan sonra durum almasına ilişkin kuralla başlar.

Enable/Disable: Enable Paytrail ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterilere ödeme sırasında gösterilen başlık. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Paytrail. Zorunlu, en fazla 128 karakter.

Description: Confirm Order adımında, onay düğmesinin üstünde ve Paytrail simgesinin yanında müşteriye gösterilen metin. Varsayılan: Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

Sort Order: Paytrail'in ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Paytrail'i yalnızca seçilen geo zone içindeki ödeme adresleri için sunun. Varsayılan: All zones. Geo zone'lar System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Paytrail sunulmadan önce bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Paytrail'i her tutar için sunmak üzere boş bırakın.

API kimlik bilgileri

Satıcı kimliğiniz ve gizli anahtarınız Paytrail Merchant Panel'de (hesap veya entegrasyon ayrıntılarında) gösterilir. Bölüm Paytrail'e bağlantı içerir. Yalnızca EUR ödemeleri desteklenir.

Test mode: yeni ödemeler için kendi kimlik bilgileriniz yerine Paytrail'in herkese açık test hesabını (merchant ID 375917) kullanır. Gerçek para tahsil edilmez ve anahtar gerekmez. Müşteriler Confirm Order adımında Test modu: gerçek bir ödeme yapılmayacaktır. mesajını görür. Test hesabının gizli anahtarı herkese açıktır; bu nedenle test modunda yapılan bir ödemeyi herkes taklit edebilir. Test modunu asla canlı bir mağazada açık bırakmayın. Varsayılan: kapalı.

Merchant ID: Paytrail satıcı kimliğiniz (yalnızca rakam). Test modu kapalıyken kullanılır. Gizli anahtarın aksine, kaydettikten sonra sayfada gösterilir.

Secret key: Paytrail gizli anahtarınız. Test modu kapalıyken kullanılır. Kayıtlı anahtar bir daha asla gösterilmez. Alan boş kalır ve Kayıtlı — korumak için boş bırakın. yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı gizli anahtarı kaldırmak için alanın altındaki Clear saved secret key kutusunu işaretleyin ve Save düğmesine tıklayın.

Callback'ler ve iadeler her zaman ödemenin yapıldığı modun kimlik bilgilerini kullanır; bu nedenle test ve canlı mod arasında geçiş yapmak eski siparişleri bozmaz.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş, missing order). Sipariş, Paytrail ödemeyi onayladıktan sonra bir durum alır. Aşağıdaki her durum alanı OpenCart sipariş durumlarınızı listeler.

Callback URL: Paytrail'in her ödemeyi sunucudan sunucuya onayladığı URL'yi gösterir. OpenCart 3'te şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_paytrail_gateway/callback, OpenCart 4'te https://your-store/index.php?route=extension/wcp_paytrail_gateway/payment/wcp_paytrail_gateway.callback biçimindedir. Her ödemeyle birlikte gönderilir; bu nedenle Paytrail panelinde bir şey ayarlamanız gerekmez, ancak mağazanın internetten erişilebilir olması gerekir.

Order status after payment: ödenmiş bir siparişin durumu. Varsayılan: Processing. Ödenmiş her siparişin hemen tamamlanmasını istiyorsanız Complete seçin.

Awaiting payment status: Paytrail ödemeyi beklemede ya da gecikmeli olarak bildirir (sağlayıcının onayını bekleyen bir fatura ya da taksit). Sipariş, Paytrail ödemeyi onayladığında ya da reddettiğinde otomatik olarak güncellenir. Varsayılan: Pending.

Payment on hold status: ödeme dikkatinizi gerektiriyor (bkz. Sipariş durumları). Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Payment failed status: bekleyen bir Paytrail ödemesi başarısız olduğunda ayarlanır. Varsayılan: Failed.

Refunded status: ödeme, sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug log: API isteklerini ve callback'leri OpenCart günlükler klasöründeki (storage/logs) ptg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında ptg_debug.old.log.php dosyasına taşınır. Kişisel veriler ve anahtarlar kaydedilmez. Hatalar ve uyarılar her zaman kaydedilir. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: açıkken uzantıyı kaldırmak, ağ geçidi ayarlarını ve günlüğü siler. Uzantıyı devre dışı bırakmak asla bir şeyi silmez. Paytrail işlem verileri siparişler için her zaman korunur, çünkü eski siparişlerin iadeleri bunlara ihtiyaç duyar. Varsayılan: kapalı.

İçe Aktar / Dışa Aktar

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Satıcı kimliği ve gizli anahtar dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı satıcı kimliği ve gizli anahtar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Paytrail). Confirm Order adımında müşteri Paytrail simgesini ve açıklamanızı görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri, ödeme yöntemini ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında, uzantı sipariş tutarı için euro cinsinden bir Paytrail ödemesi oluşturur, referans olarak sipariş numarasını kullanır ve siparişin kalemlerini de gönderir: seçenekleri ve vergileriyle birlikte ürünler, satın alınan hediye kartları, kargo ve diğer ücretler. Kuponlar, mağaza kredisi, ödül puanları ve kullanılan hediye kartları kalemlere dağıtılır. Kalemler her zaman ödeme tutarına eşittir; yuvarlama farkı bir kaleme eklenir ya da Rounding kalemi olarak gönderilir. Müşterinin iletişim bilgileri gönderilir; fatura ve teslimat adresleri ise yalnızca eksiksiz olduklarında gönderilir. Ödeme sayfasının dili, müşterinin diline göre Fince, İsveççe veya İngilizcedir.

Müşteri Paytrail ödeme sayfasına yönlendirilir, Paytrail hesabınızda etkin bir ödeme yöntemi seçer ve öder. Paytrail ardından ödemeyi iki kez onaylar: müşteriyi mağazanıza geri gönderir ve callback URL'sini sunucudan sunucuya çağırır. İki onay da yalnızca o ödeme denemesinin kimlik bilgileriyle oluşturulmuş geçerli bir imzayla ve yalnızca o sipariş için oluşturulmuş bir deneme için kabul edilir. Ödenen tutar, sipariş tutarıyla karşılaştırılır. Sipariş, Paytrail'in bu şekilde onaylamasından sonra ödenmiş olarak işaretlenir ve ardından normal OpenCart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle durumunu alır. Uzantı şu Paytrail durumlarını işler:

Başarılı bir ödemeden sonra müşteri, Paytrail ödemeniz alındı. ifadesiyle OpenCart sipariş başarı sayfasını görür. Beklemedeki bir ödeme için sayfa Paytrail ödemeniz ödeme sağlayıcısı tarafından onaylanmayı bekliyor. Sipariş otomatik olarak güncellenecek — lütfen tekrar ödeme yapmayın. mesajını gösterir. Callback o anda ödemeyi kaydediyorsa, bir Payment confirmation sayfası müşteriden tekrar ödeme yapmamasını ister ve Check again seçeneğini sunar.

İptal edilmiş ya da başarısız bir ödemeden sonra müşteri Paytrail ödemesi iptal edildi veya başarısız oldu. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajıyla ödeme sayfasına döner. Ödeme henüz tamamlanmadıysa mesaj Paytrail ödemesi henüz tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. olur. Sepet korunur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Doğrulanamayan bir dönüş, Payment verification failed. ifadesiyle bir Payment Error sayfası gösterir ve hiçbir şeyi değiştirmez.

Paytrail ödemeyi başlatamazsa, müşteri Confirm Order adımında kalır ve düğmenin üstünde kısa bir mesaj görür, örneğin Paytrail'e bağlanılamadı. Lütfen birazdan tekrar deneyin., Paytrail geçici olarak kullanılamıyor. Lütfen başka bir ödeme yöntemi seçin. (hatalı kimlik bilgileri) ya da Paytrail ödemeyi başlatamadı. Lütfen fatura bilgilerinizi kontrol edip tekrar deneyin ya da başka bir ödeme yöntemi seçin. Teknik neden günlüğe yazılır. Paytrail sınırlarının dışındaki bir toplam için Bu sipariş tutarı Paytrail ile ödenemez. Lütfen başka bir ödeme yöntemi seçin. mesajı gösterilir.

OpenCart 3, Confirm Order adımı gösterildiğinde her seferinde yeni bir sipariş oluşturur, OpenCart 4 ise ödeme sayfasındaki siparişi günceller (yeni bir deneme aynı siparişi öder). Sepet zaten başka bir siparişle ödenmişse, müşteri doğrudan başarı sayfasına gider ve yeni bir ödeme başlatılmaz. Bir Paytrail ödemesi API üzerinden iptal edilemez; bu nedenle eski bir ödeme sayfası ödenebilir durumda kalır. Müşteri bunu da öderse, ikinci ödeme ödenmiş siparişte iade edilmesi gereken bir mükerrer olarak bildirilir ve diğer sipariş durumsuz kalır. Sepette yapılan her değişiklik, yeni adet dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme adımında tutar. Bu sipariş ödeme yapılmadan kapatılmışsa (örneğin siz iptal ettiyseniz), müşteri Önceki siparişiniz iptal edildi veya geri ödendi. Yeni bir siparişle ödeme yapmak için lütfen siparişi yeniden onaylayın. mesajıyla ödeme adımına geri döner. Bu siparişin bekleyen ödemesi başarısız olduysa mesaj: Paytrail ödemesi iptal edildi veya başarısız oldu. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. Bir sonraki Confirm Order yeni bir sipariş için ödeme yapar. Bu sipariş daha önceki bir sepet için zaten ödenmişse ve sepet o zamandan beri değiştiyse, müşteri ödeme adımına geri yönlendirilir ve bir sonraki Confirm Order mevcut sepetin yeni siparişi için ödeme yapar. Kapatılmış bir sipariş asla ödenmiş gibi gösterilmez.

Callback, OpenCart ödeme uzantısı isteklerine izin verdiği için mağaza bakım modundayken de çalışır (OpenCart 4'te uzantı bunun için kendi başlangıç eylemini ekler; bu eylem müşterinin Paytrail'den dönüşüne de izin verir).

Müşteri ödeme yöntemini sizin ödeme sayfanızda değil, Paytrail sayfasında seçer. Uzantının kart tokenizasyonu ya da kayıtlı kartı, aboneliği, shop-in-shop özelliği, manuel fatura etkinleştirmesi ve mutabakat raporu yoktur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Paytrail'e yönlendirildi ve ödeme yapmadı, ödeme başarısız oldu ya da Paytrail ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order status after payment (varsayılan Processing): ödeme onaylandı. Bir not; Paytrail işlemini, Paytrail'de kullanılan ödeme yöntemini ve tutarı gösterir; test ödemelerinde TEST mode — no real money. ifadesi eklenir.

Awaiting payment status (varsayılan Pending): ödeme sağlayıcıda beklemede (fatura ya da gecikmeli ödeme). Paytrail ödemeyi onayladığında sipariş ödenmiş duruma, ödeme başarısız olduğunda başarısız duruma geçer.

Payment on hold status (varsayılan Pending): ödenen tutar sipariş toplamından farklı (gerçekte ödenen tutar kaydedilir), ödeme siparişin iptal gibi başka bir duruma alınmasından sonra geldi ya da uzantı canlı moddayken bir test ödemesi alındı (gerçek para yok, iade edilecek bir şey yok). Not nedeni açıklar. Siparişi kontrol edin, ardından işleyin ya da ödemeyi iade edin.

Payment failed status (varsayılan Failed): bekleyen bir Paytrail ödemesi başarısız oldu ya da iptal edildi.

Refunded status (varsayılan Refunded): ödeme, uzantı üzerinden tamamen iade edildi.

Tekrarlanan ya da eşzamanlı callback'ler yalnızca bir kez uygulanır, çift not oluşturulmaz. Ödenmiş, iade edilmiş ya da tamamlanmış bir sipariş, sonraki bir callback ile yeniden açılmaz. Zaten ödenmiş bir siparişin ya da sepetin ikinci bir denemesi ödenirse, sipariş değiştirilmez; bir Duplicate payment notu, bunu Paytrail Merchant Panel'de iade etmenizi ister.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Paytrail Gateway sekmesi

Sales > Orders bölümünde Paytrail ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Paytrail Gateway sekmesi siparişin ödeme denemelerini listeler (tarih, Paytrail işlemi ve test ödemeleri için Test etiketli damga, tutar, ödeme yöntemi, Paytrail durumu ve sonucu), Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Paytrail notes kayıtlarını gösterir. Sekme, uzantıya erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Paytrail Gateway sekmesinde Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz sipariş notu için bir neden yazın ve Refund via Paytrail düğmesine tıklayın. Bu tutar Paytrail üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir, yalnızca tutar bazında. Uzantıyı değiştirme iznine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). Paytrail'in gerçekten tahsil ettiği tutara kadar iade yapabilirsiniz; bu nedenle tutar uyuşmazlığından sonra sınır, sipariş toplamı değil müşterinin ödediği tutardır. İade, ödemenin yapıldığı modun kimlik bilgilerini kullanır; bu nedenle canlı bir ödeme için canlı kimlik bilgilerinin ayarlı olması gerekir. İadeler, Paytrail ödemeyi onayladıktan sonra kullanılabilir.

Ödeme yöntemi doğrudan iadeleri desteklemiyorsa, uzantı otomatik olarak bir e-posta iadesi başlatır: Paytrail, müşteriden bir banka hesabı girmesi için müşteriye e-posta gönderir. Bunun için siparişte müşterinin e-posta adresi olmalıdır. Not, başlatılan iade türünü belirtir.

Bir iade hemen tamamlanabilir ya da daha sonra işlenebilir. Paytrail'in sonradan yaptığı onay bir not olarak eklenir. Paytrail iadeyi tamamlayamazsa, bir not paranın müşteriye iade edilmediğini bildirir ve iade artık iade edilmiş sayılmaz; müşteriye parayı başka bir yolla geri gönderin. Paytrail iadeyi hemen reddederse, sekme hatayı gösterir ve hiçbir iade kaydedilmez. Tam iade, siparişi müşteriye bildirilmeden ve ürünler stoğa geri eklenmeden Refunded status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez.

Sales > Returns bölümündeki ürün iadeleri Paytrail üzerinden para geri göndermez. Paytrail Merchant Panel'de yapılan iadeler OpenCart ile eşitlenmez.

Lisans anahtarı

Uzantı, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Paytrail Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Paytrail Gateway > Edit sayfasında, ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: opencart-payment-paytrail satırı ve hesabınızda vibefox.net üzerinden açılan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca uzantı için Modify iznine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse, blok nedenini belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached ya da bir tarihle birlikte License expired on. Mağaza adresi değiştikten veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa, uzantı son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresinde. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Paytrail, ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa, müşteri This payment method is not available. Please choose another one. mesajını görür. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce uzantıyı kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetici paneli Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: başlatılmış ödemeler callback'ler ve müşterinin dönüşü ile yine onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici paneli Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Uzantı kaldırıldığında lisans anahtarı ve lisans durumu her zaman silinir.

Sorun giderme

Paytrail ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve ya Test mode seçeneğinin açık olduğunu ya da Merchant ID ile Secret key alanlarının dolu olduğunu (ve herkese açık test hesabı 375917'nin girilmediğini) kontrol edin. Müşterinin EUR ile ödediğini, ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin. Ayarlar sayfası eksik kimlik bilgileri ve EUR dışındaki mağaza para birimi için uyarı gösterir.

Ödeme yapıldı, ancak sipariş durumsuz kalıyor: callback mağazanıza ulaşamıyor ve müşteri mağazaya geri dönmedi. Orders bölümünde gösterilen Callback URL internetten erişilebilir olmalıdır (aradaki temel kimlik doğrulama ya da güvenlik duvarı olmamalıdır).

Callback ya da dönüş Payment verification failed. yanıtı veriyor: imza geçersiz ya da ödeme siparişin hiçbir ödeme denemesine ait değil. Hiçbir şey değişmez. Secret key değerinin doğru olduğunu ve Merchant ID ile eşleştiğini kontrol edin.

Callback Temporarily unavailable yanıtı veriyor: sipariş aynı anda başka bir istek tarafından onaylanıyordu ya da sipariş durumu ayarlanamadı. Paytrail yeniden çağırır. Nedeni görmek için Log alanına bakın.

Müşteri Confirm Order sonrasında bir hata görüyor: uzantı sayfasındaki Log alanına bakın. Örneğin Paytrail API error (401) hatalı kimlik bilgileri anlamına gelir. Ayrıntılar için Debug log seçeneğini açın. This payment method is not available. Please reload the checkout page. mesajı, ödeme yönteminin bu arada kapatıldığı ya da ödeme sayfasının artık siparişle eşleşmediği anlamına gelir.

Merchant ID kaydedilmiyor: yalnızca rakam içermelidir. Paytrail Merchant Panel'den yeniden kopyalayın.

Sipariş on hold durumunda: VibeFox Paytrail Gateway sekmesindeki notları okuyun. Neden, farklı bir ödenen tutar, durum değişikliğinden sonra gelen bir ödeme ya da canlı moddaki bir test ödemesi olabilir.

İade başarısız oluyor: mesajı okuyun. This order has no confirmed Paytrail payment. Refund it manually. iade edilecek onaylanmış bir Paytrail ödemesi olmadığı anlamına gelir. The live Paytrail credentials used for this payment are missing. Enter them in the Paytrail settings. ödemenin canlı modda yapıldığı ve canlı kimlik bilgilerinin girilmediği anlamına gelir. Invalid refund amount: at most … tutarın, iade edilecek kalan tutardan büyük olduğu anlamına gelir. This payment method supports only e-mail refunds, but the order has no billing e-mail. siparişin müşterinin e-posta adresine ihtiyaç duyduğu anlamına gelir.

Geliştiriciler için: ödeme isteği imzalanıp gönderilmeden önce uzantı, OpenCart ptg_payment_request olayını isteği ve siparişi ile birlikte tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Paytrail Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, uzantının kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Uzantının OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda callback ile müşteri dönüşüne izin veren başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa, diğer ağ geçidi ayarları (başlık, açıklama, test modu, satıcı kimliği, gizli anahtar, günlükleme) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için korunurlar. Paytrail işlemleri ve iadeleri her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te uzantının dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, yüklü uzantılar listesinde VibeFox Paytrail Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

Paytrail, ilgili sahibinin tescilli markasıdır. Bu uzantı Paytrail ile bağlantılı değildir ve Paytrail tarafından onaylanmamıştır.