VibeFox eWAY 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: AUD, NZD, SGD, HKD veya MYR. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. Sipariş kendi para biriminde tahsil edilir.

eWAY hesabı: Rapid API erişimi olan bir eWAY satıcı hesabına ve bu hesabın Rapid API anahtarı ile şifresine ihtiyacınız var; bunlar MyeWAY'de Settings, API Key altında bulunur. Test için kendi anahtarı ve şifresi olan bir eWAY sandbox hesabına ihtiyacınız var. Sandbox ve canlı anahtarlar farklıdır. eWAY'de herhangi bir ayar yapmanız gerekmez: dönüş URL'si her ödemeyle birlikte gönderilir.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_eway_payment_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > eWAY > Manage veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Sandbox API anahtarınızı ve şifrenizi girin, Sandbox Mode seçeneğini açık bırakın, Enable/Disable seçeneğini açın ve eWAY test kartı 4444333322221111 ile bir test siparişi verin.

6. Canlı API anahtarınızı ve şifrenizi girin, Sandbox Mode işaretini kaldırın ve kaydedin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > eWAY. Alanların üstündeki bir rozet modu gösterir: SANDBOX (ödemeler eWAY sandbox'ına gider, gerçek para tahsil edilmez) veya LIVE (gerçek ödemeler canlı API anahtarıyla alınır). Geçerli modun API anahtarı veya şifresi eksikse sayfa sizi uyarır (bu durumda ağ geçidi ödeme sayfasında gösterilmez); mağaza para birimi desteklenmiyorsa da uyarır. Ödeme yöntemleri listesinde, geçerli modda kimlik bilgileri girilene kadar eWAY kurulum gerektiriyor olarak işaretlenir; sandbox modunda ise bir test modu rozeti gösterilir.

Genel

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Varsayılan: Credit Card (eWAY).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.

API kimlik bilgileri

Rapid API anahtarı ve şifresi MyeWAY'de, Settings, API Key altında bulunur. eWAY, canlı ve sandbox anahtarları için kılavuzlar sunar; bunlara bu bölümde bağlantı verilmiştir. Sandbox ve canlı farklı anahtarlar kullanır.

Sandbox Mode: Enable sandbox (test) mode ödemeleri sandbox anahtarıyla eWAY sandbox'ına gönderir. Gerçek para tahsil edilmez. Varsayılan: açık. Canlı anahtarla gerçek ödemeler almak için bu seçeneğin işaretini kaldırın.

Live API Key: canlı eWAY hesabınızın Rapid API anahtarı.

Live API Password: canlı eWAY hesabınızın Rapid API şifresi.

Sandbox API Key: eWAY sandbox (partner/developer) hesabınızın Rapid API anahtarı.

Sandbox API Password: eWAY sandbox hesabınızın Rapid API şifresi.

Siparişler

Order Status on Success: eWAY ödemeyi onayladıktan sonra siparişin durumu.

Gelişmiş

Debug log: Enable logging API çağrılarını ve ödeme sonuçlarını WooCommerce > Status > Logs altına, kaynak wcp_eway_payment_gateway olarak yazar. Kart verileri ve anahtarlar günlüğe kaydedilmez. Hatalar her zaman kaydedilir. Varsayılan: kapalı.

Uninstall: Delete all plugin data on uninstall. İşaretliyse eklenti silindiğinde ağ geçidi ayarları ve günlükleri kaldırılır. Siparişlerde kayıtlı ödeme referansları korunur. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (eWAY)) ve siparişi verir. Eklenti, eWAY'den sipariş tutarı için, sipariş para biriminde bir ödeme sayfası ister; sipariş numarası fatura referansı olarak ve müşterinin fatura bilgileri ile birlikte gönderilir ve müşteri eWAY Responsive Shared Page sayfasına yönlendirilir. Müşteri orada kartla öder. Ödeme hemen tahsil edilir.

Ödemeden sonra müşteri mağazanıza geri döner. Eklenti tarayıcıya güvenmez: bu siparişin oluşturduğu ödeme sayfasının sonucunu sunucudan sunucuya eWAY'den ister. Sipariş, yalnızca eWAY onayladığında ve onaylanan tutar ile para birimi siparişle eşleştiğinde ödenmiş olarak işaretlenir. Ardından müşteri "Sipariş alındı" sayfasına gelir. Bu anda eWAY'e ulaşılamazsa sipariş "Ödeme bekleniyor" durumunda kalır ve sayfada We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. mesajı gösterilir. Ödeme, "Sipariş alındı" sayfası açıldığında ve WooCommerce ödenmemiş siparişi otomatik olarak iptal etmeden önce yeniden kontrol edilir.

Ödeme reddedilirse müşteri, nedenle birlikte ödeme sayfasına (veya Pay for order sayfasına) döner; örneğin Your payment was declined: Insufficient funds. Please try again or use a different payment method. Müşteri eWAY sayfasında Cancel düğmesine tıklarsa eklenti önce eWAY'den hiçbir şeyin ödenmediğini doğrular. Ödeme sayfasında verilen sipariş bu durumda iptal edilir; Pay for order sayfasından ödenen sipariş ise ödenmemiş kalır. Müşteri You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. mesajını görür. Ödeme tamamlanmadıysa mesaj The payment was not completed. Please try again. olur.

Müşteri ödenmemiş bir siparişi yeniden ödeyebilir. Siparişin her ödeme sayfası izlenir; bu nedenle eski bir sayfa üzerinden yapılan ödeme de tanınır. eWAY ödeme sayfasını oluşturamazsa müşteri kısa bir mesaj görür; örneğin Payment error: Unable to connect to eWAY. Please try again.

Ö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.

eWAY, Shared Page için sunucudan sunucuya bildirim göndermez: sonuç, müşteri geri döndüğünde ve yukarıda açıklanan kontrollerde alınır. Eklentinin sitenizde kart alanı, kayıtlı kart veya abonelik yoktur; yalnızca yetkilendirme ve sonradan tahsilat yoktur; Beagle dolandırıcılık puanlarını değerlendirmez (eWAY'nin dolandırıcılık kurallarıyla engellenen işlemleri eWAY'nin kendisi reddeder).

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri eWAY'e yönlendirildi ve henüz ödeme yapmadı ya da sonuç henüz eWAY'den alınamadı (sipariş notu bunu belirtir).

Processing or Completed: ödeme onaylandı. Durum, Order Status on Success ayarını izler. Sipariş notu eWAY işlem kimliğini, yetkilendirme kodunu ve yanıtı gösterir. Siparişin işlem kimliği eWAY işlem kimliğidir.

On hold after payment: eWAY, siparişten farklı bir tutarı veya para birimini onayladı (örneğin Approved for partial amount ya da müşteri ödeme sayfasını açtıktan sonra sipariş düzenlendi) veya ödeme, sipariş iptal edildikten sonra onaylandı. Not durumu açıklar. "Sipariş alındı" sayfasında müşteri Your payment was received and is being reviewed by the store. We will contact you if anything is needed. mesajını görür. Siparişi tamamlayın veya ödemeyi iade edin.

Failed: eWAY ödemeyi reddetti. Not, eWAY kodunu ve anlamını gösterir.

Cancelled: müşteri, siparişi ödeme sayfasında verdikten sonra eWAY sayfasında iptal etti; ya da sipariş, eWAY ödenmediğini onayladıktan sonra sizin tarafınızdan veya WooCommerce stok tutma zaman aşımı nedeniyle iptal edildi.

Zaten ödenmiş bir sipariş için ikinci bir ödeme onaylanırsa sipariş değişmez. Bir not, mükerrer ödemeyi MyeWAY'de iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit Card (eWAY) düğmesine tıklayın (düğme ödeme yönteminin başlığını kullanır). Tam ve kısmi iadeler desteklenir. İade, ödemenin alındığı ortamda (sandbox veya canlı) gönderilir; bu nedenle o ortamın API anahtarı ve şifresinin girilmiş olması gerekir. eWAY iadeyi reddederse WooCommerce eWAY kodunu gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, eWAY iade işlem kimliğiyle birlikte sipariş notlarına eklenir.

MyeWAY'de yapılan iadeler WooCommerce ile senkronize edilmez. Gerekirse eWAY iade düğmesini kullanmadan WooCommerce'de manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > eWAY sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum gösterilir; örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar yalnızca bir alan adında çalışır. Anahtarın bir siteden kaldırılması, o alan adının yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa eWAY müşterilere ödeme sayfasında 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine onaylanır ve iadeler çalışı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

eWAY does not appear at checkout: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun API anahtarı ve şifresinin girildiğini (sandbox modunda sandbox alanları, canlı modda canlı alanlar) ve mağaza para biriminin AUD, NZD, SGD, HKD veya MYR olduğunu kontrol edin. Pay for order sayfasında sipariş para birimi kontrol edilir.

The payment went through, but the order stays Pending payment: müşteri eWAY'den geri dönmedi ya da o anda eWAY'e ulaşılamadı. eWAY, Shared Page için bildirim göndermez. Ödeme, "Sipariş alındı" sayfası açıldığında ve WooCommerce ödenmemiş siparişi iptal etmeden önce yeniden kontrol edilir. İşlemi MyeWAY'de kontrol edin ve WooCommerce > Status > Logs altında, kaynak wcp_eway_payment_gateway olan kayıtlara bakın.

Müşteri şu mesajı görür: This payment method is temporarily unavailable: geçerli modun API anahtarı veya şifresi eksik ya da eWAY bunları reddetti. Geçerli modun kimlik bilgilerini kontrol edin.

Müşteri şu mesajı görür: eWAY could not start the payment: eWAY, mesajda gösterilen hata kodlarını döndürdü. Çoğunlukla fatura bilgileri geçersizdir.

Müşteri şu mesajı görür: We could not match this payment to an order: dönüş bağlantısı bu mağazanın hiçbir siparişine ait değil. Müşteriden ücret alındıysa ödemeyi MyeWAY'de bulun.

Müşteri şu mesajı görür: We could not confirm your payment with eWAY: ödemenin sonucu kontrol edilemedi. Sonuç alındığında sipariş güncellenir; müşterinin tekrar ödeme yapmaması gerekir.

Order is On hold after payment: sipariş notunu okuyun. Onaylanan tutar veya para birimi siparişten farklıydı ya da ödeme siparişin iptalinden sonra geldi. Siparişi tamamlayın veya ödemeyi iade edin.

İade, sandbox veya canlı modla ilgili bir mesajla başarısız oluyor: sipariş bu ortamda ödendi ve bu ortamın API anahtarı ile şifresi girilmemiş. Bunları girip yeniden deneyin.

Lisans bloğunda bir hata görünüyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Geliştiriciler için: readme dosyasında, eWAY hesabınız daha fazla para birimi için etkinleştirilmişse kullanılabilecek eway_p_supported_currencies filtresi listelenmiştir.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Uninstall (Delete all plugin data on uninstall) açıksa kaldırılır. Aksi halde, sonraki bir yeniden kurulum için saklanırlar. Siparişlerde kayıtlı ödeme referansları her zaman korunur. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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