VibeFox Montonio for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Para birimi: sepet para biriminin EUR veya PLN olması gerekir. Başka bir para biriminde ödeme yöntemi ödeme adımında gizlenir.

Montonio hesabı: Montonio Partner System'den mağazanızın erişim anahtarına ve gizli anahtarına ihtiyacınız var. Sandbox ve canlı anahtarlar farklıdır, bu yüzden kullandığınız her ortam için bir çift gerekir. Montonio'da başka bir ayar yapmanız gerekmez: bildirim adresi her ödemeyle birlikte gönderilir.

Genel erişime açık site: Montonio bildirimlerini alabilmek için mağazanızın internetten erişilebilir olması gerekir. Aksi halde müşteri mağazaya döndüğünde siparişler yine de oluşturulur.

VibeFox lisans anahtarı: vibefox.net'ten satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Yönetim panelinde Modules > Module Manager sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Montonio Payment modülünü bulup Configure düğmesine tıklayın.

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

4. Montonio Partner System'de Stores > your store > API keys bölümünü açın ve sandbox erişim anahtarını ile gizli anahtarı kopyalayın. Bunları ayarlara yapıştırın ve Sandbox mode seçeneğini açık bırakın.

5. Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve sandbox'ta bir ödeme deneyin. Ardından canlı anahtarları girin ve Sandbox mode seçeneğini kapatın.

Kurulum sırasında modül Montonio payment on hold sipariş durumunu oluşturur. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Montonio Payment > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa; geçerli ortamın anahtarları eksikse (bu durumda ödeme yöntemi ödeme adımında gizlenir), mağaza para birimi EUR veya PLN değilse uyarır ve sandbox açıkken Sandbox mode is on: payments are simulated and no real money is charged. mesajını gösterir. Title alanı boş bırakılamaz.

Montonio

Enable/Disable: Enable Montonio bank payments ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterilerin ödeme adımında gördüğü ödeme yönteminin adı. Siparişte de bu ad kaydedilir. Varsayılan: Bank payment (Montonio). Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

API anahtarları

Anahtarları Montonio Partner System'de Stores > your store > API keys altında alın. Sandbox ve canlı anahtarlar farklıdır. Sandbox yalnızca sandbox anahtarlarını, canlı mod yalnızca canlı anahtarları kullanır.

Sandbox mode: Montonio sandbox'ını kullanır (test ödemeleri, gerçek para yok). Hem Montonio API adresini hem anahtar çiftini değiştirir. Varsayılan: açık. Yalnızca canlı anahtarları girdikten sonra kapatın. Diğer ortamda yapılan ödemeler, onaylar ve iadeler için kendi ortamlarının anahtarlarını kullanmaya devam eder.

Sandbox access key: mağazanızın Montonio sandbox'ındaki erişim anahtarı (UUID).

Sandbox secret key: mağazanızın Montonio sandbox'ındaki gizli anahtarı.

Live access key: mağazanızın Montonio canlı ortamındaki erişim anahtarı (UUID).

Live secret key: mağazanızın Montonio canlı ortamındaki gizli anahtarı.

Kaydedilmiş gizli 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 secret keys: bir anahtarı işaretleyip Save düğmesine tıklayarak kaldırın. Boş alan kayıtlı değeri korur.

Notification URL: Montonio'nun ödeme bildirimlerini gönderdiği adres. Dostane URL'lerle şöyle görünür: https://your-shop/module/wcp_montonio_payment/webhook. Bu adresi hiçbir yere girmeniz gerekmez: modül onu her ödemeyle birlikte Montonio'ya gönderir.

Gelişmiş

Debug log: ödeme olaylarını modül klasöründeki logs/wc_mnt_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve uyarılar bu seçenek kapalı olsa bile her zaman kaydedilir. Anahtarlar, token'lar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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: açıkken modül kaldırıldığında modül ayarları ve günlük silinir. Modülü devre dışı bırakmak hiçbir şeyi silmez. Sipariş verileri (Montonio UUID'leri, notlar) her zaman saklanır. Varsayılan: kapalı.

Ödeme bildirimleri

Montonio, her ödeme hakkında mağazanıza imzalı bir token ile bilgi verir. Token iki yoldan gelir: bildirim adresine sunucudan sunucuya bir bildirim ile ve müşteri mağazaya geri döndüğünde. İkisi de kontrol edilir: ödemenin oluşturulduğu ortamın gizli anahtarıyla imza, son kullanma süresi, erişim anahtarınız ve ödemenin mağazanız tarafından o sepet için oluşturulup oluşturulmadığı. Diğer ortamın anahtarıyla imzalanmış bir token reddedilir. Her durum yalnızca bir kez uygulanır; bu nedenle tekrarlanan bildirimler not, e-posta veya stok değişikliği eklemez. Bildirim adresi mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Ödeme

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak Bank payment (Montonio)) seçer ve onaylar. Modül, sepet toplamı için sepet para biriminde bir Montonio ödemesi oluşturur ve müşteriyi Montonio ödeme sayfasına gönderir. Orada müşteri bir banka seçer ve öder. Müşterinin fatura ülkesindeki bankalar önce gösterilir (PLN sepetleri için Polonya). Ödeme Order ve sepet numarası olarak görünür. Montonio sayfası; mağaza dili Almanca, İngilizce, Estonca, Fince, Litvanca, Letonca, Lehçe veya Rusça ise o dilde açılır, aksi halde İngilizce açılır. Sandbox modunda ödeme sayfası açıklamanın altında SANDBOX MODE — test payment, no real money is charged. ifadesini gösterir. Bu aşamada henüz sipariş yoktur.

Sipariş, ancak Montonio ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: bildirimle ya da müşterinin geri dönmesiyle. Sipariş bu noktada oluşturulur ve müşteri standart sipariş onay sayfasını Your Montonio bank payment has been received. ifadesiyle görür. Banka ödemeyi henüz onaylamadıysa veya sipariş beklemedeyse sayfa We are confirming your payment with Montonio. The order will be updated automatically — please do not pay again. ifadesini gösterir. Banka daha sonra yetkilendirilmiş bir ödemeyi reddederse sayfa Your Montonio payment was not completed. Please contact us about this order. ifadesini gösterir.

Müşteri geri döndüğünde Montonio ödemenin hâlâ beklemede olduğunu bildirirse, Payment confirmation sayfası aynı metni ve bir Check again düğmesini gösterir. Düğme, Montonio'dan ödemenin güncel durumunu ister. Bildirim geldiği anda siparişi oluşturur.

Ödeme iptal edilir veya reddedilirse müşteri şu mesajlardan biriyle ödeme adımına döner: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. veya Montonio could not complete the payment. Please try again or choose another payment method. Sepet korunur. Yeni bir ödeme oluşturulmadan önce modül, öncekiyle ilgili durumu Montonio'ya sorar. Ödeme zaten yapılmışsa sipariş oluşturulur ve ikinci bir ödeme yapılmaz.

Montonio ödemeyi başlatamazsa müşteri ödeme adımında kalır ve kısa bir mesaj görür, örneğin Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method. Teknik neden günlüğe yazılır.

Modül yalnızca banka ödemelerini (ödeme başlatma) kabul eder. Kart ödemesi, BLIK, Apple Pay veya Google Pay, Pay Later veya finansman, Montonio kargo, abonelikler, kayıtlı ödeme yöntemleri ve kendi sitenizde banka seçimi desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: Müşteri Montonio'ya yönlendirildi ve ödeme yapmadı ya da Montonio ödemeyi beklemede olarak bildiriyor. Yalnızca sepet mevcut.

Payment accepted: Montonio ödemeyi (PAID) sepetin tam tutarı ve para birimiyle onayladı. Ödeme, işlem kimliği olarak Montonio sipariş UUID'si ile kaydedilir ve bir not bankayı, UUID'yi, tutarı ve ortamı gösterir.

Montonio payment on hold: Banka ödemeyi henüz onaylamadı (AUTHORIZED); Montonio PAID bildirdiğinde sipariş Payment accepted olur. Sipariş ayrıca şu durumlarda beklemeye alınır: Montonio sepet toplamından farklı bir tutar veya para birimi bildirdiğinde, mağaza canlı moddayken bir sandbox ödemesi geldiğinde (para alınmadığı için ödeme kaydedilmez) veya ödeme, sipariş iptal edildikten sonra geldiğinde. Not bunu açıklar. Ödemeyi Montonio Partner System'de kontrol edin ve siparişi tamamlayın ya da ödemeyi iade edin.

Payment error: Banka yetkilendirilmiş bir ödemeyi reddetti ya da müşteri ödemeyi tamamlamadı. Siparişi yalnızca sepetin en son ödemesi değiştirebilir.

Refunded: Ödeme modül aracılığıyla tamamen iade edildi.

Ödenmiş, iptal edilmiş veya iade edilmiş siparişler sonraki bildirimlerle yeniden açılmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez. Bir not, ikinci ödemeyi Montonio Partner System'de iade etmenizi ister.

Montonio payment bloğu

Sipariş sayfasında, Montonio sipariş UUID'si, ortam (test ödemeleri için Sandbox rozetiyle), banka, ödeme durumu, ödenen ve iade edilen tutar, iade geçmişi ve siparişin Montonio notes bölümünü içeren bir Montonio payment bloğu gösterilir.

İadeler

Montonio payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden girin (yalnızca sipariş notunda saklanır) ve Refund via Montonio düğmesine tıklayın. Refund this amount through Montonio? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir; Modüller sayfalarına erişim gerekmez. İadeler, Montonio'nun tahsil ettiği tutarla sınırlıdır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortama (sandbox veya canlı) gönderilir, bu yüzden o ortamın anahtarları ayarlanmış olmalıdır. Montonio iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Gönderilen iade, durumu ve Montonio iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, Montonio ödemeyi ödenmiş olarak bildirdikten sonra kullanılabilir.

Montonio her iadeyi daha sonra bir bildirimle onaylar veya reddeder. Onay notlara eklenir. Montonio iadeyi reddederse not, paranın müşteriye iade edilmediğini belirtir; bunu Montonio Partner System'de kontrol edin ve PrestaShop'taki iadeyi düzeltin.

Modül kredi notları oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Montonio üzerinden para göndermez. Montonio Partner System'de yapılan iadeler, Montonio bunları bildirdiğinde notlara eklenir. Sipariş durumu ve kredi notları otomatik olarak değişmez. Gerekirse bunları elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Montonio Payment lisans bloğu, Modules > Module Manager > VibeFox Montonio Payment > Configure sayfasında, ayarların üstünde 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 tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-montonio satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 ya da 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 bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da aynı şekilde. 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 olmadan Montonio, ödeme adımı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, yönetim paneline giriş yaptığınızı bilmez; bu yüzden ödeme yöntemi sizin için de gizlenir: modülü lisans satın almadan önce yapılandırabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma çıkar. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Lisans süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Montonio ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli ortamın iki anahtarının da ayarlandığını (sandbox modunda Sandbox access key ve Sandbox secret key, canlı modda Live access key ve Live secret key) ve sepet para biriminin EUR veya PLN olduğunu kontrol edin. Anahtarlar eksikse veya mağaza para birimi desteklenmiyorsa ayarlar sayfası bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme yapıldı, ancak sipariş oluşturulmadı: bildirim mağazanıza ulaşmadı. Mağazanın internetten erişilebilir olduğunu ve ayarlardaki anahtarların ödemenin ortamına ait olduğunu kontrol edin. Sipariş ayrıca müşteri ödemeden sonra mağazaya döndüğünde, müşteri Check again düğmesine tıkladığında ve müşteri aynı sepeti tekrar ödemeyi denediğinde de oluşturulur.

Bildirim Invalid token yanıtı veriyor: token imzası, son kullanma süresi veya erişim anahtarı eşleşmedi. Erişim anahtarının ve gizli anahtarın doğru kopyalandığını ve doğru ortama ait olduğunu, sunucu saatinin de doğru olduğunu kontrol edin. Diğer ortamın anahtarıyla imzalanmış bir token da reddedilir.

Bildirim Payment does not belong to this order yanıtı veriyor: ödeme, bu mağaza tarafından bu sepet için oluşturulmadı. Bu, iki mağaza aynı Montonio hesabını ve aynı sepet numaralarını kullandığında olur.

Bildirim Gateway not configured yanıtı veriyor: hiçbir Montonio anahtarı ayarlanmamış veya ödemenin ortamının anahtarları eksik. Anahtarları girin; Montonio bildirimi yeniden dener.

Bildirim Temporarily unavailable yanıtı veriyor: sepet aynı anda başka bir istek tarafından onaylanıyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). Montonio bildirimi yeniden dener. Nedeni görmek için Log alanına bakın.

Müşteri Montonio'yu seçerken hata görüyor: modül sayfasındaki Log alanına bakın. This payment method is temporarily unavailable. Please choose another payment method. genellikle yanlış veya eksik anahtarlar anlamına gelir. Montonio could not start the payment. Please check your order details or choose another payment method. ise Montonio'nun ödeme verilerini reddettiği anlamına gelir; nedeni günlükte yazar.

Ödemeden sonra sipariş Montonio payment on hold durumunda: Montonio payment bloğundaki notları okuyun (Sipariş durumlarına bakın), ardından siparişi tamamlayın ya da ödemeyi iade edin.

Sandbox ödemeleri canlı bir siparişi onaylamıyor: Mağaza canlı moddayken bir sandbox ödemesi hiçbir zaman siparişi tamamlamaz; bunun yerine sipariş beklemeye alınır. Sandbox mode seçeneğini istediğiniz ortama çevirin ve o ortamın anahtarlarını kullanın.

İade, ortamla ilgili bir mesajla başarısız oluyor: ödeme sandbox veya canlı ortamda yapıldı ve o ortamın anahtarları ayarlı değil. Anahtarları girin ve yeniden deneyin.

Geliştiriciler için modül; desteklenen para birimlerini, ödeme verilerini ve Montonio sayfasının dilini değiştirmek üzere actionWcpMontonioSupportedCurrencies, actionWcpMontonioOrderData ve actionWcpMontonioLocale hook'larını sunar.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Montonio Payment 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 açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Montonio ödeme ve iade kayıtları ile Montonio payment on hold sipariş durumu her zaman saklanır; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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