VibeFox ifthenpay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Para birimi: yalnızca euro (EUR). Mağaza veya sipariş para birimi EUR değilse ödeme yöntemi gizlenir. ifthenpay 0,01 ile 99.999,99 EUR arasındaki toplamları kabul eder.

ifthenpay hesabı: ifthenpay.com üzerinden kaydolun. Sunduğunuz yöntemin anahtarına ihtiyacınız var: Multibanco, MB WAY veya Credit Card (ABC-123456 biçimi). Anahtarlar ifthenpay yönetim panelinde (backoffice.ifthenpay.com) gösterilir veya yöntem hesabınız için etkinleştirildiğinde ifthenpay tarafından gönderilir. ifthenpay ayrıca anahtarınız için callback'i etkinleştirmelidir (bkz. Yapılandırma) ve mağazanız internetten erişilebilir olmalıdı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. Ayrıca wcp_ifthenpay_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın. Eklenti anti-phishing anahtarını oluşturur.

3. Ayarları açın: WooCommerce > Settings > Payments > ifthenpay > 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. Payment Method seçin ve ilgili ifthenpay anahtarını girin. Kaydedin; böylece Callback URL seçilen yönteme uygun olur.

6. Ayarlarda gösterilen Anti-phishing Key ve Callback URL değerlerini kopyalayın ve anahtarınız için callback'i etkinleştirmesi amacıyla ifthenpay'den talepte bulunun (yönetim panelinde veya ifthenpay desteği aracılığıyla).

7. Enable/Disable seçeneğini açın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > ifthenpay. Seçilen yöntemin anahtarı olmadan ödeme yöntemi ödeme sayfasında gösterilmez ve ödeme yöntemleri listesinde işlem gerektiren olarak işaretlenir. Bu anahtar olmadan etkin bir ağ geçidini kaydettiğinizde sayfa ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. mesajını gösterir.

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

Title: ödeme sayfasında gösterilen ödeme yönteminin başlığı. Varsayılan: ifthenpay.

Description: ödeme sayfasında gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay via Multibanco, MB WAY or Credit Card. Sunduğunuz yönteme uyacak şekilde değiştirin.

Payment Method: ödeme sayfasında sunulan yöntem. Yalnızca bu yöntemin anahtarı gereklidir.

ifthenpay anahtarları

Anahtarlar (ABC-123456 biçimi) ifthenpay yönetim panelinde gösterilir veya ödeme yöntemi hesabınız için etkinleştirildiğinde ifthenpay tarafından gönderilir.

Multibanco Key: dinamik referanslar için ifthenpay Multibanco (MB) anahtarınız.

MB WAY Key: ifthenpay MB WAY anahtarınız.

Credit Card Key: ifthenpay Credit Card anahtarınız. Ayrıca müşterinin kart sayfasından dönüşünün imzasını doğrular.

Callback (ödeme bildirimleri)

Callback, mağazanıza bir ödemenin yapıldığını bildirir. Kullandığınız her anahtar için, aşağıda verilen anti-phishing anahtarı ve callback URL'si ile ifthenpay'den callback'i etkinleştirmesini isteyin. Multibanco ve MB WAY siparişleri yalnızca callback ile onaylanır; kart ödemeleri ayrıca kart sayfasından gelen imzalı dönüşle de onaylanır.

Anti-phishing Key: eklenti tarafından oluşturulur, kopyalanması için gösterilir. ifthenpay bunu her callback'te geri gönderir; bu anahtarı olmayan callback'ler reddedilir.

Callback URL: seçilen ödeme yönteminin callback URL'si, ifthenpay yer tutucularıyla birlikte, kopyalanması için gösterilir. https://your-site/wc-api/ifthenpay_payment_callback/ ile başlar ve yöntemin parametreleriyle devam eder. URL'nin tamamını ayarların gösterdiği gibi birebir kopyalayın.

Her callback'teki anti-phishing anahtarı sizinkiyle karşılaştırılır. Eksik veya hatalı anahtar 403 yanıtı alır ve sipariş değişmez. Callback ayrıca bu ağ geçidinin bir siparişiyle eşleşmelidir: Multibanco için kurum kodu (entity) ve referans ile, MB WAY için sipariş ve MB WAY isteklerinden biriyle, Credit Card için sipariş ve kart isteğiyle. Çalışan bir callback olmadan Multibanco ve MB WAY siparişleri hiçbir zaman onaylanmaz, kart ödemeleri ise yalnızca imzalı dönüşle onaylanır.

Gelişmiş

Test Mode: Enable test/sandbox mode. Kredi kartı ve Multibanco, ifthenpay sandbox uç noktalarını kullanır; gerçek para çekilmez ve ifthenpay'in sağladığı test anahtarlarını kullanırsınız. MB WAY'in sandbox'ı yoktur: ifthenpay'den alınan bir test anahtarıyla deneyin. Ödeme sayfasında bir TEST MODE rozeti gösterilir. Varsayılan: kapalı.

Order Status After Payment: onaylanmış bir ödemeden sonra ayarlanan sipariş durumu; tek bir durum değişikliği ve müşteriye tek bir e-posta ile. Yalnızca indirilebilir sanal ürün içeren siparişler her zaman WooCommerce tarafından tamamlanır.

Debug Log: Enable logging. API istekleri ve callback'ler WooCommerce > Status > Logs içine, kaynak wcp_ifthenpay_gateway olarak yazılır. Hatalar her zaman kaydedilir. Anahtarlar, anti-phishing anahtarı ve telefon numaraları hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: Remove the plugin settings, the anti-phishing key and the logs when the plugin is deleted (orders are kept). Varsayılan: kapalı.

Ödeme

Multibanco. Ödeme sayfasında müşteri You will receive a Multibanco reference to complete the payment. mesajını görür. Sipariş verildiğinde eklenti, sipariş toplamı için dinamik bir Multibanco referansı oluşturur. Sipariş Beklemede durumuna geçer, stok azaltılır ve sepet boşaltılır. Sipariş beklemedeyken gönderilen teşekkür sayfası ve sipariş e-postaları Multibanco Payment Details bilgilerini gösterir: kurum kodu (entity), referans ve tutar; altında Please use these details to pay at any Multibanco ATM or through your online banking. yer alır. Müşteri aynı tutarla siparişi yeniden verirse aynı referans kullanılır. Sipariş, ifthenpay ödeme callback'ini gönderdiğinde onaylanır.

MB WAY. Müşteri MB WAY phone number alanına numarasını girer (912 345 678, +351 912 345 678 veya diğer ülkeler için 351#912345678); fatura telefonu doldurulur. Eklenti telefona bir ödeme isteği gönderir, sipariş Beklemede durumuna geçer, stok azaltılır ve sepet boşaltılır. Teşekkür sayfasında A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. yazar. Siparişin tüm istekleri saklanır; bu yüzden uygulamada daha önce onaylanan bir istek hâlâ kabul edilir. Sipariş callback ile onaylanır.

Kredi kartı. Müşteri You will be redirected to a secure page to enter your card details. mesajını görür ve ifthenpay kart sayfasına yönlendirilir. Sipariş ödenene kadar Ödeme bekliyor durumunda kalır; stok bundan önce azaltılmaz. Başarılı bir ödemeden sonra müşteri mağazanıza geri döner. Dönüş yalnızca geçerli bir ifthenpay imzası, sipariş anahtarı, o denemeye ait bir gizli değer ve siparişin kart isteğiyle kabul edilir; ardından sipariş ödenmiş olarak işaretlenir. Dönüş doğrulanamazsa sipariş değişmez ve teşekkür sayfasında Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. mesajı gösterilir. Başarısız bir kart ödemesi siparişi Başarısız, iptal edilen bir ödeme ise siparişi Ödeme bekliyor durumunda bırakır. Her iki durumda da müşteri Pay for order sayfasına, 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 yönlendirilir.

Sipariş, ifthenpay ödemeyi onaylamadan ödenmiş olarak işaretlenmez ve tutar sipariş toplamıyla kuruşuna kadar karşılaştırılır. Ödeme başlatılamazsa müşteri kısa bir mesaj görür, örneğin The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. ya da The payment service is temporarily unavailable. Please try again in a few minutes.

Ödeme yöntemi klasik ödeme sayfasında, Sepet ve Ödeme bloklarında (MB WAY telefon alanıyla birlikte) ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti aynı anda bir ifthenpay yöntemi sunar. Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX veya Pay-by-Link, abonelik veya kayıtlı kart, ödenmemiş Multibanco referanslarının otomatik sona ermesi veya iptali ve ödeme durumu sorgulama desteklenmez.

Siparişler

Order statuses

On hold (waiting for payment): bir Multibanco referansı üretildi veya bir MB WAY isteği gönderildi. Ödenmemiş referanslar otomatik olarak iptal edilmez; gerekirse bu siparişleri kendiniz iptal edin.

Pending payment: bir kart ödemesi başlatıldı ve henüz onaylanmadı veya iptal edildi.

Processing or Completed: ödeme onaylandı. Durum Order Status After Payment ayarını izler. Sipariş notunda Multibanco kurum kodu (entity) ve referansı, MB WAY işlemi veya kart isteği kimliği gösterilir.

On hold after payment: alınan tutar sipariş toplamından farklıydı ya da ödeme sipariş iptal edildikten sonra geldi. Sipariş notu bunu açıklar. Ödemeyi ifthenpay yönetim panelinde kontrol edin ve siparişi manuel olarak tamamlayın veya iade edin.

Failed: müşteri kart sayfasından bir hatayla geri döndü.

Zaten ödenmiş bir sipariş için ikinci bir ödeme bildirimi yalnızca bir not ekler; böylece ifthenpay yönetim panelinde yinelenen bir ödemeyi kontrol edebilirsiniz. İade edilen siparişler ve ödemeden sonra iptal edilen siparişler hiçbir zaman yeniden açılmaz.

İadeler

WooCommerce'ten yapılan iadeler desteklenmez. Ödemeyi ifthenpay yönetim panelinde iade edin ve WooCommerce'te manuel olarak kaydedin. İade edildi (DEVOLVIDO) callback'i yalnızca bir sipariş notu ekler. ifthenpay'in bildirdiği diğer durumlar da yalnızca not ekler.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > ifthenpay 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 aktif olduğu 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 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ın bir siteden kaldırılması alan adı hakkını boşaltmaz. Hakkı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan ifthenpay, ö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. Giriş yapmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins 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ı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

ifthenpay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, seçilen Payment Method anahtarının girildiğini, para biriminin EUR olduğunu ve toplamın 0,01 ile 99.999,99 EUR arasında olduğunu kontrol edin. Pay for order sayfasında sipariş para birimi geçerlidir.

Müşteri ödedi ama sipariş On hold veya Pending payment durumunda kalıyor: callback mağazanıza ulaşmıyor. ifthenpay'in kullandığınız anahtar için callback URL'sini ve anti-phishing anahtarını etkinleştirdiğini ve URL'nin seçilen yönteme ait olduğunu kontrol edin. Site internetten erişilebilir olmalı; localhost'ta veya giriş arkasında olmamalıdır. WooCommerce > Status > Logs içinde, kaynak wcp_ifthenpay_gateway, Callback rejected satırlarını arayın.

Callback 403 Forbidden yanıtı veriyor: callback'teki anti-phishing anahtarı eksik veya ayarlardakinden farklı. Ayarlarda gösterilen anahtarı ifthenpay'e yeniden gönderin.

Callback 503 Not configured yanıtı veriyor: anti-phishing anahtarı henüz oluşturulmadı. Ayarlar sayfasını bir kez açın; ifthenpay callback'i yeniden dener.

Callback Order not found yanıtı veriyor: referans veya istek bu ağ geçidinin bir siparişine ait değil; örneğin ödeme yöntemi siparişten sonra değiştirildiği için.

Neden ödenmiş bir sipariş On hold durumuna alındı? Alınan tutar sipariş toplamından farklıydı ya da ödeme sipariş iptal edildikten sonra geldi. Sipariş notunu okuyun, ödemeyi ifthenpay yönetim panelinde kontrol edin ve siparişi manuel olarak tamamlayın veya iade edin.

MB WAY isteği gönderilemedi: telefon numarası MB WAY'e bağlı değil veya biçimi yanlış. 912 345 678 kullanın; diğer ülkelerin numaraları için 351#912345678 kullanın.

Test modu ve MB WAY: ifthenpay'in MB WAY için sandbox'ı yoktur; ifthenpay'in sağladığı bir test anahtarı kullanın.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için 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ı, anti-phishing anahtarı 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 ifthenpay verileri (referanslar, istek kimlikleri) her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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