VibeFox eWAY for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Mağaza para birimi: AUD, NZD, SGD, HKD veya MYR. Diğer sepet para birimlerinde ödeme yöntemi ödeme adımında gizlenir. Ödeme, sepet 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 bölümünde bulabilirsiniz. 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. Yönetici panelinde 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 eWAY Payment Gateway öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğundaki License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Sandbox API anahtarını ve şifresini girin, Sandbox Mode seçeneğini açık bırakın, Enable/Disable seçeneğini etkinleştirin, Save düğmesine tıklayın ve bir test siparişi verin.

5. Canlı API anahtarını ve şifresini girin, Sandbox Mode seçeneğini kapatın ve Save düğmesine tıklayın.

6. İsterseniz Configure sayfasında gösterilen cron URL'sini sunucunuzun cron işlerine ekleyin (bkz. Yapılandırma).

Kurulumda modül eWAY payment on hold sipariş durumunu oluşturur. 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.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox eWAY 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 bir rozet modu gösterir: SANDBOX — payments go to the eWAY sandbox, no real money is charged. veya LIVE — real payments are taken with the live API key. Geçerli modun API anahtarı ve şifresi eksikse (bu durumda ödeme yöntemi ödeme adımında gösterilmez) ve mağazanın varsayılan para birimi eWAY tarafından desteklenmiyorsa sayfa sizi uyarır.

eWAY

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

Title: müşterilerin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit Card (eWAY). Zorunlu.

Description: ödeme adımı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 bölümündedir. eWAY, canlı ve sandbox anahtarları için kılavuzlar sunar; bunlara bu bölümden bağlantı verilmiştir. Sandbox ve canlı farklı anahtarlar kullanır.

Sandbox Mode: ödemeler, sandbox anahtarı ve şifresiyle eWAY sandbox'a gider. Gerçek para tahsil edilmez. Varsayılan: açık. Canlı anahtarla gerçek ödemeler almak için kapatın. Açık olduğu sürece müşteriler ödeme yönteminin altında Test mode: no real payment is taken. ifadesini görür.

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/geliştirici) hesabınızın Rapid API anahtarı.

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

Kaydedilmiş anahtarlar ve şifreler bir daha asla 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 credentials: bir anahtarı veya şifreyi işaretleyip Save düğmesine tıklayarak kaldırın. Boş bir alan, kayıtlı değeri korur.

Return URL / re-checks: eWAY'de bir webhook veya dönüş URL'si yapılandırmanız gerekmez, çünkü dönüş URL'si her ödemeyle birlikte gönderilir. Bu alan isteğe bağlı bir cron URL'si gösterir. Bunu sunucu cron işinden, örneğin 15 dakikada bir çağırın. Müşteri ödeme yapıp mağazaya dönmeden tarayıcıyı kapatırsa, ödeme yaklaşık bir saat sonra eWAY'den sorulur ve sipariş oluşturulur. eWAY'e ulaşılamazsa kontrol en fazla üç kez tekrarlanır. Bu URL'yi gizli tutun: bir token içerir ve yanlış token ile yapılan çağrılara Forbidden yanıtı verilir.

Siparişler

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

Siparişle eşleşmeyen onaylı bir tutar veya para birimi her zaman eWAY payment on hold durumuna gider.

Gelişmiş

Debug log: API çağrılarını ve ödeme sonuçlarını modül klasöründeki logs/eway_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Kart verileri, anahtarlar, şifreler, müşteri e-postaları ve erişim kodları kaydedilmez. 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 all plugin data on uninstall: açıksa modülü kaldırmak ağ geçidi ayarlarını ve günlüğü siler. Siparişlerdeki eWAY ödeme verileri ve eWAY payment on hold sipariş durumu her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak Credit Card (eWAY)) seçer ve onaylar. Modül, eWAY'den sepet para biriminde sepet toplamı için bir ödeme sayfası ister; fatura referansı olarak PS- ve sepet numarasını, ayrıca müşterinin fatura adresi ve e-postasını ekler ve müşteriyi eWAY Responsive Shared Page'e yönlendirir. Müşteri orada kartla öder. Tahsilat hemen yapılır. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza geri döner. Modül tarayıcıya güvenmez: bu sepet için oluşturulan ödeme sayfasının sonucunu sunucudan sunucuya eWAY'den ister. Sipariş, yalnızca eWAY onayladığında ve onaylanan tutar ile para birimi sepetle eşleştiğinde ödenmiş olarak işaretlenir. Sipariş daha sonra oluşturulur ve müşteri standart sipariş onay sayfasını Your payment with eWAY has been received. mesajıyla görür. Beklemedeki bir sipariş için sayfa Your payment was received and is being reviewed by the store. We will contact you if anything is needed. mesajını gösterir.

O anda eWAY'e sorulamıyorsa, Payment confirmation sayfası 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ını, bir Check again düğmesi ve bir Back to checkout düğmesiyle birlikte gösterir. Sipariş, müşteri tekrar kontrol ettiğinde veya cron URL'si çalıştığında oluşturulur.

Ödeme reddedilirse müşteri nedeniyle birlikte ödeme adımına döner; örneğin Your payment was declined: D4451 Insufficient funds. Please try again or use a different payment method. Müşteri eWAY sayfasında Cancel düğmesine tıklarsa modül önce eWAY'e hiçbir şeyin ödenmediğini sorar (örneğin başka bir sekmede). Ardından 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. Sepet her durumda korunur.

Müşteri yeniden deneyebilir. Yeni bir ödeme sayfası oluşturulmadan önce sepetin önceki sayfası eWAY'de kontrol edilir. Zaten ödenmişse, ikinci bir ödeme yerine sipariş oluşturulur. eWAY ödeme sayfasını oluşturamazsa müşteri, eWAY hata kodlarıyla birlikte kısa bir mesajla ödeme adımında kalır; örneğin Payment error: Unable to connect to eWAY. Please try again. veya eWAY could not start the payment.

eWAY, Shared Page için sunucudan sunucuya bildirim göndermez: sonuç, müşteri geri döndüğünde ve cron URL'si ile alınır. Modülde sitenizde kart alanı, kayıtlı kart veya abonelik yoktur; yalnızca yetkilendirme ve ayrı tahsilat yoktur; Beagle dolandırıcılık puanlarını değerlendirmez (eWAY'in dolandırıcılık kurallarıyla engellenen işlemler eWAY tarafından reddedilir).

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri eWAY'e yönlendirildi ve ödeme yapmadı, iptal etti, ödeme reddedildi veya sonuç henüz alınamadı. Yalnızca sepet vardır.

Payment accepted or Delivered: ödeme onaylandı. Durum, Order Status on Success ayarını izler. Ödeme, eWAY işlem kimliğiyle kaydedilir; bir not işlem kimliğini, yetkilendirme kodunu, yanıtı ve modu (sandbox veya canlı) gösterir.

eWAY payment on hold: eWAY, sepetten farklı bir tutar veya para birimi onayladı (örneğin Approved for partial amount ya da müşteri ödeme sayfasını açtıktan sonra sepet değiştirildi), ödeme müşteri eWAY sayfasında iptal ettikten sonra onaylandı veya sipariş iptal edildikten sonra onaylandı. Ödeme, eWAY'in tahsil ettiği tutarla kaydedilir ve not nedenini açıklar. Siparişi kontrol edin ve işleyin ya da ödemeyi iade edin.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Zaten ödenmiş bir sepet için ikinci bir ödeme onaylanırsa sipariş değişmez. Bir not, kopyayı MyeWAY'de iade etmenizi ister. Başka bir fatura referansı için onaylanan bir ödeme asla siparişe uygulanmaz.

eWAY ödeme bloğu

Sipariş sayfasında işlem kimliği, yetkilendirme kodu, eWAY yanıtı, durum, mod ve fatura referansı, ödenen ve iade edilen tutar, sandbox ödemeleri için bir Sandbox rozeti, iade geçmişi ve siparişin eWAY notes bölümü içeren bir eWAY payment bloğu görünür.

İadeler

eWAY payment bloğuna tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via eWAY düğmesine tıklayın. Refund this amount through eWAY? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine ihtiyacınız vardır; Modules sayfalarına erişim gerekmez. İadeler, eWAY'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle kısmi tutar onayından sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortamda (sandbox veya canlı) gönderilir; bu nedenle o ortamın API anahtarı ve şifresinin ayarlanmış olması gerekir. eWAY iadeyi reddederse blok, eWAY kodlarıyla birlikte eWAY refund failed: mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve eWAY iade işlem kimliğiyle birlikte notlara eklenir. Tam iade siparişi Refunded durumuna alır. Kısmi iade durumu değiştirmez. İadeler, eWAY ödemeyi onayladıktan sonra kullanılabilir.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri eWAY üzerinden para geri göndermez. MyeWAY'de yapılan iadeler PrestaShop ile senkronize edilmez. Gerekirse siparişi elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox eWAY Payment Gateway lisans bloğu, Modules > Module Manager > VibeFox eWAY Payment Gateway > Configure sayfasında, ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blokta anahtar maskelenmiş olarak, durum (örneğin lisansın geçerli olduğu son tarih ve alan adınız), 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 düğmeleri görünür. Bunların altında Product: presta-payment-eway satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetici paneli 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 tarihli 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 yalnızca 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 eWAY, ödeme adımında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka bir yöntem seçin. ifadesini görür. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme adımı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 onaylanmaya devam eder ve iadeler çalışır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

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 ayarlı olduğunu (sandbox modunda sandbox alanları, canlı modda canlı alanlar) ve sepet para biriminin AUD, NZD, SGD, HKD veya MYR olduğunu kontrol edin. Kimlik bilgileri eksikse ayarlar sayfası uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

The payment went through, but no order was created: müşteri eWAY'den geri dönmedi ya da eWAY o anda sorgulanamadı. eWAY, Shared Page için bildirim göndermez. Return URL / re-checks bölümündeki cron URL'sini ayarlayın: ödemeyi yaklaşık bir saat sonra alır. İşlemi MyeWAY'de kontrol edin ve modül sayfasındaki Log alanına bakın.

The customer sees 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.

The customer sees eWAY could not start the payment: eWAY, mesajda gösterilen hata kodlarını döndürdü. Çoğunlukla fatura bilgileri geçersizdir.

The customer sees We could not match this payment to an order: dönüş bağlantısı bu mağazanın bir sepetine ait değil ya da eWAY başka bir fatura referansı için bir ödeme onayladı. Müşteriden tahsilat yapıldıysa ödemeyi MyeWAY'de bulun.

The customer sees We could not check the status of your previous payment attempt: aynı sepeti başka bir istek işliyordu. Müşteri birkaç saniye sonra yeniden deneyebilir.

Order is eWAY payment on hold after payment: eWAY payment bloğundaki eWAY notes notlarını okuyun (bkz. Sipariş durumları), ardından siparişi işleyin veya ödemeyi iade edin.

Refund fails with a message about the sandbox or live mode: sipariş bu ortamda ödendi ve bu ortamın API anahtarı ile şifresi ayarlı değil. Bunları girin ve yeniden deneyin.

Refund fails with at most … can be refunded: tutar, eWAY'in tahsil ettiği tutardan önceki iadeler düşüldükten sonra kalan tutardan fazla.

Geliştiriciler için: modülün README dosyasında actionWcpEwaySupportedCurrencies kancası açıklanmıştır; eWAY hesabınız ek para birimleri için etkinleştirilmişse bu kancayı kullanabilirsiniz.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox eWAY 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 all plugin data on uninstall açıksa ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Siparişlerdeki eWAY ödeme verileri ve eWAY payment on hold sipariş durumu her zaman saklanır; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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