VibeFox ECPay for OpenCart — Yardım

Gereksinimler

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

PHP: 8.0 veya üzeri.

Para birimi: Yeni Tayvan doları (TWD). ECPay yalnızca TWD ile tahsilat yapar, bu nedenle ödeme yöntemi yalnızca müşteri TWD ile ödeme yaptığında gösterilir. Mağazanızda TWD yoksa, System > Localisation > Currencies bölümünde TWD kodu ile ekleyin. ECPay ondalıklı tutarları kabul etmediği için tutarlar tam TWD olarak gönderilir: sipariş toplamları en yakın dolara yuvarlanır. Yuvarlamadan kaçınmak için TWD için 0 ondalık basamak kullanın.

ECPay hesabı: canlı ödemeler için ECPay satıcı hesabınızın MerchantID, HashKey ve HashIV bilgilerine ihtiyacınız vardır. Bunları ECPay satıcı yönetim panelinden (vendor.ecpay.com.tw) alabilirsiniz. Test için ECPay hesabı gerekmez.

Site erişimi: ECPay ödeme bildirimlerini iletebilmesi için mağazanız internetten HTTP/HTTPS üzerinden 80/443 numaralı bağlantı noktasında erişilebilir olmalıdır. Sitenin önündeki bir güvenlik duvarı veya temel kimlik doğrulama bu bildirimleri engeller.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_ecpay_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_ecpay_payment_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_ecpay_payment_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine, bu paketteki 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 olarak Payments seçin. VibeFox ECPay Payment Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) 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. Enable/Disable seçeneğini açın, ödeme yöntemlerini seçin ve ilk testleriniz için Test Mode seçeneğini açık bırakın. Save düğmesine tıklayın.

5. Canlı ödemeler için Merchant ID, Hash Key ve Hash IV bilgilerini girin (bkz. Yapılandırma), Test Mode seçeneğini kapatın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_ecpay_payment_gateway.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler 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 olarak Payments seçin. VibeFox ECPay Payment Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 3 ila 5. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Ödeme bildirimleri).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar. Bildirim URL'si her ödemeyle birlikte gönderilir, bu nedenle ECPay tarafında bir şey yapılandırmanız gerekmez.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa; mağazanızın varsayılan para birimi TWD değilse ve etkin bir TWD para birimi yoksa bir hata gösterir (bu durumda ECPay ödeme sayfasında görünmez), TWD yalnızca ikinci para birimiyse bir uyarı gösterir (bu durumda ECPay yalnızca TWD ile ödeme yapan müşterilere gösterilir). Canlı modda MerchantID, HashKey veya HashIV yoksa bir hata gösterir. Test modu açıkken, ödemelerin genel test satıcısı 3002607 ile ECPay sandbox ortamına gittiğini, hiçbir paranın tahsil edilmediğini ve ECPay sandbox genel anahtarlarını bilen herkesin test siparişlerini onaylayabileceğini uyarır; bu nedenle gerçek siparişleri kabul etmeden önce test modu kapatılmalıdır. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title alanı boş olamaz (en fazla 128 karakter), Sort Order tam sayı olmalı ve Total 0 veya daha büyük bir sayı olmalıdır; aksi halde hiçbir şey kaydedilmez. Diğer düzeltmeler, ayarların üstünde bir mesajla kaydedilir (aşağıdaki alanlara bakın).

ECPay (綠界)

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: ECPay (綠界). Zorunlu.

Description: müşteriye Confirm Order adımında gösterilen metin. Varsayılan: Pay securely via ECPay (Credit Card, ATM, CVS, Barcode).

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

Geo Zone: ECPay'i yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde tanımlanır.

Total: ECPay'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki sepet toplamı. ECPay'i her toplam tutarda sunmak için boş bırakın.

ECPay hesabı

MerchantID, HashKey ve HashIV bilgilerinizi ECPay satıcı yönetim panelinde (vendor.ecpay.com.tw), System development management > System integration settings (系統開發管理 > 系統介接設定) altında bulabilirsiniz.

Test Mode: ödemeleri, ECPay'in genel test satıcısı 3002607 ile ECPay sandbox ortamına (payment-stage.ecpay.com.tw) gönderir. Gerçek para tahsil edilmez. Aşağıdaki kimlik bilgileri yalnızca test modu kapalıyken kullanılır. Varsayılan: açık. Açıkken müşteriler Confirm Order adımında TEST MODE — ECPay sandbox, no real money is charged. ifadesini görür.

Merchant ID: ECPay Merchant ID'niz (canlı ortam). Test modunda yok sayılır.

Hash Key: ECPay Hash Key'iniz (canlı ortam). Test modunda yok sayılır.

Hash IV: ECPay Hash IV'iniz (canlı ortam). Test modunda yok sayılır.

Yapıştırılan kimlik bilgilerindeki boşluklar ve satır sonları her imzayı bozar; bu nedenle kaydetme sırasında kaldırılırlar ve sayfa bunu size bildirir. Kayıtlı bir Hash Key ve Hash IV bir daha gösterilmez: alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir değeri silmek için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme seçenekleri

Enabled Payment Methods: müşterilere sunulan ödeme yöntemleri. Birden fazla yöntem varsa müşteri Confirm Order adımında seçim yapar. ATM, CVS ve Barcode siparişleri, müşteri ödeme yapana kadar bekleme durumunda kalır. En az bir yöntem seçilmelidir; hiçbiri seçilmezse Credit Card etkinleştirilir ve sayfa bunu size bildirir. Varsayılan: Credit Card.

Default Payment Method: önceden seçili ödeme yöntemi. Etkin yöntemlerden biri olmalıdır; aksi halde ilk etkin yöntem kullanılır. Varsayılan: Credit Card.

Order Prefix: ECPay işlem numarasının (MerchantTradeNo) önekidir; en fazla 5 harf veya rakam. Diğer karakterler kaydetme sırasında bir mesajla kaldırılır. Birden fazla mağaza aynı ECPay hesabını paylaşıyorsa yararlıdır: her mağazaya kendi önekini verin. Varsayılan: EC.

Ödeme bildirimleri

ECPay, ödeme sonuçlarını ve ATM, CVS ile barkod bilgilerini mağazanıza gönderir. Bu bölüm Notification URL adresini gösterir. OpenCart 3'te adres şuna benzer: https://your-store/index.php?route=extension/payment/wcp_ecpay_payment_gateway/notify, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_ecpay_payment_gateway/payment/wcp_ecpay_payment_gateway.notify. URL her ödemeyle birlikte gönderilir, bu nedenle ECPay'de bir şey yapılandırmanız gerekmez; ancak internetten 80/443 numaralı bağlantı noktası üzerinden erişilebilir olmalıdır ve önünde güvenlik duvarı veya temel kimlik doğrulama bulunmamalıdır. Bakım modu bu URL'yi engellemez.

Her bildirim, ödemenin başlatıldığı ortamın (test veya canlı) anahtarlarıyla CheckMacValue imzası üzerinden ve bu ödemenin MerchantID değeriyle kontrol edilir. Geçerli imzası olmayan bildirimler reddedilir ve ECPay bunları yeniden gönderir. Bildirim olmadan sipariş bir durum almaz; ödemeyi ECPay satıcı yönetim panelinden kontrol edin.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş yalnızca imzalı ECPay bildiriminden bir durum alır. Başarısız veya terk edilmiş bir kart ödemesi siparişi durumsuz bırakır ve müşteri yeniden ödeme yapabilir. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Payment accepted: ECPay ödemeyi beklenen tutarla onayladığında ayarlanan durum. Varsayılan: Processing.

Awaiting ECPay payment: müşteri bir ATM sanal hesabı, CVS ödeme kodu veya barkod aldığında ve ödemeyi sonra ATM'de veya mağazada yaptığında ayarlanan durum. Varsayılan: Pending.

ECPay payment on hold: ECPay farklı bir tutar veya para birimi bildirdiğinde, canlı modda bir sandbox ödemesi geldiğinde veya sipariş durumu değiştirildikten sonra (örneğin iptal edildikten sonra) ödeme geldiğinde ayarlanan durum. Sipariş notu nedenini açıklar. 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 error: bekleyen bir siparişin en son ATM, CVS veya barkod ödemesi başarısız olduğunda ayarlanan durum. Varsayılan: Failed.

Gelişmiş

Enable Logging: sipariş numaralarını, işlem numaralarını, tutarları ve ECPay dönüş kodlarını OpenCart günlük klasöründeki (storage/logs) ecpay_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında ecpay_p_debug.old.log.php dosyasına taşınır. Anahtarlar veya müşteri verileri kaydedilmez. Hatalar bu anahtar kapalı olsa bile 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çıksa, eklentiyi kaldırdığınızda ayarları ve günlük silinir. ECPay ödeme kayıtları her zaman saklanır, böylece yeniden kurulumdan sonra mevcut siparişler çalışmaya devam eder. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Hash Key ve Hash IV 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ı Hash Key ve Hash IV korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak ECPay (綠界)). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the ECPay payment page to complete the payment. notunu görür. Birden fazla yöntem etkinse müşteri ayrıca Payment Method altında Credit Card, ATM (Virtual Account), CVS (Convenience Store) veya Barcode seçeneklerinden birini seçer. 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 sayfanın altındaki Confirm Order düğmesine tıklar; ECPay yönteminin seçimi bu düğmenin üstünde gösterilir.

Müşteri Confirm Order düğmesine tıkladığında sayfa Redirecting to ECPay for payment. Please wait... mesajını gösterir ve müşteriyi ECPay ödeme sayfasına yönlendirir. Sipariş toplamı, ürünlerin adları ve adetleriyle birlikte tam TWD olarak gönderilir. ECPay sayfası; Tayvan ve Hong Kong dilleri için geleneksel Çince, bu diller için basitleştirilmiş Çince, Korece veya Japonca olarak, diğer tüm diller için İngilizce olarak açılır; müşterinin mağaza diline göre belirlenir.

Sipariş yalnızca ECPay imzalı bir sunucu bildirimiyle onayladıktan sonra ödenmiş olarak işaretlenir. Ardından sipariş, her zamanki OpenCart yöntemiyle durum alır; normal sipariş e-postaları gönderilir ve stok güncellenir. Müşteri ECPay sayfasındaki mağazaya dön bağlantısına tıkladığında ve siparişin zaten bir durumu varsa OpenCart sipariş başarı sayfası açılır. Ödenmiş bir sipariş için Your ECPay payment has been received., bekleme durumundaki bir sipariş için Your ECPay payment was received and is being reviewed by the store. mesajını ve bekleyen bir ATM, CVS veya Barcode siparişi için ödeme talimatlarını gösterir. Bildirim henüz gelmediyse, Payment confirmation sayfası We have not received a payment confirmation from ECPay for this order yet. Your order will be confirmed as soon as ECPay confirms the payment. mesajını ve Check again ile Back to checkout düğmelerini gösterir. ECPay ödemenin başarısız olduğunu bildirdiyse müşteri ödeme sayfasına geri döner ve The payment was not completed. You can try again or choose another payment method. mesajını görür. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Sepet korunur.

ATM, CVS ve Barcode için müşteri önce ödeme bilgilerini alır. Sipariş Awaiting ECPay payment durumunu alır; banka kodu ve sanal hesap, market ödeme kodu veya barkodlar, tutar ve Pay before tarihi, sipariş başarı sayfasında ECPay payment instructions altında gösterilir; giriş yapmış bir müşteri için bu bilgiler müşteri hesabındaki sipariş bilgilerinde de yer alır. Müşteri ödeme yaptığında ECPay başka bir bildirim gönderir ve sipariş ödenmiş olarak işaretlenir. Ödeme talimatları OpenCart e-postalarına eklenmez.

Her deneme yeni bir ECPay işlem numarası oluşturur, çünkü ECPay daha önce kullanılmış numaraları reddeder. Bu nedenle başarısız bir ödemeden sonraki yeniden denemeler çalışır; müşteri tarayıcıda geri gidip yeniden Confirm Order düğmesine tıklarsa yeni bir deneme başlatılır. Bir sepet en fazla 30 ödeme denemesine sahip olabilir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ödeme sayfası için tek bir sipariş tutar ve onu günceller, yeni deneme ise yeni bir ECPay işlem numarası alır; aynı sepetteki başka bir sipariş zaten ödenmişse veya ATM ya da CVS ödemesini bekliyorsa, müşteri başarı sayfasına gider ve yeni bir ödeme başlatılmaz.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu sipariş ödeme yapılmadan bu arada kapatılmışsa (örneğin ATM veya CVS ödemesi başarısız olduysa ya da siz iptal ettiyseniz), müşteri Your previous order was cancelled or its payment failed. Please confirm the order again. mesajıyla ödeme sayfasına geri gönderilir ve sonraki Confirm Order sepet için yeni bir sipariş öder. Sipariş zaten ödenmişse (veya ATM ya da mağaza ödemesini bekliyorsa) ve sepet o zamandan beri değiştiyse, miktar dahil, mesaj Your previous order is already paid (or awaits its ATM / convenience store payment). Please confirm the order again: the cart will be paid with a new order. olur. Ödenmiş bir sipariş, farklı bir sepet için asla ödenmiş gibi gösterilmez.

Ödeme başlatılamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde kısa bir mesaj görür; örneğin yuvarlamadan sonra toplam 1 TWD'nin altındaysa The order total is too small for ECPay. Yönteme özgü ECPay tutar sınırları ödeme sayfasında kontrol edilir, ödeme adımında değil.

Ödemesi zaten başlatılmış olanların bildirimleri, ödeme yöntemini kapatsanız bile kabul edilir ve müşteri, daha önce verilmiş siparişlerin ödeme talimatlarını görmeye devam eder.

Eklenti yalnızca ECPay sayfasındaki tek seferlik ödemeleri kabul eder. OpenCart'tan iade, kayıtlı kart, abonelik veya periyodik ödeme (定期定額), taksit, Apple Pay, e-fatura veya lojistik desteği yoktur ve sunucu tarafında durum sorgulama yoktur: mağazanız bildirimi alamıyorsa ödemeyi ECPay satıcı yönetim panelinden kontrol edin.

Siparişler

Sipariş durumları

No status (missing order): müşteri ECPay'e yönlendirildi ve ödeme yapmadı, kart ödemesi başarısız oldu veya bildirim henüz gelmedi. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Awaiting ECPay payment (default Pending): müşteri ATM, CVS veya Barcode seçti ve ödeme bilgilerini aldı. Not; banka kodunu ve sanal hesabı, ödeme kodunu veya barkodları ve son ödeme tarihini gösterir.

Payment accepted (default Processing): ödeme onaylandı. Bir not; ECPay TradeNo'yu, ödeme türünü, tutarı ve işlem numarasını gösterir (sandbox ödemeleri için bir test modu işaretiyle birlikte).

ECPay payment on hold (default Pending): ECPay, siparişten farklı bir tutar veya para birimi bildirdi (örneğin ödeme başladıktan sonra sepet başka bir sekmede değiştirildi), canlı moda geçtikten sonra bir sandbox ödemesi geldi (gerçek para tahsil edilmedi) veya siparişin durumunu değiştirdikten sonra, örneğin iptal ettikten sonra ödeme geldi. Not bunu açıklar. ECPay satıcı yönetim panelinde karşılaştırın, ardından siparişi tamamlayın veya ödemeyi orada iade edin.

Payment error (default Failed): ECPay, bekleyen bir siparişin en son ATM, CVS veya barkod ödemesinin başarısız olduğunu bildirdi. Not; ECPay dönüş kodunu ve mesajını gösterir.

Tekrarlanan bildirimler yok sayılır. Ödenmiş bir sipariş, geç gelen bir başarısızlıkla asla yeniden açılmaz. Zaten ödenmiş bir siparişe ait ikinci bir ödeme, örneğin iki tarayıcı sekmesinden yapılmışsa, bir kez not olarak kaydedilir; böylece bunu ECPay satıcı yönetim panelinde iade edebilirsiniz. ECPay satıcı yönetim panelinden başlatılan simüle edilmiş ödemeler yalnızca not olarak kaydedilir ve hiçbir zaman bir siparişi ödenmiş olarak işaretlemez, çünkü ECPay bunlar için para tahsil etmez.

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

VibeFox ECPay Payment Gateway sekmesi

Sales > Orders bölümünde ECPay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox ECPay Payment Gateway sekmesi siparişin her ödeme denemesini listeler: sandbox denemeleri için Test mode etiketli MerchantTradeNo, yöntem, TWD cinsinden tutar, durum, ECPay TradeNo, ödeme türü ve tarihi, ECPay dönüş kodu ve başlangıç tarihi. Altında siparişin ECPay notes kayıtları yer alır. Bekleme durumundaki bir sipariş için sekme, bunu ECPay satıcı yönetim paneliyle karşılaştırmanızı hatırlatır. Sekme salt okunurdur ve eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

OpenCart üzerinden iade yapılamaz. Ödemeyi ECPay satıcı yönetim panelinde iade edin, ardından OpenCart'ta sipariş durumunu elle güncelleyin. Sales > Returns bölümündeki ürün iadeleri ECPay üzerinden para göndermez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarı ile çalışır. License — VibeFox ECPay Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarihi 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. Altında Product: opencart-payment-ecpay satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı yer alır. Anahtarı yalnızca eklenti 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 söyler; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihle birlikte License expired on. Mağaza adresi değiştikten sonra 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar 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 ECPay, ö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önetim 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 eklentiyi 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önetim paneli Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün boyunca gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim 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. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

ECPay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, müşterinin TWD ile ödeme yaptığını ve canlı modda Merchant ID, Hash Key ve Hash IV alanlarının dolu olduğunu kontrol edin. Ayarlar sayfası para birimi ve canlı kimlik bilgileri için bir mesaj gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kaldı: ECPay bildirimi mağazanıza ulaşmadı (site kapalı, güvenlik duvarı, temel kimlik doğrulama). ECPay birkaç kez yeniden dener. İşlemi ECPay satıcı yönetim panelinde de kontrol edebilirsiniz. Eklentinin aldığı bildirimleri görmek için Enable Logging seçeneğini açın; reddedilen bildirimler her durumda hata olarak kaydedilir.

Bildirim 0|CheckMacValue verification failed ile yanıt veriyor: Hash Key veya Hash IV ECPay hesabınızla eşleşmiyor ya da ödeme diğer ortamda başlatılmış. Bunları ECPay satıcı yönetim panelinden yeniden kopyalayın.

Bildirim 0|MerchantID mismatch ile yanıt veriyor: bildirim, ödemenin başlatıldığı satıcıdan farklı bir ECPay satıcısına ait.

Bildirim 0|Order not found ile yanıt veriyor: işlem numarası bu mağaza tarafından üretilmedi; örneğin birden fazla mağaza aynı ECPay hesabını paylaşıyorsa. Her mağazaya kendi Order Prefix değerini verin.

Bildirim 0|Retry ile yanıt veriyor: sipariş aynı anda başka bir bildirim tarafından işleniyordu veya sipariş durumu ayarlanamadı. ECPay bildirimi yeniden gönderir. Nedenini görmek için Enable Logging seçeneğini açın.

Bildirim URL'si 0|Method not allowed in the browser gösteriyor: bu normaldir. URL yalnızca ECPay'den gelen istekleri kabul eder.

Müşteri This payment method is not available. Please reload the checkout page. mesajını görüyor: ödeme oturumu artık siparişle eşleşmiyor veya bu sırada ödeme yöntemi kapatıldı. Müşteri ödeme sayfasını yeniden yüklemelidir.

Müşteri The order total is too small for ECPay. mesajını görüyor: sipariş toplamı yuvarlamadan sonra 1 TWD'nin altında ve ECPay ile ödenemez.

Müşteri Too many payment attempts for this order mesajını görüyor: sepet 30 ödeme denemesine ulaştı. Müşteriden yeni bir sepet başlatmasını isteyin.

Sipariş bekleme durumunda: VibeFox ECPay Payment Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları), ECPay satıcı yönetim paneliyle karşılaştırın, ardından siparişi tamamlayın veya ödemeyi orada iade edin.

Geliştiriciler için: ödeme formu ECPay'e gönderilmeden önce eklenti, parametreler ve sipariş ile birlikte ecpay_p_request_params OpenCart olayını tetikler; satıcı, işlem numarası ve tutar bu olay aracılığıyla değiştirilemez.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox ECPay Payment Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin 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. Eklentinin OpenCart olayları da kaldırılır (OpenCart 4'te ayrıca olayları ve bildirimin bakım modundan geçmesini sağlayan başlangıç eylemi kaldırılır). Delete Data on Uninstall açıksa, diğer ayarlar (başlık, açıklama, test modu, kimlik bilgileri, ödeme seçenekleri, günlükleme) ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. ECPay ödeme kayıtları her zaman saklanır; bu nedenle eski ödemelere ait geç gelen bildirimler yeniden kurulumdan sonra da kontrol edilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te yüklenen dosyaları da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox ECPay Payment 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.

ECPay, ilgili sahibinin ticari markasıdır. Bu eklenti ECPay ile bağlantılı değildir ve ECPay tarafından onaylanmamıştır.