VibeFox Eupago for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin.

PHP: 8.0 veya üzeri.

Mağaza para birimi: euro (EUR). Eupago yalnızca euro ile tahsilat yapar; bu nedenle diğer para birimlerinde ö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 bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_eupago_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Eupago > 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 bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. 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).

6. Payment Method seçeneğini belirleyin, Enable/Disable seçeneğini açın, sandbox modunda bir test siparişi verin, ardından Sandbox Mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Eupago. Ağ geçidi etkinken, geçerli modun API anahtarı boşsa sayfa sizi uyarır (bu durumda ağ geçidi ödeme sayfasında gizlenir) veya sandbox modu açıkken Sandbox mode: no real payments are taken. mesajını gösterir. Ödeme yöntemleri listesinde, geçerli modun API anahtarı girilene kadar Eupago işlem gerektiren olarak işaretlenir ve sandbox modunda bir test modu rozeti gösterilir.

Genel

Enable/Disable: Enable Eupago Gateway ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Eupago.

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.

Order Status After Payment: ödeme onaylandığında ayarlanan sipariş durumu: Processing (varsayılan) veya Completed. Durum hemen ayarlanır; tek bir durum değişikliği ve tek bir e-posta gönderilir.

Eupago hesabı

Kanalınızın API anahtarını ve Webhook 2.0 anahtarını Eupago back office'ten alın: clientes.eupago.pt (canlı) veya sandbox.eupago.pt (sandbox).

Sandbox Mode: Enable sandbox/test mode, sandbox.eupago.pt adresini ve sandbox anahtarlarını kullanır. Gerçek ödeme alınmaz. Varsayılan: on. Canlı anahtarlarla gerçek ödemeler almak için işaretini kaldırın.

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

Webhook URL

Webhook, mağazanıza bir ödemenin yapıldığını bildirir. Eupago back office'te, ayarların bu bölümünde gösterilen URL ile, POST yöntemi ve şifreleme etkin olacak şekilde bir Webhook 2.0 oluşturun. URL şöyle görünür: https://your-site/wc-api/eupago_payment_callback/. 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. Şifrelenmemiş bir webhook yalnızca Eupago imzaladığında kabul edilir, bu nedenle şifrelemeyi açık tutun. Eklenti aşağıdaki bildirim durumlarına yanıt verir:

Diğer durumlar için 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: eklenti Eupago'yu sorgulamaz ve müşterinin geri dönmesi bir siparişi ödemez.

Gelişmiş

Debug Log: Enable logging, API çağrılarını ve bildirimleri WooCommerce > Status > Logs sayfasına, kaynak wcp_eupago_gateway olarak yazar. Anahtarlar, e-postalar ve tam telefon numaraları günlüğe yazılmaz. Hatalar her zaman günlüğe yazılır. Varsayılan: off.

Delete Data on Uninstall: Delete all plugin data when uninstalling. İşaretliyse, eklenti silindiğinde ağ geçidi ayarları ve günlükler kaldırılır. Siparişler ve ödeme verileri korunur. Varsayılan: off.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Eupago) ve siparişi verir. Sandbox modunda ödeme sayfasında SANDBOX / TEST MODE gösterilir. Sonrasında olanlar Payment Method seçeneğine 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. Eklenti, sipariş toplamı için bir Multibanco referansı oluşturur. Sipariş Beklemede durumuna alınır, stok düşülür ve sepet boşaltılır. Sipariş alındı sayfasında kuruluş, referans ve tutar ile birlikte Multibanco Payment Details gösterilir. Sipariş ödeme beklerken aynı bilgiler müşterinin sipariş e-postasına da eklenir. Müşteri ATM'de veya internet bankacılığında öder.

MB WAY: ödeme sayfasında müşteri, fatura telefonuyla doldurulmuş MB WAY Phone Number alanını kullanır. Portekiz numaraları +351 olmadan girilebilir. Hatalı bir numara Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). mesajını verir. Eklenti ödeme isteğini MB WAY uygulamasına gönderir. Sipariş Beklemede durumuna alınır, stok düşülür ve sepet boşaltılır. Sipariş alındı sayfası, müşteriden 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, site diline göre Portekizce, İspanyolca veya İngilizce olan Eupago kart sayfasına gönderilir. Sipariş Ödeme bekleniyor durumunda kalır ve sepet korunur. Ödemeden sonra müşteri, bildirim gelene kadar Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. mesajını gösteren sipariş alındı sayfasına döner. Kart ödemesi başarısız olursa veya yarım bırakılırsa müşteri Pay for order sayfasına düşer ve 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ını görür.

Her yöntemde sipariş, Eupago doğrulanmış bir bildirimle onaylamadan ödenmiş olarak işaretlenmez. Müşteri, ödenmemiş bir siparişi Pay for order sayfasından yeniden ödeyebilir; siparişe oluşturulan her ödeme referansı kontrol için geçerli kalır.

Eupago ödemeyi başlatamazsa müşteri kısa bir mesaj görü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ş değişmez, ayrıntılar günlüktedir.

Ö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. Müşteriye gösterilen metinler Portekizceye çevrilmiştir.

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

Siparişler

Sipariş durumları

Pending payment: bir kart ödemesi başlatıldı ve Eupago henüz onaylamadı.

On hold, awaiting payment: bir Multibanco referansı veya bir MB WAY isteği oluşturuldu. Sipariş notunda kuruluş ve referans ya da maskelenmiş telefon numarası gösterilir.

Processing or Completed: ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Sipariş notunda yöntem, Eupago işlem kimliği ve referans gösterilir. Siparişin işlem kimliği, Eupago işlem kimliğidir.

On hold, manual review: Eupago, farklı bir tutar veya para birimiyle, bu sipariş için oluşturulmamış bir referansla ya da bu sırada iptal edilmiş veya başarısız olmuş bir sipariş için bir ödeme bildirdi (örneğin geç ödenen bir Multibanco referansı). 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: Eupago, ödenmemiş bir siparişin geçerli ödeme denemesi için ödemeyi iptal edilmiş veya süresi dolmuş olarak bildirdi.

Failed: Eupago, ödenmemiş bir siparişin geçerli ödeme denemesi için bir hata bildirdi.

Eupago, zaten ödenmiş bir sipariş için başka bir ödeme bildirirse (örneğin eski bir Multibanco referansı da ödenmişse), sipariş değiştirilmez. Bir not, mükerrer ödemeyi kontrol etmenizi ve Eupago back office'te iade etmenizi ister. Ödenmiş ve sonradan iptal edilmiş ya da iade edilmiş bir siparişi, ödeme bildirimi asla yeniden açmaz.

İadeler: WooCommerce üzerinden iade desteklenmez. Müşteriye Eupago back office'te iade yapın ve iadeyi WooCommerce'te Refund manually ile kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Eupago sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın etkin olduğu tarihi 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Eupago, 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: 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. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Eupago ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun API anahtarının girildiğini (sandbox modunda Sandbox API Key, canlı modda Live API Key) ve mağaza para biriminin EUR olduğunu kontrol edin. Multibanco ile sipariş tutarı 1 € ile 999 999,99 € arasında olmalıdır.

Ödeme geçti ama sipariş Pending payment veya On hold durumunda kalıyor: Eupago bildirimi gelmiyor ya da reddediliyor. Kullandığınız modun Eupago back office'inde Webhook 2.0'ın var olduğunu, URL'sinin ayarlarda gösterilenle birebir aynı olduğunu, yönteminin POST olduğunu ve şifrelemenin açık olduğunu kontrol edin. Anahtarının doğru alanda (Sandbox Webhook Key veya Live Webhook Key) olduğunu doğrulayın. Debug Log seçeneğini açın ve WooCommerce > Status > Logs sayfasında, kaynak wcp_eupago_gateway olarak bakın. Bir bildirim hiç gelmiyorsa ödemeyi Eupago back office'te kontrol edin.

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

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

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

Webhook, Environment mismatch yanıtı veriyor: bildirim, siparişin verildiği moddan farklı modun anahtarıyla imzalanmış. Bir sandbox bildirimi asla canlı bir siparişi ödemez, ve tersi de geçerlidir.

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.

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 edip yeniden deneyin.

Ödemeden sonra sipariş On hold durumunda: sipariş notunu okuyun. Tutar veya para birimi farklıydı, referans bilinmiyordu ya da ödeme sipariş iptal edildikten sonra geldi. Ödemeyi Eupago back office'te doğrulayın, ardından siparişi tamamlayın veya müşteriye iade yapın.

Lisans bölümü bir hata gösteriyor: bölümdeki 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Geliştiriciler için: eklenti belgeleri eupago_p_icon (ödeme sayfası simgesi) ve eupago_p_card_language (Eupago kart sayfasının dili: PT, EN veya ES) filtrelerini listeler.

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 Delete Data on Uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Siparişler ve Eupago referansları her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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