VibeFox ifthenpay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 – 9.x.

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

Para birimi: yalnızca euro (EUR). Sepet para birimi EUR değilse ödeme yöntemi gizlenir. ifthenpay, 0,01 ile 99.999,99 EUR arasındaki tutarları kabul eder.

ifthenpay hesabı: ifthenpay.com üzerinden kayıt olun. Sunduğunuz yöntemin anahtarına ihtiyacınız var: Multibanco, MB WAY veya Credit Card (biçim ABC-123456). Anahtarlar ifthenpay back office'inde (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 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 veya daha sonra modül listesinde VibeFox ifthenpay Gateway öğesini bulup Configure düğmesine tıklayın. Modül, kurulum sırasında kendi anti-phishing anahtarını oluşturur.

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. Payment Method seçin, bu yöntemin ifthenpay anahtarını girin ve Callback URL seçilen yönteme uyacak şekilde Save düğmesine tıklayın.

5. Ayarlarda gösterilen Anti-phishing Key ve Callback URL değerlerini kopyalayın ve anahtarınız için callback'i etkinleştirmesini ifthenpay'den isteyin (back office üzerinden veya ifthenpay desteği aracılığıyla).

6. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

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

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox ifthenpay Gateway > Configure. Save düğmesi bulunan her bölüm tüm sayfayı kaydeder. Seçilen yöntemin anahtarı olmadan ödeme yöntemi ödeme sayfasında gösterilmez. Ağ geçidi bu anahtar olmadan etkinken sayfa ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. mesajını gösterir.

ifthenpay

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

Title: ödeme sayfasında gösterilen ödeme yöntemi başlığı. Aynı zamanda siparişte kaydedilen ödeme yöntemi adıdır. 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ı zorunludur.

ifthenpay anahtarları

Anahtarlar (biçim ABC-123456) ifthenpay back office'inde 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 gelen dönüşün imzasını doğrular.

Kaydedilmiş 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.

Clear saved keys: bir anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan, kayıtlı değeri korur.

Callback (ödeme bildirimleri)

Callback, mağazanıza bir ödemenin yapıldığını bildirir. Kullandığınız her anahtar için ifthenpay'den, aşağıdaki anti-phishing anahtarı ve callback URL'si ile 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: modül tarafından oluşturulur ve kopyalanabilmesi için gösterilir. ifthenpay bunu her callback'te geri gönderir; bu anahtarı içermeyen callback'ler reddedilir.

Callback URL: seçilen ödeme yönteminin callback URL'si, ifthenpay yer tutucularıyla birlikte kopyalanabilmesi için gösterilir. Dostça URL'ler etkinse şöyle başlar: https://your-shop/module/wcp_ifthenpay_gateway/callback; önüne /en/ gibi bir dil kodu eklenmiş olabilir ve ardından yöntemin parametreleri gelir. URL'nin tamamını ayarlarda gösterildiği gibi kopyalayın.

Her callback'teki anti-phishing anahtarı sizinkiyle karşılaştırılır. Eksik veya yanlış anahtar 403 yanıtı alır ve sipariş değişmez. Callback ayrıca bu modülün bir ödemesiyle eşleşmelidir: Multibanco için kurum kodu (entity) ve referans ile, MB WAY için sepet ve sepetin MB WAY isteklerinden biri ile, Credit Card için sepet ve sepetin kart isteklerinden biri ile. Çalışan bir callback olmadan Multibanco ve MB WAY siparişleri hiçbir zaman onaylanmaz; kart ödemeleri yalnızca imzalı dönüşle onaylanır. Callback, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasından etkilenmez.

Gelişmiş

Test Mode: Credit Card ve Multibanco, ifthenpay sandbox uç noktalarını kullanır; gerçek para alınmaz ve ifthenpay'in sağladığı test anahtarlarını kullanırsınız. MB WAY'in sandbox'ı yoktur: ifthenpay'den aldığınız bir test anahtarıyla deneyin. Ödeme sayfasında bir TEST MODE rozeti gösterilir. Varsayılan: off.

Order Status After Payment: onaylanmış bir ödemeden sonra siparişe atanan durum; tek bir durum değişikliği yapılır.

Debug Log: API istekleri ve callback'ler, modül klasöründeki logs/ifthenpay_p_debug.log.php dosyasına yazılır. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Anahtarlar, anti-phishing anahtarı ve tam telefon numaraları hiçbir zaman kaydedilmez. Varsayılan: off.

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

Delete Data on Uninstall: açıkken modül kaldırıldığında modül ayarları, anti-phishing anahtarı ve günlük silinir. Siparişler ve ifthenpay ödeme kayıtları her zaman kalır. Varsayılan: off.

Ödeme

Multibanco. Ödeme sayfasında müşteri You will receive a Multibanco reference to complete the payment. mesajını görür. Müşteri onayladığında modül, sepet toplamı için dinamik bir Multibanco referansı oluşturur ve sipariş Awaiting ifthenpay payment durumunda oluşturulur. Sipariş onay sayfasında Multibanco Payment Details gösterilir: kurum kodu (entity), referans ve tutar; ayrıca Please use these details to pay at any Multibanco ATM or through your online banking. yazar. Aynı bilgiler sipariş onay e-postasına da eklenir. Sipariş, ifthenpay ödeme callback'ini gönderdiğinde ödenmiş olur.

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 adresindeki telefon otomatik doldurulur. Modül telefona bir ödeme isteği gönderir ve sipariş Awaiting ifthenpay payment durumunda oluşturulur. Sipariş onay sayfasında A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. yazar. Sipariş, ifthenpay callback'i gönderdiğinde ödenmiş olur. Yalnızca maskelenmiş bir telefon numarası saklanı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. Henüz bir sipariş yoktur ve sepet korunur. Başarılı bir ödemeden sonra müşteri mağazanıza geri döner. Dönüş yalnızca geçerli bir ifthenpay imzası, sepetin güvenli anahtarı, bu denemeye ait bir gizli değer ve sepetin kart isteğiyle kabul edilir; ardından sipariş ödenmiş olarak oluşturulur ve müşteri standart sipariş onay sayfasını görür. Dönüş doğrulanamazsa hiçbir şey değişmez ve Payment confirmation sayfasında Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. mesajı ile Check again düğmesi gösterilir; callback geldiğinde sipariş oluşturulur. Kart ödemesi başarısız olur veya iptal edilirse müşteri ödeme sayfasına geri döner ve The card payment was not completed. You can try again or choose another payment method. veya The card payment was cancelled. You can try again or choose another payment method. mesajını görür. Sepetin her kart denemesi saklanır; bu nedenle daha eski bir sekmede yapılan ödeme de kabul edilir.

Sipariş, ancak ifthenpay ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir ve tutar sipariş toplamıyla kuruşuna kadar karşılaştırılır. Ödeme başlatılamazsa müşteri kısa bir mesajla ödeme sayfasında kalı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. veya The payment service is temporarily unavailable. Please try again in a few minutes. Teknik neden günlüğe yazılır.

Modül aynı anda yalnızca 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

Sipariş durumları

No order yet: bir kart ödemesi başlatıldı ve henüz onaylanmadı ya da başarısız oldu veya iptal edildi. Yalnızca sepet vardır.

Awaiting ifthenpay payment: bir Multibanco referansı verildi veya bir MB WAY isteği gönderildi. PrestaShop, sipariş oluşturulduğunda stoku azaltır. Ödenmemiş referanslar ve reddedilen MB WAY istekleri siparişi otomatik olarak iptal etmez; gerekirse bu siparişleri kendiniz iptal edin.

Payment accepted or Delivered: ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Ödeme; işlem kimliği olarak Multibanco referansı, MB WAY istek kimliği veya kart isteği kimliği ile kaydedilir ve bir not onaylanma şeklini gösterir.

ifthenpay payment on hold: alınan tutar sipariş toplamından farklıydı (örneğin kart ödemesi başladıktan sonra sepet değiştirildi) veya ödeme, sipariş iptal edildikten sonra geldi. Not bunu açıklar ve müşteriden tekrar ödeme istenmez. Ödemeyi ifthenpay back office'inde kontrol edin ve siparişi manuel olarak tamamlayın veya iade edin. Bu siparişe sonradan gelen doğru bir ödeme siparişi değiştirmez.

Zaten ödenmiş bir sipariş için ikinci bir ödeme yalnızca ifthenpay back office'inde mükerrer ödemeyi kontrol etmeniz için bir not ekler. İade edilen siparişler ve ödemeden sonra iptal edilen siparişler hiçbir zaman yeniden açılmaz.

ifthenpay ödeme bloğu

Sipariş sayfasında, siparişin ödeme denemelerini gösteren bir ifthenpay payment bloğu bulunur (tarih, yöntem, test ödemeleri için bir Sandbox rozeti, tutar, Multibanco kurum kodu ve referansı ya da maskelenmiş MB WAY telefonu, ifthenpay istek kimliği ve durum). Sipariş ifthenpay payment on hold durumundayken bir Manual review uyarısı ve siparişin ifthenpay notes notları gösterilir.

İadeler

PrestaShop'tan yapılan iadeler desteklenmez. Ödemeyi ifthenpay back office'inde iade edin ve PrestaShop'ta manuel olarak kaydedin. İade edildi (DEVOLVIDO) olarak bildirilen bir callback yalnızca bir not ekler. ifthenpay'in bildirdiği diğer durumlar da yalnızca bir not ekler.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox ifthenpay Gateway, Modules > Module Manager > VibeFox ifthenpay 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu son 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 ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-payment-ifthenpay satırı ile hesabınızda vibefox.net'i açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri 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 bir tarihle birlikte 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 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 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. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ama ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: daha önce 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. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonrasında 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

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 doldurulduğunu, sepet para biriminin EUR olduğunu ve toplamın 0,01 ile 99.999,99 EUR arasında olduğunu kontrol edin. Payment > Preferences bölümünde modülün EUR, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin.

Müşteri ödedi, ancak sipariş Awaiting ifthenpay payment durumunda kalıyor veya hiç sipariş oluşturulmadı: 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. Mağaza internetten erişilebilir olmalıdır; localhost üzerinde veya bir girişin arkasında olmamalıdır. Modül sayfasındaki Log alanında 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ı. Modül ayarlarını bir kez açın; ifthenpay callback'i yeniden deneyecektir.

Callback 503 Busy yanıtı veriyor: aynı sepet o anda başka bir istek tarafından işleniyordu. ifthenpay callback'i yeniden deneyecektir.

Callback Order not found yanıtı veriyor: referans veya istek bu modülün bir ödemesine ait değil ya da sepet başka bir ödeme yöntemiyle sipariş edildi.

Ödenmiş bir sipariş neden beklemeye alındı? Alınan tutar sipariş toplamından farklıydı veya ödeme, sipariş iptal edildikten sonra geldi. ifthenpay payment bloğundaki notları okuyun, ödemeyi ifthenpay back office'inde 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 sandbox'ı yoktur; ifthenpay'in sağladığı bir test anahtarı kullanın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox ifthenpay 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 modül ayarları, anti-phishing anahtarı ve günlük silinir; yeniden kurulumdan sonra yeni bir anti-phishing anahtarı oluşturulur ve bunun ifthenpay'e yeniden gönderilmesi gerekir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. ifthenpay ödeme kayıtları (referanslar ve istek kimlikleri) ile Awaiting ifthenpay payment ve ifthenpay payment on hold sipariş durumları her zaman saklanır; böylece daha önce verilmiş referanslara ait callback'ler yeniden kurulumdan sonra da siparişlerini bulabilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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