VibeFox Mollie for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

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

Mağaza para birimi: sepetin para birimi, Mollie'nin desteklediği para birimlerinden biri olmalıdır: AED, AUD, BGN, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, ILS, ISK, JPY, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TWD, USD, ZAR. Diğer para birimleri için ödeme seçeneği ödeme sayfasında gizlenir. Mollie'nin sunduğu ödeme yöntemleri para birimine ve hesabınıza bağlıdır.

Mağazanıza internet erişimi: Mollie, webhook'ları mağazanıza gönderir; bu nedenle sitenin internetten erişilebilir olması gerekir. Webhook'lar olmadan bile müşteri Mollie'den döndüğünde siparişler oluşturulur.

Mollie hesabı: Mollie Dashboard > Developers > API keys bölümündeki API anahtarlarına ihtiyacınız vardır. Test anahtarları test_, canlı anahtarlar live_ ile başlar. Başka anahtar veya gizli bilgi gerekmez. Ödeme yöntemleri Mollie hesabınızda etkinleştirilir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. Yönetim panelinde 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 bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Mollie Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Test ve canlı API anahtarlarınızı girin (bkz. Yapılandırma). Mollie'de bir webhook ayarlamanız gerekmez.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bir test ödemesi yapana kadar Test Mode seçeneğini açık bırakın, ardından kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Mollie payment ve Mollie payment on hold. 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 Mollie Gateway > 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; Mollie etkin olduğu halde geçerli modun API anahtarı boşsa ve Mollie mağazanın varsayılan para birimini desteklemiyorsa sizi uyarır. Her iki durumda da ödeme seçeneği ödeme sayfasında gizlenir.

Kaydederken, test_ veya live_ ile başlamayan ve ardından en az 30 harf ve rakam gelmeyen bir API anahtarı kaydedilmez: bir hata gösterilir ve daha önce kaydedilmiş anahtar korunur.

Ödeme sayfası

Enable/Disable: Enable Mollie Gateway ödeme seçeneğini açar veya kapatır. Varsayılan: off.

Title: ödeme sayfasında müşteriye gösterilen ödeme yönteminin başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Mollie. Zorunlu.

Description: ödeme sayfasında müşteriye gösterilen ödeme yönteminin açıklaması. Varsayılan: Pay securely via Mollie.

API anahtarları

API anahtarlarınızı Mollie Dashboard içinde Developers > API keys altında bulabilirsiniz; bu bölüm o sayfaya bağlantı verir. Test ve canlı anahtarlar ayrıdır.

Test Mode: yeni ödemeler için test API anahtarını kullanır. Gerçek ödeme işlenmez. Mollie'nin test ödeme sayfasında ödemenin sonucunu seçebilirsiniz. Müşteriler ödeme seçeneğinin altında Test mode: no real payment will be made. ifadesini görür. Diğer modda yapılan ödemeler, durum kontrolleri ve iadeler için kendi modlarının anahtarını kullanmaya devam eder. Varsayılan: on.

Test API Key: Mollie test API anahtarınız (test_ ile başlar).

Live API Key: Mollie canlı API anahtarınız (live_ ile başlar).

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şaretleyip Save düğmesine tıklayarak kaldırın. Boş bir alan, kaydedilmiş değeri korur.

Webhook: webhook URL'sini gösterir. Herhangi bir kurulum gerekmez: modül bu URL'yi her ödemeyle birlikte Mollie'ye gönderir. Dostça URL'lerle şöyle görünür: https://your-shop/module/wcp_mollie_gateway/webhook, başında bir dil kodu olabilir. Internetten erişilebilir olmalıdır; aksi hâlde siparişler yalnızca müşteri Mollie'den döndüğünde oluşturulur.

Siparişler

Order Status After Payment: başarılı bir ödemeden sonra ayarlanan sipariş durumu. Durum tek adımda ayarlanır.

Processing: sipariş Payment accepted durumuna geçer (varsayılan).

Completed: sipariş Delivered durumuna geçer.

Banka havaleleri Awaiting Mollie payment durumunda bekler. Yetkilendirilmiş ödemeler ile tutar veya para birimi uyuşmazlıkları Mollie payment on hold durumuna gider.

Gelişmiş

Logging: API çağrılarını ve webhook'ları modül klasöründeki logs/molg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve uyarılar, bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarları ve müşteri verileri 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ı ve günlüğü silinir. Siparişlerde saklanan Mollie ödeme kimlikleri, iade kayıtları ve modülün sipariş durumları her zaman korunur. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme seçeneğini (varsayılan olarak Mollie) seçer ve onaylar. Modül, sepet tutarı için sepetin para biriminde (JPY ve ISK ondalıksız) Order # açıklaması ve sepet numarasıyla bir Mollie ödemesi oluşturur ve müşteriyi Mollie'nin barındırdığı ödeme sayfasına gönderir. Orada müşteri, Mollie hesabınızda etkinleştirilmiş yöntemlerden birini seçer ve öder. Bu noktada henüz bir sipariş yoktur.

Mollie webhook'ları imzasız gelir ve yalnızca ödeme kimliğini içerir. Bu nedenle modül bir webhook'a kendi başına hiçbir zaman güvenmez: yalnızca kendisinin oluşturduğu ödeme kimliklerini kabul eder, ödemeyi ödemenin yapıldığı modun anahtarıyla Mollie API'sinden okur, ödemenin sepete ait olduğunu kontrol eder ve ödenen tutarı ve para birimini sepet toplamıyla karşılaştırır. Sipariş yalnızca Mollie bu şekilde onayladıktan sonra ödenmiş olarak işaretlenir. Modül şu Mollie ödeme durumlarını işler:

paid: ödeme yapıldı. Tutar ve para birimi eşleştiğinde sipariş Order Status After Payment durumunda oluşturulur.

authorized: ödeme yetkilendirildi ama tahsil edilmedi. Sipariş bir notla Mollie payment on hold durumunda oluşturulur; ödemeyi Mollie Dashboard içinde tahsil edin, sipariş otomatik olarak ödenmiş olarak işaretlenir.

open (bank transfer): Mollie parayı bekliyor. Sipariş Awaiting Mollie payment durumunda oluşturulur ve Mollie parayı aldığında ödenmiş olarak işaretlenir.

open, pending: ödeme henüz tamamlanmadı. Hiçbir şey değişmez.

failed, expired, canceled: son ödeme denemesi başarılı olmadı. Sipariş yoksa müşteri yeniden ödeme yapabilir; bu ödemeyi bekleyen bir sipariş Payment error durumuna geçer.

chargeback: Mollie geri alınan bir tutarı bildirir. Bir not eklenir ve ödenmiş bir sipariş beklemeye alınır.

Müşteri döndüğünde modül, sepetin son ödemesini aynı şekilde Mollie API'si üzerinden kontrol eder. Ödenmiş bir ödeme, Your payment with Mollie has been received. ifadesiyle standart sipariş onay sayfasına götürür. Banka havalesinde sayfa Your order will be processed as soon as Mollie receives your bank transfer. ifadesini gösterir. Sipariş beklemedeyse sayfa We are confirming your payment with Mollie. The order will be updated automatically — please do not pay again. ifadesini gösterir. Mevcut bir siparişin ödemesi başarısız olduysa veya sipariş iptal edildiyse sayfa Your Mollie payment was not completed. Please contact us about this order. ifadesini gösterir.

Ödeme iptal edilmişse, başarısız olmuşsa, süresi dolmuşsa veya tamamlanmamışsa, müşteri ödeme sayfasına şu gibi bir mesajla döner: You cancelled the Mollie payment. You can try again or choose another payment method. veya The Mollie payment has expired. Please try again or choose another payment method. Sepet korunur. Mollie'ye ulaşılamıyorsa veya henüz karar vermediyse, müşteriden yeniden ödeme yapmamasını isteyen ve bir Check again düğmesi sunan bir Payment confirmation sayfası görünür; webhook geldiği anda siparişi oluşturur.

Müşteri yeniden ödeme yaptığında, ikinci bir ödenebilir ödeme oluşturmak yerine aynı tutarda hâlâ açık olan Mollie ödemesi yeniden kullanılır. Sepet toplamı değiştiyse, Mollie izin verdiğinde eski açık ödeme Mollie'de iptal edilir. Eski ödeme bu arada ödendiyse, sipariş yeni bir ödeme olmadan oluşturulur.

Mollie ödemeyi başlatamazsa, müşteri ödeme sayfasında kısa bir mesajla kalır, örneğin The payment provider could not be reached. Please try again in a moment., This payment method is temporarily unavailable. Please choose another payment method. (hatalı API anahtarı) veya Mollie cannot accept a payment of this amount or currency. Please choose another payment method. Teknik neden günlüğe yazılır.

Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Müşteri Mollie yöntemini ödeme sayfanızda değil Mollie sayfasında seçer. Modülde abonelik veya tekrarlayan ödemeler, kayıtlı kartlar veya mandalar, sitenizde kart alanları, Apple Pay veya PayPal ekspres düğmeleri yoktur ve Orders API kullanılmaz; bu nedenle Mollie, bu ödemeler için sipariş satırları gerektiren yöntemleri sunmaz (örneğin bazı Klarna, Billie veya in3 varyantları). Yetkilendirilmiş ödemeler PrestaShop'tan değil, Mollie Dashboard içinden tahsil edilir veya iptal edilir.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri Mollie'ye yönlendirildi ve ödeme yapmadı ya da Mollie ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Payment accepted veya Delivered: ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Ödeme, işlem kimliği olarak Mollie ödeme kimliğiyle (tr_...) kaydedilir ve bir not Mollie ödemesini, yöntemi ve modu gösterir.

Awaiting Mollie payment: müşteri Mollie sayfasında banka havalesini seçti. Mollie parayı aldığında sipariş ödenmiş duruma geçer.

Mollie payment on hold: yetkilendirilmiş bir ödeme tahsilat beklerken, Mollie bir chargeback bildirdiğinde, ödenen tutar veya para birimi sepetten farklı olduğunda (örneğin ödeme başladıktan sonra sepet değiştirildiğinde), mağaza canlı modda iken bir test ödemesi yapıldığında (para alınmadı) veya ödeme sipariş iptal edildikten sonra geldiğinde. Not nedenini açıklar. Ödemeyi Mollie Dashboard içinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Payment error: mevcut bir siparişin banka havalesi veya yetkilendirmesi başarısız oldu, süresi doldu ya da iptal edildi. Ödenmiş bir sipariş asla değiştirilmez.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Aynı sepetin ikinci bir ödemesi yapılırsa sipariş değişmez. Bir not, çift ödemeyi Mollie Dashboard içinde iade etmenizi ister.

Mollie payment bloğu

Sipariş sayfasında Mollie ödeme kimliği, yöntem, ödeme durumu, ödenen ve iade edilen tutar, test ödemeleri için bir Test mode rozeti, iade geçmişi ve siparişin Mollie notes notlarını içeren bir Mollie payment bloğu görünür. Notlar yalnızca yönetim panelinde görünür.

İadeler

Mollie payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden yazın ve Refund via Mollie düğmesine tıklayın. Refund this amount through Mollie? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir; modül sayfalarına erişim gerekmez. İadeler, Mollie'nin tahsil ettiği tutar ve para biriminde yapılır; bu yüzden tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, siparişi gerçekten ödeyen ödeme için, o ödemenin yapıldığı modun API anahtarıyla gönderilir; bu nedenle o modun anahtarı ayarlanmış olmalıdır. Mollie iadeyi reddederse blok Mollie'nin hata mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara Mollie iade kimliğiyle birlikte eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, Mollie ödemeyi ödendi olarak bildirdikten sonra kullanılabilir.

Modül kredi notları (credit slips) oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Mollie üzerinden para geri göndermez. Mollie Dashboard içinde oluşturulan iadeler siparişte görünmez; bir chargeback ise bir not ekler.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Mollie Gateway lisans bloğu, Modules > Module Manager > VibeFox Mollie 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 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, anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-payment-mollie 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. Bloktaki metinler 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 tarihli License expired on. 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 tek bir alan adında çalışır: çok mağazalı kurulumda ana mağazanın alan adında. 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 Mollie, ö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, yönetim paneline giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder 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, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Mollie ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun bir API anahtarının bulunduğunu kontrol edin: test modunda Test API Key, canlı modda Live API Key. Sepetin para biriminin Mollie tarafından desteklendiğini kontrol edin. Ayarlar sayfası, eksik bir anahtar ve desteklenmeyen bir mağaza para birimi için 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ı: webhook mağazanıza ulaşamıyor. Webhook altında gösterilen URL internetten erişilebilir olmalıdır (temel kimlik doğrulama veya onu engelleyen bir güvenlik duvarı olmamalıdır). Sipariş, müşteri ödemeden sonra mağazaya döndüğünde veya Check again düğmesine tıkladığında da oluşturulur.

Webhook Unknown payment. yanıtı veriyor: ödeme bu mağaza tarafından oluşturulmadı veya Mollie, modunun API anahtarıyla bu ödemeyi tanımıyor; örneğin başka bir Mollie hesabının ödemesi.

Webhook Payment ID mismatch. yanıtı veriyor: ödeme, oluşturulduğu sepete ait değil. Hiçbir şey değiştirilmez.

Webhook Failed to fetch payment. yanıtı veriyor: Mollie API'sine ulaşılamadı veya ödemenin modunun API anahtarı ayarlanmamış. Mollie webhook'u daha sonra yeniden dener.

Webhook Temporarily unavailable. yanıtı veriyor: sepet tam o anda başka bir istek tarafından işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). Mollie webhook'u yeniden dener. Nedeni görmek için Logging seçeneğini açın.

Webhook URL'si tarayıcıda Method not allowed. gösteriyor: bu normaldir. URL yalnızca Mollie'den gelen istekleri kabul eder.

Bir API anahtarı kaydedilmiyor: anahtar test_ veya live_ ile başlamalı ve ardından en az 30 harf ve rakam gelmelidir. Mollie Dashboard'dan yeniden kopyalayın.

Müşteri Mollie'yi seçerken bir hata görüyor: modül sayfasındaki Log alanına bakın. HTTP kodunu ve Mollie mesajını gösterir. 401 hatalı bir API anahtarı anlamına gelir; 422 ise isteğin bir alanını gösterir, örneğin Mollie'nin kabul etmediği bir tutar veya para birimi.

Sipariş Mollie payment on hold durumunda: siparişin notlarını okuyun (bkz. Sipariş durumları), ardından siparişi işleyin veya ödemeyi iade edin.

İade, mod hakkında bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o modun API anahtarı ayarlanmamış. Anahtarı girin ve yeniden deneyin.

Diğer para birimleri veya ödeme verileri: geliştiriciler para birimi listesini actionWcpMollieSupportedCurrencies kancasıyla, ödeme isteğini ise actionWcpMolliePaymentData kancasıyla değiştirebilir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Mollie 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ı ve günlük silinir. Kapalıysa, ileride yeniden kurulum için tüm ayarlar saklanır. Mollie ödeme kimlikleri ve iade kayıtları ile Awaiting Mollie payment ve Mollie payment on hold sipariş durumları her zaman saklanır; böylece daha önce ödenen siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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