VibeFox ECPay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin.

PHP: 8.0 veya üzeri.

Mağaza para birimi: yeni Tayvan doları (TWD). ECPay yalnızca TWD ile ücretlendirme yapar ve mağaza veya ödenmekte olan sipariş başka bir para birimi kullanıyorsa ödeme yöntemi gizlenir. ECPay ondalık değerleri kabul etmediğinden tutarlar tam TWD olarak gönderilir: sipariş toplamları en yakın dolara yuvarlanır. Yuvarlamayı önlemek için TWD fiyatlarında 0 ondalık kullanın.

ECPay hesabı: canlı ödemeler için ECPay satıcı arka ofisinden (vendor.ecpay.com.tw) alınan ECPay satıcı hesabınızın MerchantID, HashKey ve HashIV bilgilerine ihtiyacınız vardır. Test için ECPay hesabı gerekmez.

Site erişimi: ECPay'in ödeme bildirimlerini iletebilmesi için sitenizin internetten HTTP/HTTPS üzerinden 80/443 portundan erişilebilir olması gerekir. Bakım modu, güvenlik duvarı veya sitenin önündeki 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. WordPress'te Plugins > Add New > Upload Plugin'e gidin, eklentinin ZIP dosyasını seçin ve Install Now'a tıklayın. wcp_ecpay_payment_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate'e tıklayın. WooCommerce etkin olmalıdır.

3. Ayarları açın: WooCommerce > Settings > Payments > ECPay (綠界) > Manage, veya Eklentiler sayfasında eklenti adının altındaki Settings'e tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğuna girin ve Activate'e tıklayın.

5. Enable/Disable'ı açın, ödeme yöntemlerini seçin ve ilk testleriniz için Test Mode'u açık tutun. Sandbox'ta ECPay test kartı 4311-9522-2222-2222 ile ödeme yapabilirsiniz (herhangi bir gelecekteki son kullanma tarihi, CVV 222, sandbox sayfasından 3-D Secure kodu).

6. Canlı ödemeler için MerchantID, HashKey ve HashIV'i girin (bkz. Yapılandırma) ve Test Mode'un işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > ECPay (綠界). Alanların üstünde sayfa, mağaza para birimi TWD olmadığında (bu durumda ECPay ödeme sırasında gösterilmez) ve canlı modda MerchantID, HashKey ve HashIV eksik olduğunda bir hata gösterir. Test modu açıkken sayfa, ödemelerin herkese açık test satıcısı 3002607 ile ECPay sandbox'ına gittiğini, para tahsil edilmediğini ve herkese açık sandbox anahtarlarını bilen herkesin test siparişlerini onaylayabileceğini belirtir; bu nedenle gerçek sipariş kabul etmeden önce test modu kapatılmalıdır.

Genel

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ı. Varsayılan: ECPay (綠界).

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: Enable sandbox/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 kimlik bilgileri yalnızca test modu kapalıyken kullanılır. Varsayılan: açık.

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

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

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

Yapıştırılan kimlik bilgilerindeki boşluklar ve satır sonları tüm imzaları bozar, bu nedenle kaydedildiğinde kaldırılır ve sayfa bu konuda sizi bilgilendirir.

Ödeme seçenekleri

Enabled Payment Methods: müşterilere sunulan yöntemler. Birden fazla olduğunda müşteri ödeme sırasında seçim yapar. ATM, CVS ve Barcode siparişleri müşteri ödeyene kadar Beklemede kalır. En az bir yöntem seçilmelidir; hiçbiri seçilmezse Credit Card etkinleştirilir. Varsayılan: Credit Card.

Default Payment Method: önceden seçilen yöntem. Etkin yöntemlerden biri olmalıdır; aksi halde etkinleştirilen 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 kaydedildiğinde kaldırılır. Birkaç mağazanın bir ECPay hesabını paylaştığı durumlarda 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 bildirim URL'sini gösterir. Şu şekildedir: https://your-site/wc-api/ecpay_p_callback/. URL her ödemeyle birlikte gönderilir, bu nedenle ECPay'de hiçbir şey yapılandırılması gerekmez, ancak önünde bakım modu, güvenlik duvarı veya temel kimlik doğrulama olmadan internetten 80/443 portundan erişilebilir olmalıdır.

Her bildirim, ödemenin başlatıldığı ortamın (test veya canlı) anahtarlarıyla CheckMacValue imzası ile kontrol edilir. Geçerli imzası olmayan bildirimler reddedilir ve ECPay bunları yeniden gönderir. Bildirim olmadan hiçbir sipariş ödenmiş olarak işaretlenmez; ödemeyi ECPay arka ofisinde kontrol edin.

Gelişmiş

Enable Logging: Log payment events and API calls, sipariş kimliklerini, işlem numaralarını, tutarları ve ECPay dönüş kodlarını WooCommerce > Status > Logs'a, kaynak wcp_ecpay_payment_gateway olarak yazar. Hiçbir anahtar veya müşteri verisi kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: Delete all plugin data when uninstalling. Bu eklentinin tüm ayarlarını, günlüklerini ve sipariş meta verilerini kaldırır. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak ECPay (綠界)). Birden fazla yöntem etkinleştirildiğinde müşteri ayrıca Credit Card, ATM (Virtual Account), CVS (Convenience Store) veya Barcode'u seçer. Test modu açıkken ödeme yöntemi TEST MODE — ECPay sandbox, no real money is charged. ifadesini gösterir.

Sipariş verildikten sonra müşteri Redirecting to ECPay for payment. Please wait... mesajını görür ve yönlendirme başlamazsa diye bir Proceed to ECPay düğmesiyle ECPay ödeme sayfasına yönlendirilir. Sipariş toplamı, ürünlerin adları ve miktarlarıyla birlikte tam TWD olarak gönderilir. ECPay sayfası Tayvan ve Hong Kong site dilleri için Geleneksel Çince, bu diller için Basitleştirilmiş Çince, Korece veya Japonca, diğer tüm diller için İngilizce açılır.

Sipariş, ECPay tarafından imzalı bir sunucu bildirimiyle onaylandıktan sonra ödenmiş olarak işaretlenir. Müşteri, onay gelmeden önce sipariş alındı sayfasına geri dönerse sayfa, Pay düğmesiyle We have not received a payment confirmation from ECPay for this order yet. If you did not complete the payment, you can try again: ifadesini gösterir.

ATM, CVS ve Barcode için müşteri önce ödeme bilgilerini alır. Sipariş Beklemede durumuna geçer ve banka kodu ile sanal hesap, kolay market ödeme kodu veya barkodlar, tutar ve Pay before tarihi teşekkür sayfasında, My account > Orders'da ve beklemede sipariş e-postası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.

ECPay yeniden kullanılan numaraları reddettiğinden, ödeme sayfasına her girişte yeni bir ECPay işlem numarası oluşturulur. Böylece Pay for order sayfası ve başarısız bir ödemeden sonraki yeniden denemeler çalışır ve bu numaralardan herhangi birine ait bildirimler siparişle eşleştirilir. Bir sipariş en fazla 30 ödeme denemesine sahip olabilir.

ECPay'in yöntem bazında kendi tutar sınırları, örneğin kolay market ödemeleri için, ödeme sırasında değil ECPay sayfasında kontrol edilir.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca ECPay sayfasında tek seferlik ödemeleri kabul eder. WooCommerce'ten iade desteği, kayıtlı kart, abonelik veya periyodik ödeme (定期定額), taksit, Apple Pay, TWQR, WeChat Pay, BNPL, WebATM, e-fatura, lojistik veya sunucu taraflı durum sorgusu yoktur: siteniz bildirimi alamıyorsa ödemeyi ECPay arka ofisinde kontrol edin.

Siparişler

Sipariş durumları

Pending payment: müşteri ECPay'e yönlendirildi ve henüz ödeme yapmadı, ya da bildirim henüz gelmedi.

On hold, waiting for payment: müşteri ATM, CVS veya Barcode'u seçti ve ödeme bilgilerini aldı. Sipariş notu banka kodunu ve sanal hesabı, ödeme kodunu veya barkodları ve son tarihi gösterir.

Processing: ödeme onaylandı (WooCommerce varsayılanı; yalnızca sanal indirilebilir ürünler içeren siparişler Tamamlandı durumuna geçer). Sipariş notu ECPay TradeNo'sunu, ödeme türünü, tutarı ve işlem numarasını gösterir. İşlem kimliği ECPay TradeNo'sudur.

On hold after payment: ECPay siparişten farklı bir tutar veya para birimi bildirdi, canlı moda geçtikten sonra bir sandbox ödemesi geldi (gerçek para tahsil edilmedi) veya sipariş iptal edildikten sonra ödeme geldi. Sipariş notu bunu açıklar. ECPay arka ofisiyle karşılaştırın ve siparişi manuel olarak tamamlayın veya iade edin.

Failed: ECPay son ödeme denemesinin başarısız olduğunu bildirdi. Not, ECPay dönüş kodunu ve mesajını gösterir. Müşteri yeniden deneyebilir.

Tekrarlanan bildirimler yok sayılır. Ödenmiş, iptal edilmiş veya iade edilmiş bir sipariş eski bir bildirimle asla yeniden açılmaz. Örneğin iki tarayıcı sekmesinden olduğu gibi, zaten ödenmiş bir sipariş için yapılan ikinci bir ödeme, ECPay arka ofisinde iade edebilmeniz için bir sipariş notu olarak kaydedilir. ECPay arka ofisinden başlatılan simüle ödemeler yalnızca not edilir ve siparişi asla ödenmiş olarak işaretlemez, çünkü ECPay bunlar için para tahsil etmez.

İadeler

WooCommerce'ten iadeler kullanılamaz. Ödemeyi ECPay arka ofisinde iade edin, ardından iadeyi WooCommerce'te manuel olarak kaydedin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > ECPay (綠界)'nin üstündedir. Anahtarı License key alanına yapıştırın ve Activate'e tıklayın. Blok durumu gösterir, örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now'ı, başka bir anahtar girmek için Change key'i ve anahtarı bu siteden kaldırmak için Remove key'i kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz; bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan ECPay, ödeme sırasında müşterilere gösterilmez. Buna rağmen bir ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. ifadesini görür. Oturum açmış mağaza yöneticileri, anahtar satın almadan önce eklentiyi kurup test edebilmeniz için (unlicensed — visible to admins only) işaretli ödeme yöntemini görmeye devam eder. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler bundan etkilenmez: zaten başlatılmış ödemeler yine de onaylanır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

ECPay ödeme sırasında görünmüyor: lisansın etkin olduğunu, Enable/Disable'ın açık olduğunu, mağaza para biriminin TWD olduğunu ve canlı modda Merchant ID, Hash Key ve Hash IV'nin ayarlandığını kontrol edin. Ayarlar sayfası bu durumların her birinde bir hata gösterir.

Ödeme gerçekleşti, ancak sipariş Ödeme bekleniyor durumunda kalıyor: ECPay bildirimi sitenize ulaşmadı (site erişilemiyor, güvenlik duvarı, bakım modu, temel kimlik doğrulama). ECPay birkaç kez yeniden dener. İşlemi ECPay arka ofisinde de kontrol edip siparişi manuel olarak tamamlayabilirsiniz. Eklentinin aldığı bildirimleri görmek için Enable Logging'i açın.

Bildirim 0|CheckMacValue verification failed yanıtını veriyor: Hash Key veya Hash IV, ECPay hesabınızla eşleşmiyor. Bunları ECPay arka ofisinden yeniden kopyalayın.

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

Bildirim 0|Order not found yanıtını veriyor: işlem numarası bu mağaza tarafından verilmemiş, örneğin birkaç mağaza bir ECPay hesabını paylaştığında. Her mağazaya kendi Order Prefix'ini verin.

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 ödenemiyor.

Sipariş, tutar uyuşmazlığı notuyla Beklemede durumunda: ECPay'in bildirdiği tutar sipariş toplamından farklı, örneğin sipariş müşteri ödemeye başladıktan sonra düzenlenmiş. ECPay arka ofisiyle karşılaştırın ve siparişi manuel olarak tamamlayın veya iade edin.

Sipariş bir sandbox ödemesinden sonra Beklemede durumunda: ödeme test modunda yapıldı, ancak mağaza şimdi canlı modda. Gerçek para tahsil edilmedi. Siparişi manuel olarak kontrol edin.

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

Lisans bloğu bir hata gösteriyor: bloktaki mesajı takip edin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir hakkı serbest bırakın ve Check now'a tıklayın. Site adresi değiştiyse anahtarı yeni alan adı için etkinleştirmek üzere Check now'a tıklayın. Lisans sunucusuna erişilemiyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, siparişlerde saklanan ECPay verileri ve günlükler, yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde daha sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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