VibeFox Eupago for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x arası.

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

Para birimi: euro (EUR). Eupago yalnızca euro ile tahsilat yapar; bu nedenle diğer para birimlerindeki sepetlerde ödeme yöntemi ödeme sayfasında gizlenir.

Eupago hesabı: Eupago kanalınızın API anahtarına ve Eupago back office'te oluşturacağınız bir Webhook 2.0'ın anahtarına ihtiyacınız vardır (bkz. Yapılandırma). Canlı back office clientes.eupago.pt, sandbox back office ise sandbox.eupago.pt adresindedir. Sandbox ve canlı, ayrı anahtarlara sahip ayrı hesaplardır.

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

Kurulum

1. Back office'te 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 tamamlandığında Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox Eupago Gateway modülünü bulup Configure düğmesine tıklayın.

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

4. Eupago kanalınızın API anahtarını girin, Eupago back office'te bir Webhook 2.0 oluşturun ve onun anahtarını yapıştırın (bkz. Yapılandırma).

5. Payment Method seçeneğini belirleyin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox modunda bir test siparişi verin, ardından Sandbox Mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Eupago payment ve Eupago payment on hold. PrestaShop, yeni bir ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için kullanıma sunar. Bunları Payment > Preferences bölümünde sınırlayabilirsiniz; euro, modül için izinli kalmalıdır.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Eupago Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Ödeme yöntemi etkinleştirildiğinde, geçerli modun API anahtarı boşsa sayfa alanların üstünde sizi uyarır (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ya da sandbox modu açık olduğu sürece Sandbox mode: no real payments are taken. mesajını gösterir.

Eupago

Enable/Disable: Enable Eupago Gateway ö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: Eupago. Zorunlu: boş bir başlık Enter a title for the payment method. uyarısına yol açar.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via Eupago.

Payment Method: ödeme sayfasında sunulan tek Eupago yöntemi.

Multibanco: müşteri, ATM'de veya internet bankacılığında ödeme yapmak için bir kuruluş (entity) numarası ve bir referans alır (varsayılan). 1 € ile 999.999,99 € arasındaki sipariş tutarları için sunulur.

MB WAY: müşteri ödeme sayfasında MB WAY telefon numarasını girer ve ödemeyi MB WAY uygulamasında onaylar.

Credit Card: müşteri Eupago kart sayfasına yönlendirilir.

Order Status After Payment: ödeme onaylandığında ayarlanan sipariş durumu.

Processing (default): sipariş Payment accepted olur.

Completed: sipariş tek bir durum değişikliğiyle Delivered olur.

Eupago hesabı

Kanalınızın API anahtarını ve Webhook 2.0 anahtarını Eupago back office'te alın: clientes.eupago.pt (canlı) veya sandbox.eupago.pt (sandbox). Sandbox ve canlı, ayrı anahtarlara sahip ayrı hesaplardır.

Sandbox Mode: sandbox.eupago.pt adresini ve sandbox anahtarlarını kullanır. Gerçek ödeme alınmaz. Varsayılan: açık. Gerçek ödemeleri canlı anahtarlarla almak için kapatın. Açık olduğu sürece müşteriler ödeme yönteminin altında SANDBOX / TEST MODE ifadesini görür.

Live API Key: canlı Eupago kanalınızın API anahtarı (clientes.eupago.pt).

Live Webhook Key: canlı Webhook 2.0'ınızın şifreleme anahtarı. Zorunlu: geçerli imzası olmayan bildirimler reddedilir.

Sandbox API Key: sandbox kanalınızın API anahtarı (sandbox.eupago.pt).

Sandbox Webhook Key: sandbox Webhook 2.0'ınızın şifreleme anahtarı.

Kaydedilmiş anahtarlar 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 keys: bir anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan kaydedilmiş değeri korur.

Webhook URL

Webhook, mağazanıza bir ödemenin yapıldığını bildirir. Eupago back office'te, bu bölümde gösterilen URL ile POST yöntemini kullanan ve şifrelemesi açık bir Webhook 2.0 oluşturun. Dostça URL'ler etkinse şu biçimde görünür: https://your-shop/module/wcp_eupago_gateway/webhook; başına /pt/ gibi bir dil kodu da eklenebilir. URL'yi ayarların gösterdiği biçimde birebir kopyalayın. Sandbox back office'te bir webhook, canlı back office'te ise bir diğer webhook oluşturun.

Her webhook'un anahtarını Sandbox Webhook Key veya Live Webhook Key alanına kopyalayın. Geçerli imzası olmayan webhook'lar reddedilir. Şifresiz bir webhook yalnızca Eupago onu imzalarsa kabul edilir, bu yüzden şifrelemeyi açık tutun. Bir bildirim, ödemenin başlatıldığı modun anahtarıyla imzalanmalıdır; bu nedenle bir sandbox bildirimi asla canlı bir ödemeyi tamamlamaz. Modül, şu bildirim durumlarına yanıt verir:

PAID: ödeme yapıldı. Tüm kontrollerden sonra sipariş ödenmiş olarak işaretlenir.

CANCELED: ödeme iptal edildi. Bekleyen bir sipariş Canceled olur.

EXPIRED: ödemenin süresi doldu. Bekleyen bir sipariş Canceled olur.

ERROR: ödeme başarısız oldu. Bekleyen bir sipariş Payment error olur.

Diğer durumlar için bir işlem gerekmez. Eupago'nun aynı URL'ye gönderdiği eski GET callback de kabul edilir; API anahtarıyla doğrulanır ve her zaman bir ödemeyi bildirir. Bildirim olmadan siparişler asla ödenmiş olarak işaretlenmez: modül Eupago'yu sorgulamaz ve müşterinin geri dönmesi bir siparişi ödemez. Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Gelişmiş

Debug Log: API çağrılarını ve bildirimleri modül klasöründeki logs/eupago_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtarlar, e-postalar ve tam telefon numaraları kaydedilmez. Hatalar her zaman kaydedilir. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. İçeriğini temizlemek için Clear log düğmesine tıklayın.

Delete Data on Uninstall: açıksa modül kaldırıldığında ağ geçidi ayarları, bu modülün Eupago ödeme kayıtları ve günlük silinir. Siparişler ve ödeme verileri korunur. Varsayılan: kapalı.

Ödeme

Müşteri, ödeme adımında ödeme yöntemini (varsayılan olarak Eupago) seçer ve siparişi verir. Sonrasında olanlar Payment Method ayarına bağlıdır.

Multibanco: ödeme sayfasında müşteri You will receive Multibanco payment details after placing the order. mesajını görür. Modül, sepet toplamı için bir Multibanco referansı oluşturur. Sipariş, herhangi bir PrestaShop siparişi gibi hemen Awaiting Eupago payment durumunda oluşturulur ve sepet boşaltılır. Sipariş onay sayfasında kuruluş, referans ve tutarı içeren Multibanco Payment Details gösterilir. Aynı bilgiler, sipariş onay e-postasındaki ödeme satırına da eklenir. Müşteri, ATM'de veya internet bankacılığında öder.

MB WAY: ödeme sayfasında müşteri, fatura adresindeki telefonla doldurulmuş MB WAY Phone Number alanını girer. Portekiz numaraları +351 olmadan girilebilir. Yanlış bir numara Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). uyarısına yol açar. Modül, ödeme isteğini MB WAY uygulamasına gönderir ve siparişi Awaiting Eupago payment durumunda oluşturur. Sipariş onay sayfası, müşteriden maskelenmiş telefon numarasındaki MB WAY uygulamasını açmasını ve isteği 5 dakika içinde onaylamasını ister.

Credit Card: ödeme sayfasında müşteri You will be redirected to a secure payment page to enter your card details. mesajını görür. Müşteri, sepetin diline göre Portekizce, İspanyolca veya İngilizce olan Eupago kart sayfasına gönderilir. Henüz bir sipariş yoktur ve sepet korunur. Sipariş yalnızca Eupago ödemeyi onayladığında oluşturulur. Müşteri geri döndüğünde bildirim zaten gelmişse, standart sipariş onay sayfasını görür. Aksi halde Payment confirmation sayfasında Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. mesajı ve Check again düğmesi gösterilir. Kart ödemesi başarısız olur veya yarıda bırakılırsa müşteri, The card payment was not completed. You can try again or choose another payment method. ya da The card payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner.

Her yöntemde sipariş, Eupago ödemeyi doğrulanmış bir bildirimle onaylayana kadar ödenmiş olarak işaretlenmez. Ödeme bilgileri yalnızca sipariş Awaiting Eupago payment durumundayken gösterilir. Eupago daha sonra ödemenin iptal edildiğini, süresinin dolduğunu veya başarısız olduğunu bildirirse ve sipariş ödenmemişse, sipariş onay sayfasında Your Eupago payment was not completed. Please contact us about this order. mesajı gösterilir.

Eupago ödemeyi başlatamazsa müşteri, kısa bir mesajla ödeme sayfasında kalır; örneğin The payment could not be started because Eupago is temporarily unavailable. Please try again in a few minutes or choose another payment method. Sipariş oluşturulmaz ve ayrıntılar günlükte yer alır. Başka bir para birimindeki bir sepet Eupago only supports payments in EUR. mesajını gösterir.

Modül, kurulum başına bir Eupago yöntemi sunar. PrestaShop üzerinden iade, kayıtlı kart, abonelik veya ön provizyon yoktur; PayShop, Cofidis Pay, Bizum veya diğer Eupago yöntemleri, SMS hatırlatmaları, Multibanco son ödeme tarihi ve durum sorgulama da yoktur.

Siparişler

Sipariş durumları

No order yet: bir kart ödemesi başlatıldı ve Eupago henüz onaylamadı. Yalnızca sepet vardır.

Awaiting Eupago payment: bir Multibanco referansı veya bir MB WAY isteği oluşturuldu. Not, kuruluşu ve referansı ya da maskelenmiş telefon numarasını gösterir.

Payment accepted or Delivered: ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Ödeme, Eupago işlem kimliği ile işlem kimliği olarak kaydedilir ve bir not yöntemi, işlem kimliğini ve referansı gösterir.

Eupago payment on hold: Eupago, farklı bir tutar veya para birimiyle, bu sepet için oluşturulmamış bir referansla ya da bu arada iptal edilmiş veya başarısız olmuş bir sipariş için (örneğin geç ödenmiş bir Multibanco referansı) bir ödeme bildirdi. Not durumu açıklar. Ödemeyi ve stoku kontrol edin, ardından siparişi elle tamamlayın veya müşteriye iade yapın. Bu ödeme için sonraki bildirimler, siz farkında olmadan siparişi tamamlamaz.

Canceled: Eupago, bekleyen bir siparişin mevcut ödeme denemesi için ödemenin iptal edildiğini veya süresinin dolduğunu bildirdi.

Payment error: Eupago, bekleyen bir siparişin mevcut ödeme denemesi için bir hata bildirdi.

Eupago, zaten ödenmiş bir sipariş için başka bir ödeme bildirirse (örneğin daha eski bir Multibanco referansı da ödendiyse), sipariş değişmez. Bir not, olası bir çift ödemeyi kontrol edip Eupago back office'te iade etmenizi ister. Ödenmiş ve sonra iptal edilmiş ya da iade edilmiş bir siparişi, bir ödeme bildirimi asla yeniden açmaz.

Eupago ödeme bloğu

Sipariş sayfasında, sepetin her ödeme denemesini gösteren bir Eupago payment bloğu bulunur: tarih, yöntem, sandbox ödemeleri için bir Sandbox rozeti, tutar, Multibanco kuruluşu ve referansı ya da MB WAY maskelenmiş telefonu, Eupago işlem kimliği ve durum. Sipariş Eupago payment on hold durumundayken blok bir Manual review uyarısı gösterir. Bunun altında Eupago notes, modülün siparişteki notlarını en yenisi önce olacak şekilde listeler.

İadeler

PrestaShop üzerinden iadeler desteklenmez. Müşteriye Eupago back office'te iade yapın ve siparişi PrestaShop'ta elle güncelleyin. Sipariş sayfasındaki standart PrestaShop iade düğmeleri, Eupago üzerinden para göndermez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox Eupago Gateway, Modules > Module Manager > VibeFox Eupago 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, anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-payment-eupago 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 için Configure izni olan çalışanlar değiştirebilir. Bloktaki metinler back office 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 License expired on ve bir tarih. 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 tek 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Eupago, ö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, back office'e giriş yaptığınızı bilmez; bu yüzden ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında 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. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonra haftada bir kez. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak, lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Eupago ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun API anahtarının girildiğini kontrol edin (sandbox modunda Sandbox API Key, canlı modda Live API Key). Sepetin para birimi EUR olmalıdır ve Payment > Preferences bölümünde modül euro, müşterinin ülkesi ve müşterinin grubu için izinli olmalıdır. Multibanco ile sipariş toplamı 1 € ile 999.999,99 € arasında olmalıdır.

Ödeme yapıldı ama sipariş hâlâ Awaiting Eupago payment durumunda ya da hiç sipariş oluşturulmadı: Eupago bildirimi gelmiyor ya da reddediliyor. Kullandığınız modun Eupago back office'inde, Webhook 2.0'ın var olduğunu, URL'sinin tam olarak Webhook URL altında gösterilen URL olduğunu, yönteminin POST olduğunu ve şifrelemenin açık olduğunu kontrol edin. Anahtarının ilgili alanda (Sandbox Webhook Key veya Live Webhook Key) olduğunu doğrulayın. Debug Log seçeneğini açın ve modül sayfasındaki Log alanına bakın. Bir bildirim hiç gelmiyorsa ödemeyi Eupago back office'te kontrol edin.

Webhook, Invalid signature veya Missing signature yanıtı veriyor: modüldeki webhook anahtarı, webhook'un anahtarıyla eşleşmiyor ya da webhook şifresiz ve imzasız. Anahtarı yeniden kopyalayın ve şifrelemeyi açık tutun.

Webhook, Webhook key not configured yanıtı veriyor: hiçbir webhook anahtarı ayarlanmamış. Anahtarı yapıştırdıktan sonra Eupago bildirimi yeniden dener.

Webhook, Decryption failed yanıtı veriyor: imza geçerli, ancak gövde çözülemedi. Eupago back office'teki Webhook 2.0 ayarlarını kontrol edin.

Webhook, Environment mismatch yanıtı veriyor: bildirim, ödemenin başlatıldığı moddan farklı bir modun anahtarıyla imzalanmış. Bir sandbox bildirimi asla canlı bir ödemeyi tamamlamaz ve tersi de geçerlidir. Sandbox ve canlı anahtarlarının yer değiştirmediğini kontrol edin.

Webhook, Order not found yanıtı veriyor: bildirim, bu mağazaya ait bir Eupago ödemesi olmayan bir sepetle ilgili; örneğin aynı Eupago kanalını kullanan başka bir mağazadan yapılmış bir ödeme.

Webhook, Busy or Retry yanıtı veriyor: sepet aynı anda başka bir istek tarafından işleniyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı olduğu için). Eupago bildirimi yeniden dener. Nedeni günlükte yer alır.

Eski callback, Invalid API key yanıtı veriyor: Eupago'nun gönderdiği API anahtarı, Live API Key veya Sandbox API Key ile eşleşmiyor. Webhook URL'sini bir tarayıcıda açtığınızda da aynı yanıt görünür; bu normaldir.

Müşteri, The MB WAY payment could not be started mesajını görüyor: telefon numarasının MB WAY ile ilişkili olduğunu kontrol edin ve yeniden deneyin.

Sipariş, ödemeden sonra Eupago payment on hold durumunda: Eupago payment bloğundaki Eupago notes bölümünü okuyun. Tutar veya para birimi farklıydı, referans bilinmiyordu ya da ödeme siparişin iptal edilmesinden sonra geldi. Ödemeyi Eupago back office'te doğrulayın, ardından siparişi tamamlayın veya müşteriye iade yapın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Eupago 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 ağ geçidi ayarları, bu modülün Eupago ödeme kayıtları ve günlük kaldırılır. Kapalıysa tüm ayarlar ve kayıtlar, sonraki bir yeniden kurulum için saklanır. Awaiting Eupago payment ve Eupago payment on hold sipariş durumları her zaman korunur. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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