VibeFox ECPay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

Para birimi: yeni Tayvan doları (TWD). ECPay yalnızca TWD tahsil eder, bu nedenle ödeme yöntemi yalnızca müşterinin sepeti TWD olduğunda gösterilir. Mağazanızda yoksa International > Localization > Currencies bölümünden TWD ekleyin. ECPay ondalık kabul etmediği için tutarlar tam TWD olarak gönderilir: sepet toplamları en yakın dolara yuvarlanır. Yuvarlamayı önlemek için TWD fiyatlarında 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ı arka ofisinden (vendor.ecpay.com.tw) alabilirsiniz. Test için ECPay hesabı gerekmez.

Site erişimi: ECPay ödeme bildirimlerini gönderebilmesi için mağazanız internetten HTTP/HTTPS üzerinden 80/443 portunda erişilebilir olmalıdır. Sitenin önündeki bir güvenlik duvarı veya temel kimlik doğrulama bunları engeller.

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

Kurulum

1. Arka ofiste Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox ECPay Payment Gateway öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üst kısmındaki lisans bloğunda VibeFox lisans anahtarınızı License key alanına girin 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.

Kurulum sırasında modül iki sipariş durumu oluşturur: Awaiting ECPay payment ve ECPay payment on hold. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz; TWD modül için izinli kalmalıdır.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox ECPay Payment Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, mağazanızda TWD para birimi yoksa bir hata (bu durumda ECPay ödeme sayfasında görünmez) veya varsayılan para birimi TWD değilse bir uyarı (bu durumda ECPay yalnızca TWD ile ödeme yapan müşterilere gösterilir) gösterir. Canlı modda MerchantID, HashKey ve HashIV eksikse bir hata gösterir. Test modu açıkken, ödemelerin herkese açık 3002607 test satıcısıyla ECPay sandbox'ına gittiğini, hiçbir paranın tahsil edilmediğini ve herkese açık sandbox 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.

ECPay (綠界)

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

Title: müşterilerin ödeme sırasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: ECPay (綠界). Zorunlu: sayfa boş başlıkla kaydedilmez.

Description: ödeme sırasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via ECPay (Credit Card, ATM, CVS, Barcode).

ECPay hesabı

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

Test Mode: ödemeleri, herkese açık ECPay test satıcısı 3002607 ile ECPay sandbox'ına (payment-stage.ecpay.com.tw) gönderir. Gerçek para yoktur. Aşağıdaki bilgiler yalnızca test modu kapalıyken kullanılır. Varsayılan: açık. Açıkken müşteriler ödeme yönteminin altında TEST MODE — ECPay sandbox, no real money is charged. ifadesini görür.

Merchant ID: ECPay Merchant ID'niz (canlı). Test modunda dikkate alınmaz.

Hash Key: ECPay Hash Key'iniz (canlı). Test modunda dikkate alınmaz.

Hash IV: ECPay Hash IV'iniz (canlı). Test modunda dikkate alınmaz.

Yapıştırılan bilgilerdeki 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ı 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.

Clear saved secrets: silmek için Hash Key veya Hash IV kutusunu işaretleyin ve Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Ödeme seçenekleri

Enabled Payment Methods: müşterilere sunulan yöntemler. Birden fazla yöntem varsa müşteri ödeme sırasında seçim yapar. ATM, CVS ve barkod siparişleri, müşteri ödeme yapana kadar Awaiting ECPay payment durumunda kalır. En az bir yöntem seçilmelidir; hiçbiri seçilmezse Credit Card etkinleştirilir ve sayfa bunu bildirir. Varsayılan: Credit Card.

Default Payment Method: önceden seçili yöntem. Etkinleştirilmiş yöntemlerden biri olmalıdır; aksi halde etkinleştirilmiş ilk yöntem kullanılır. Varsayılan: Credit Card.

Order Prefix: ECPay işlem numarasının (MerchantTradeNo) öneki, en fazla 5 harf veya rakam. Diğer karakterler kaydedilirken bir mesajla birlikte kaldırılır. Birden fazla mağaza aynı ECPay hesabını paylaştığında kullanışlıdır: her mağazaya kendi önekini verin. Varsayılan: EC.

Ödeme bildirimleri

ECPay, ödeme sonuçlarını mağazanıza gönderir. Bu bölüm Notification URL adresini gösterir. Dost URL'lerle şöyle görünür: https://your-shop/module/wcp_ecpay_payment_gateway/notify, bazen /en/ gibi bir dil koduyla. URL her ödemeyle birlikte gönderildiği için ECPay'de bir şey yapılandırmanız gerekmez; ancak internetten 80/443 portunda erişilebilir olmalı ve önünde güvenlik duvarı veya temel kimlik doğrulama bulunmamalıdır. Mağazanızın bakım modu ve ülke kısıtlaması bunu engellemez.

Her bildirim, ödemenin başlatıldığı ortamın (test veya canlı) anahtarlarıyla CheckMacValue imzası ve o ödemenin MerchantID'si üzerinden doğrulanır. Geçerli imzası olmayan bildirimler reddedilir ve ECPay bunları yeniden gönderir. Bildirim olmadan sipariş oluşturulmaz; ödemeyi ECPay arka ofisinde kontrol edin.

Gelişmiş

Enable Logging: sipariş kimliklerini, işlem numaralarını, tutarları ve ECPay dönüş kodlarını modül klasöründeki logs/ecpay_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtar veya müşteri verisi kaydedilmez. Bu anahtar kapalı olsa bile hatalar 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 modülü kaldırmak ayarlarını ve günlüğü siler. ECPay ödeme kayıtları ve sipariş durumları her zaman korunur; böylece mevcut siparişler yeniden kurulumdan sonra da çalışmaya devam eder. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak ECPay (綠界)). Birden fazla yöntem etkinse müşteri ayrıca Payment Method altında Credit Card, ATM (Virtual Account), CVS (Convenience Store) veya Barcode seçer.

Onaylandıktan sonra müşteri Redirecting to ECPay for payment. Please wait... ifadesini görür ve ECPay ödeme sayfasına yönlendirilir; yönlendirme başlamazsa diye Proceed to ECPay düğmesi bulunur. Sepet toplamı, ürün 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 açılır ve müşterinin mağaza diline uyar. Bu noktada henüz bir sipariş yoktur.

Sipariş yalnızca ECPay imzalı bir sunucu bildirimiyle onayladıktan sonra oluşturulur. Müşteri ECPay sayfasındaki mağazaya dön bağlantısına tıkladığında ve sipariş zaten varsa standart sipariş onay sayfası açılır. Bu sayfa, ödenmiş bir sipariş için Your ECPay payment has been received., incelemede olan bir sipariş için Your ECPay payment was received and is being reviewed by the store. ve bekleyen bir ATM, CVS veya barkod siparişi için ödeme talimatlarını gösterir. Bildirim henüz gelmediyse bir Payment confirmation sayfası, We have not received a payment confirmation from ECPay for this order yet. Your order will be created as soon as ECPay confirms the payment. ifadesini ve Check again ile Back to checkout düğmelerini gösterir. ECPay ödemenin başarısız olduğunu bildirdiyse müşteri The payment was not completed. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Sepet korunur.

ATM, CVS ve barkod için müşteri önce ödeme bilgilerini alır. Sipariş Awaiting ECPay payment durumunda oluşturulur; banka kodu ve sanal hesap, kolay market ödeme kodu veya barkodlar, tutar ve Pay before tarihi, sipariş onay sayfasında ve müşterinin sipariş ayrıntılarında ECPay payment instructions altında gösterilir. Müşteri ödeme yaptığında ECPay başka bir bildirim gönderir ve sipariş ödenmiş olarak işaretlenir. Ödeme talimatları PrestaShop e-postalarına eklenmez.

Her deneme yeni bir ECPay işlem numarası oluşturur, çünkü ECPay yeniden kullanılan numaraları reddeder. Bu nedenle başarısız bir ödemeden sonraki yeniden denemeler çalışır; müşteri tarayıcıda yönlendirme sayfasına geri dönerse yeni bir deneme başlatılır. Bir sepet en fazla 30 ödeme denemesine sahip olabilir. Sepetin bir siparişi olduktan sonra ödeme sayfası üzerinden tekrar ödenemez; bekleyen bir ATM veya CVS siparişi, zaten verilmiş olan bilgilerle ödenir.

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

Modül tek seferlik ödemeleri yalnızca ECPay sayfasında kabul eder. PrestaShop'tan iade, kayıtlı kart, abonelik veya periyodik ödeme (定期定額), taksit, Apple Pay, TWQR, WeChat Pay, BNPL, WebATM, e-fatura veya lojistik desteği yoktur ve sunucu tarafında durum sorgulama yapılmaz: mağazanız bildirimi alamıyorsa ödemeyi ECPay arka ofisinde kontrol edin.

Siparişler

Sipariş durumları

No order yet: müşteri ECPay'e yönlendirildi ve henüz ödeme yapmadı ya da bildirim henüz gelmedi. Yalnızca sepet vardır.

Awaiting ECPay payment: müşteri ATM, CVS veya barkodu seçti ve ödeme bilgilerini aldı. Not, banka kodunu ve sanal hesabı, ödeme kodunu veya barkodları ve son tarihi gösterir.

Payment accepted: ödeme onaylandı. Ödeme, işlem kimliği olarak ECPay TradeNo ile kaydedilir; bir not TradeNo'yu, ödeme türünü, tutarı ve işlem numarasını gösterir (sandbox ödemeleri için test modu işaretiyle).

ECPay payment on hold: ECPay, sepetten 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 ödeme sipariş iptal edildikten sonra geldi (bu durumda ödeme kaydedilir). Not bunu açıklar. ECPay arka ofisiyle karşılaştırın, ardından siparişi tamamlayın veya ödemeyi orada iade edin.

Payment error: ECPay, bekleyen bir siparişin 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ş, iade edilmiş veya iptal edilmiş bir sipariş, geç gelen bir başarısızlıkla asla yeniden açılmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme (örneğin iki tarayıcı sekmesinden) bir kez not olarak kaydedilir, böylece ECPay arka ofisinde iade edebilirsiniz. ECPay arka ofisinden başlatılan simüle ödemeler yalnızca not edilir ve bir siparişi asla ödenmiş olarak işaretlemez, çünkü bunlar için ECPay para tahsil etmez.

ECPay ödeme bloğu

Sipariş sayfası, siparişin her ödeme denemesini içeren bir ECPay payment bloğu gösterir: sandbox denemeleri için Test mode rozetiyle MerchantTradeNo, yöntem, TWD cinsinden tutar, durum, ECPay TradeNo, ödeme türü ve tarih, ayrıca ECPay dönüş kodu. Bunların altında siparişin ECPay notes bölümü bulunur. ECPay payment on hold durumundaki bir sipariş için blok, bunu ECPay arka ofisiyle karşılaştırmanızı hatırlatır.

İadeler

PrestaShop'tan iade yapılamaz. Ödemeyi ECPay arka ofisinde iade edin, ardından siparişi PrestaShop'ta elle güncelleyin. Sipariş sayfasındaki standart PrestaShop iade düğmeleri ECPay üzerinden para geri göndermez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox ECPay Payment Gateway lisans bloğu, Modules > Module Manager > VibeFox ECPay Payment Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş 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: presta-payment-ecpay satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modülün Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri arka ofis dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya bir 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. 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. PrestaShop vitrini, arka ofise giriş yaptığınızı bilmediği için ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Arka ofiste çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu 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 sepetinin TWD'de olduğunu ve canlı modda Merchant ID, Hash Key ve Hash IV alanlarının dolu olduğunu kontrol edin. Ayarlar sayfası bu durumların her biri için bir mesaj gösterir. Payment > Preferences bölümünde modülün TWD, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme tamamlandı ama sipariş oluşturulmadı: ECPay bildirimi mağazanıza ulaşamadı (site kapalı, güvenlik duvarı, temel kimlik doğrulama). ECPay birkaç kez yeniden dener. İşlemi ECPay arka ofisinde de kontrol edebilirsiniz. Modülün 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ıldı. Bunları ECPay arka ofisinden 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ını bu mağaza vermedi; örneğin birden fazla mağaza aynı ECPay hesabını paylaştığında. Her mağazaya kendi Order Prefix değerini verin.

Bildirim 0|Retry ile yanıt veriyor: sepet aynı anda başka bir bildirim tarafından işleniyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). 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 «The order total is too small for ECPay.» görüyor: sepet toplamı yuvarlamadan sonra 1 TWD'nin altında ve ECPay ile ödenemez.

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

Sipariş ECPay payment on hold durumunda: ECPay payment bloğundaki notları okuyun (bkz. Sipariş durumları), ECPay arka ofisiyle karşılaştırın, ardından siparişi tamamlayın veya ödemeyi orada iade edin.

Geliştiriciler: actionEcpayPRequestParams kancası, başka bir modülün ECPay'e gönderilen parametreleri değiştirmesine izin verir; satıcı, işlem numarası ve tutar bu kanal üzerinden değiştirilemez.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox ECPay Payment Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete Data on Uninstall açıksa ayarlar ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. ECPay ödeme kayıtları ve Awaiting ECPay payment ile ECPay payment on hold sipariş durumları her zaman korunur; böylece eski ödemelere ait geç bildirimler yeniden kurulumdan sonra da kontrol edilmeye devam eder. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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