VibeFox Eupago for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: euro (EUR). Eupago yalnızca euro ile tahsilat yapar, bu nedenle mağazanızda euro etkin olmalıdır; müşteri başka bir para biriminde ödeme yaptığında ödeme yöntemi ödeme sayfasında gizlenir.

Eupago hesabı: Eupago kanalınızın API anahtarına ve Eupago backoffice'te oluşturacağınız bir Webhook 2.0'ın anahtarına ihtiyacınız var (bkz. Yapılandırma). Canlı backoffice clientes.eupago.pt, sandbox backoffice 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

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_eupago_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_eupago_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi yükleyin. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_eupago_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve Payments türünü seçin. VibeFox Eupago Gateway öğesini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğundaki License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

5. Payment Method seçeneğini seçin, 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.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_eupago_gateway.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki yüklü eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve tür olarak Payments seçin. VibeFox Eupago Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını, Eupago anahtarlarını ve webhook'u OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları her iki sürümde aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Webhook URL).

Yeni bir kurulum, ödeme yöntemi kapalı ve sandbox modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Eupago Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ödeme yöntemi etkinleştirildiğinde, geçerli modun API anahtarı boşsa sayfa ayarların üstünde sizi uyarır (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) veya sandbox modu açıkken Sandbox mode: no real payments are taken. ifadesini gösterir. Eklentiyi değiştirme izni olmadan sayfa ayarları gösterir ancak kaydedemez.

Kaydederken başlık boş olamaz ve 128 karakterden uzun olamaz, bir ödeme yöntemi seçilmelidir, Sort Order tam sayı olmalı, Total sıfırdan küçük olmayan bir sayı olmalı ve bölge (geo zone) ile sipariş durumları mevcut olmalıdır. Aksi takdirde bir hata sorunu belirtir, örneğin Enter a title for the payment method (1 to 128 characters)., ve hiçbir şey kaydedilmez.

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, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında, onay düğmesinin üstünde gördüğü metin. Varsayılan: Pay securely via Eupago.

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

Sort Order: Eupago'nun ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Eupago'yu yalnızca seçilen bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones bölümünde tanımlanır.

Total: Eupago'nun sunulması için siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Herhangi bir tutar için Eupago sunmak üzere boş bırakın. Bu alandan bağımsız olarak Eupago yalnızca müşteri EUR ile ödeme yaptığında sunulur, Multibanco ise yalnızca 1 € ile 999 999,99 € arasındaki tutarlarda sunulur.

Eupago hesabı

Kanalınızın API anahtarını ve Webhook 2.0 anahtarını Eupago backoffice'ten 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çıkken müşteriler Confirm Order adımı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ı.

Kayıtlı anahtarlar 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. Kayıtlı bir anahtarı kaldırmak için alanın altındaki Clear the saved key on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook URL

Webhook, mağazanıza bir ödemenin yapıldığını bildirir. Eupago backoffice'te, bu bölümde gösterilen URL ile, POST yöntemi ve şifreleme etkin olacak şekilde bir Webhook 2.0 oluşturun. OpenCart 3'te URL şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_eupago_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_eupago_gateway/payment/wcp_eupago_gateway.webhook biçimindedir ve OpenCart kurulumunuzun mağaza vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın. Sandbox backoffice'te bir webhook, canlı backoffice'te ise bir başka 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. Şifrelenmemiş bir webhook yalnızca Eupago tarafından imzalanmışsa kabul edilir, bu nedenle şifrelemeyi açık tutun. Bir bildirim, ödemenin başlatıldığı modun anahtarıyla imzalanmış olmalıdır; bu nedenle bir sandbox bildirimi asla canlı bir ödemeyi tamamlamaz. Eklenti bu bildirim durumlarına tepki verir:

Diğer durumlar için işlem gerekmez. Eupago'nun aynı URL'ye gönderdiği eski GET geri çağırması da kabul edilir; API anahtarıyla doğrulanır ve her zaman bir ödemeyi bildirir. Bildirim olmadan siparişler asla ödenmiş olarak işaretlenmez: eklenti Eupago'yu sorgulamaz ve müşterinin geri dönmesi bir siparişi ödemez. Webhook, mağaza bakım modundayken de çalışır, çünkü OpenCart 3 ödeme eklentisi isteklerine izin verir ve OpenCart 4'te eklenti bunun için bir başlangıç eylemi ekler (ayrıca kart sayfasından müşteri dönüşü için de).

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Multibanco ve MB WAY ile, Eupago referansı veya MB WAY isteğini oluşturduğu anda sipariş bekleme durumunu alır. Kartla ödemede sipariş yalnızca Eupago bildiriminden bir durum alır. Sipariş, yalnızca doğrulanmış bir bildirim geldiğinde ve modu, referansı, tutarı ve para birimi siparişle eşleştiğinde ödenmiş olarak işaretlenir. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

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

Awaiting payment status: Multibanco referansı veya MB WAY isteği oluşturuldu ve müşterinin hâlâ ödeme yapması gerekiyor. Multibanco ayrıntıları bu durumla birlikte gönderilir (sipariş e-postasında ve müşterinin sipariş geçmişinde). Varsayılan: Beklemede.

Manual review status: Eupago, siparişle eşleşmeyen bir ödeme (tutar, para birimi, referans), siparişin iptal edilmesinden sonra gelen bir ödeme veya sepeti zaten ödenmiş olan bir siparişin ödemesini bildirdi. Bir not nedenini açıklar. Varsayılan: Beklemede, çünkü OpenCart'ta Askıda durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Cancelled status: Eupago, bekleyen bir siparişin mevcut ödemesinin iptal edildiğini veya süresinin dolduğunu bildirdi. Varsayılan: Canceled.

Failed status: Eupago, bekleyen bir siparişin mevcut ödemesinde bir hata (ERROR) bildirdi. Varsayılan: Failed.

Gelişmiş

Debug Log: API çağrılarını ve bildirimleri OpenCart günlük klasöründe (storage/logs) bulunan eupago_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında eupago_p_debug.old.log.php dosyasına taşınır. Anahtarlar, e-posta adresleri ve tam telefon numaraları 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 Data on Uninstall: açıkken eklentiyi kaldırmak, geçit (gateway) ayarlarını ve günlüğü siler. Siparişler ve Eupago ödeme kayıtları korunur. Varsayılan: kapalı.

İçe Aktarma / Dışa Aktarma

Export: Download JSON, ayarları bir JSON dosyası olarak kaydeder. API ve webhook anahtarları dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı anahtarlar korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Eupago). OpenCart siparişi Confirm Order adımında oluşturur, hâlâ durumsuz olarak. OpenCart 4'te müşteri ödeme yöntemini, Payment method options penceresindeki ödeme yöntemi bloğunun Choose düğmesiyle seçer ve sayfanın altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında ne olacağı Payment Method seçeneğine bağlıdır.

Multibanco: müşteri You will receive Multibanco payment details after placing the order. ifadesini görür. Eklenti, sipariş toplamı için euro cinsinden bir Multibanco referansı oluşturur ve sipariş Awaiting payment status durumunu alır. Sipariş e-postası ve müşterinin sipariş geçmişi, varlık, referans ve tutarı içeren Multibanco Payment Details yorumunu alır. Sipariş başarı sayfası aynı ayrıntıları gösterir. Müşteri bir ATM'de veya internet bankacılığında öder.

MB WAY: müşteri, siparişteki telefonla doldurulmuş olan MB WAY Phone Number alanını girer. Portekiz numaraları +351 olmadan girilebilir. OpenCart 4'te telefon varsayılan olarak istenmez, bu nedenle alan genellikle boştur ve müşteri numarayı kendisi girer. Yanlış bir numara Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). uyarısını verir. Eklenti ödeme isteğini MB WAY uygulamasına gönderir ve sipariş Awaiting payment status durumunu alır. Başarı sayfası müşteriden, maskelenmiş telefon numarasındaki MB WAY uygulamasını açmasını ve isteği 5 dakika içinde onaylamasını ister. Eupago isteği reddederse müşteri Confirm Order adımında kalır ve The MB WAY payment could not be started. Check that the phone number is associated with MB WAY and try again. mesajını görür.

Credit Card: müşteri You will be redirected to a secure payment page to enter your card details. ifadesini görür. Müşteri, mağaza diline göre Portekizce, İspanyolca veya İngilizce olan Eupago kart sayfasına gönderilir. Sipariş durumsuz kalır ve sepet korunur. Müşteri geri döndüğünde bildirim gelmişse OpenCart sipariş başarı sayfasını görür. Aksi halde bir Payment confirmation sayfası Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. ifadesini ve Check again ile Back to checkout düğmelerini gösterir. 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. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

Tüm yöntemlerde sipariş, Eupago doğrulanmış bir bildirimle ödemeyi onaylayana kadar ödenmiş olarak işaretlenmez. Sipariş daha sonra stok güncellemesiyle birlikte OpenCart'ın standart yöntemiyle bir durum alır. Ödeme ayrıntıları yalnızca sipariş ödeme beklerken başarı sayfasında gösterilir. Eupago ödemeyi zaten iptal edilmiş, süresi dolmuş veya başarısız olarak bildirmişse başarı sayfası Your Eupago payment was not completed. Please contact us about this order. ifadesini gösterir.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur. OpenCart 4 siparişi günceller, bu nedenle iptal edilen veya başarısız olan bir kart ödemesinden sonra müşteri aynı siparişi yeni bir Eupago ödemesiyle öder. Aynı sepetin önceki bir siparişi zaten Eupago ile ödenmişse müşteri başarı sayfasına gider ve yeni bir ödeme oluşturulmaz.

OpenCart 4, siparişi başarı sayfası gösterilene kadar ödeme sayfasında tutar. Bu sipariş bu arada ödeme yapılmadan kapatıldıysa (örneğin Multibanco referansının süresi dolduysa, MB WAY isteği reddedildiyse ya da siz siparişi iptal ettiyseniz), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order işlemi sepet için yeni bir sipariş öder. Bu sipariş zaten ödenmişse ya da ödeme bekliyorsa ama sepet o zamandan beri değişmişse (yeni bir adet dahil), mesaj şudur: Your previous order is already paid or awaiting its payment. Please confirm the order again: the cart will be paid with a new order. Ödenmiş bir sipariş, farklı bir sepet için asla ödenmiş gibi gösterilmez.

Eupago ödemeyi başlatamazsa müşteri, düğmenin üstünde kısa bir mesajla Confirm Order adımı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ş durumsuz kalır ve ayrıntılar günlüğe yazılır.

Eklenti, kurulum başına bir Eupago yöntemi sunar. Mağazadan iade, kayıtlı kart, abonelik veya ön yetkilendirme, PayShop, Cofidis Pay, Bizum veya diğer Eupago yöntemleri, SMS hatırlatmaları, Multibanco son ödeme tarihi ve durum sorgulama desteği yoktur.

Siparişler

Sipariş durumları

No status (missing order): bir kart ödemesi başlatıldı ve Eupago bunu henüz onaylamadı veya başarısız oldu. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Awaiting payment status (default Pending): bir Multibanco referansı veya MB WAY isteği oluşturuldu. Not, varlığı ve referansı veya maskelenmiş telefon numarasını gösterir.

Order Status After Payment (default Processing): ödeme onaylandı. Bir not, yöntemi, Eupago işlem kimliğini ve referansı gösterir.

Manual review status (default Pending): Eupago; tutarı veya para birimi farklı bir ödeme, bu sipariş için oluşturulmamış bir referansla yapılan ödeme, bu arada iptal edilmiş veya başarısız olmuş bir sipariş için yapılan ödeme (örneğin geç ödenen bir Multibanco referansı) ya da sepeti başka bir sipariş tarafından zaten ödenmiş bir sipariş için yapılan ödeme bildirdi. Not bunu açıklar. Ödemeyi ve stoğu kontrol edin, ardından siparişi elle tamamlayın veya müşteriye iade yapın. Bu ödeme için sonraki bildirimler, siparişi sizin haberiniz olmadan tamamlamaz.

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

Failed status (default Failed): 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 ödenmişse) sipariş değişmez. Bir not, çift ödeme olup olmadığını kontrol etmenizi ve bunu Eupago backoffice'te iade etmenizi ister. Ödenmiş ve sonradan iptal edilmiş veya iade edilmiş bir siparişi, ödeme bildirimi asla yeniden açmaz. Notlar, müşterinin görmediği siparişin History bölümündeki kayıtlardır.

VibeFox Eupago Gateway sekmesi

Sales > Orders bölümünde Eupago ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Eupago Gateway sekmesi, siparişin her ödeme denemesini listeler: Date, Method (sandbox ödemeleri için Sandbox etiketiyle), Amount, Entity / reference / phone, Eupago transaction ID ve Status. Manuel incelemedeki bir sipariş için sekme bir uyarı gösterir. Altında Eupago notes, eklentinin siparişle ilgili notlarını listeler. Sekme salt okunurdur ve eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Bu eklentide iadeler kullanılamaz. Müşteriye iadeyi Eupago backoffice'te yapın ve gerekirse siparişi OpenCart'ta elle güncelleyin. Sales > Returns bölümündeki ürün iadeleri Eupago üzerinden para geri göndermez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Eupago Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Eupago Gateway > Edit sayfasında, ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve 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üğmelerini gösterir. Bunların altında Product: opencart-payment-eupago satırı ve hesabınızda vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; ö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 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. 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 yoksa 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. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin anahtar yoksa ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard veya Edit sayfası açıldığında durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Eupago does not appear at checkout: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun API anahtarının (sandbox modunda Sandbox API Key, canlı modda Live API Key) ayarlandığını kontrol edin. Müşteri EUR ile ödeme yapmalıdır; Multibanco ile sipariş toplamı 1 € ile 999 999,99 € arasında olmalıdır. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda tanımlı Total tutarına ulaştığını kontrol edin.

The payment went through, but the order stays in the awaiting status or without a status: Eupago bildirimi ulaşmıyor veya reddediliyor. Kullandığınız modun Eupago backoffice'inde Webhook 2.0'ın var olduğunu, URL'sinin tam olarak Webhook URL alanında gösterilen URL olduğunu, yönteminin POST 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 eklenti sayfasındaki Log alanına bakın. Bir bildirim hiç gelmiyorsa ödemeyi Eupago backoffice'te kontrol edin.

Webhook answers Invalid signature or Missing signature: eklentideki webhook anahtarı, webhook'un anahtarıyla eşleşmiyor ya da webhook şifrelenmemiş ve imzalanmamış. Anahtarı yeniden kopyalayın ve şifrelemeyi açık tutun.

Webhook answers Webhook key not configured: hiçbir webhook anahtarı ayarlı değil. Anahtarı yapıştırdıktan sonra Eupago bildirimi yeniden dener.

Webhook answers Decryption failed: imza geçerli, ancak gövde çözülemedi. Eupago backoffice'teki Webhook 2.0 ayarlarını kontrol edin.

Webhook answers Environment mismatch: 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 yer değiştirmediğini kontrol edin.

Webhook answers Order not found: bildirim, bu mağazanın bir Eupago ödemesi olmayan bir siparişe aittir; örneğin aynı Eupago kanalını kullanan başka bir mağazadan yapılmış bir ödeme.

Webhook answers Busy or Retry: sipariş aynı anda başka bir istek tarafından işleniyordu veya işlem başarısız oldu. Eupago bildirimi yeniden dener. Neden günlükte yazar.

Legacy callback answers Invalid API key: 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.

The customer sees This payment method is temporarily unavailable: geçerli modun API anahtarı eksik. Ayarlarda girin.

The customer sees The MB WAY payment could not be started: telefon numarasının MB WAY ile ilişkili olduğunu kontrol edip tekrar deneyin.

Order is in the manual review status after payment: VibeFox Eupago Gateway sekmesindeki Eupago notes bölümünü okuyun. Tutar veya para birimi farklıydı, referans bilinmiyordu, ödeme siparişin iptalinden sonra geldi veya sepet başka bir sipariş tarafından zaten ödenmişti. Ödemeyi Eupago backoffice'te doğrulayın, ardından siparişi tamamlayın veya müşteriye iade yapın.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Eupago Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları ve bakım modunda webhook ile müşteri dönüşüne izin veren başlangıç eylemi de kaldırılır). Delete Data on Uninstall açıksa diğer geçit ayarları (başlık, açıklama, ödeme yöntemi, sandbox modu, anahtarlar, hata ayıklama günlüğü) ve günlük kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. Siparişlerin Eupago ödeme kayıtları her zaman korunur; bu nedenle eski siparişler için geç gelen bildirimler yeniden kurulumdan sonra da çalışmaya devam eder. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te dosyaları da kaldırmak için, kaldırmadan sonra Extensions > Installer bölümüne gidin, yüklü eklentiler listesinde VibeFox Eupago Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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