Geri

VibeFox Mollie for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: ödeme sayfasındaki para birimi, Mollie tarafından desteklenen 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 yöntemi ö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 siparişler, müşteri Mollie'den döndüğünde durumlarını alır.

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

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_mollie_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_mollie_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_mollie_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine, bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin, Payments türünü seçin. VibeFox Mollie Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. License key).

4. Test ve canlı API anahtarlarınızı girin (bkz. Configuration). 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.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_mollie_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından aldığı için adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve Payments türünü seçin. VibeFox Mollie Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve API anahtarlarını OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca Webhook URL'si farklıdır (bkz. Webhook URL).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Mollie Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarları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 yöntemi ödeme sayfasında gizlenir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title alanı 1 ila 128 karakter olmalı, Sort Order tam sayı olmalı ve Total 0 veya daha büyük bir sayı olmalıdır; aksi halde hiçbir şey kaydedilmez. test_ veya live_ ile başlamayan ve ardından en az 30 harf ve rakam gelmeyen bir API anahtarı kaydedilmez: sayfa Settings saved, except the API key shown in red. mesajını gösterir, hata anahtarı belirtir ve daha önce kaydedilmiş anahtar korunur.

Checkout

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

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

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: Pay securely via Mollie.

Sort Order: ödeme sayfasında Mollie'nin ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Mollie'yi yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Mollie'nin sunulması için siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme tutarı. Mollie'yi her tutar için sunmak üzere boş bırakın.

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 test ödeme sayfasında ödemenin sonucunu seçebilirsiniz. Müşteriler Confirm Order adımında Test mode: no real payment will be made. ifadesini görür. Diğer modda yapılan ödemeler, durum sorgulama ve iadeler için kendi modlarının anahtarını kullanmaya devam eder. Varsayılan: açık.

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. Kaydedilmiş bir anahtarı silmek için alanın altındaki Clear the saved key on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook

Webhook URL: yalnızca bilgi amaçlı gösterilir. Webhook kurulumu gerekmez: eklenti her ödemede bu adresi Mollie'ye gönderir. OpenCart 3'te adres https://your-store/index.php?route=extension/payment/wcp_mollie_gateway/webhook biçimindedir, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_mollie_gateway/payment/wcp_mollie_gateway.webhook biçimindedir. Adres OpenCart kurulumunuzun vitrin adresinden oluşturulur. İnternetten erişilebilir olması gerekir; aksi halde siparişler, müşteri Mollie'den döndüğünde durumlarını alır.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, yalnızca Mollie ödemeyi bildirdikten sonra bir durum alır. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: başarılı ödemeden sonra ayarlanan durum. Varsayılan: İşleniyor. Ödenmiş siparişleri tamamlandı olarak işaretlemek için Complete seçin.

Awaiting Mollie Payment Status: müşteri Mollie sayfasında banka havalesini seçti; Mollie parayı aldığında sipariş otomatik olarak ödenmiş işaretlenir. Varsayılan: Beklemede.

Mollie Payment On Hold Status: ödemenin sizin incelemenize ihtiyacı var (bkz. Order statuses). Varsayılan: Beklemede, çünkü OpenCart'ta Beklemeye alındı durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Payment Error Status: beklenen banka havalesi veya yetkilendirilen ödeme başarısız oldu, süresi doldu ya da iptal edildi. Varsayılan: Başarısız.

Refunded Status: ödeme sipariş sayfasından tamamen iade edildi. Varsayılan: İade edildi.

Gelişmiş

Logging: API çağrılarını ve webhook'ları OpenCart günlükleri klasöründeki (storage/logs) molg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. API anahtarları 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 on Uninstall: açık olduğunda eklenti kaldırıldığında ağ geçidi ayarları ve günlüğü silinir. Siparişlerle birlikte kaydedilen Mollie ödeme kimlikleri (ödemeler, iadeler) her zaman korunur. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. API anahtarları dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kaydedilmiş API anahtarları korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Mollie). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to Mollie to choose a payment method and pay. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı için sipariş para biriminde (JPY ve ISK ondalıksız) bir Mollie ödemesi oluşturur; açıklaması Order # ve sipariş numarasıdır ve müşteriyi Mollie'nin barındırdığı ödeme sayfasına yönlendirir. Orada müşteri, Mollie hesabınızda etkin olan ödeme yöntemlerinden birini seçer ve öder. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar.

Mollie webhook'ları imza içermez, yalnızca ödeme kimliğini taşır. Bu nedenle eklenti bir webhook'a kendi başına hiçbir zaman güvenmez: yalnızca kendi oluşturduğu ödeme kimliklerini kabul eder, ödemeyi ödemenin yapıldığı modun anahtarını kullanarak Mollie API'sinden okur, ödemenin siparişe ait olduğunu doğrular ve ödenen tutarı ile para birimini sipariş toplamıyla karşılaştırır. Sipariş, Mollie bunu bu yolla onaylamadan ödenmiş olarak işaretlenmez. Eklenti şu Mollie ödeme durumlarını işler:

paid: ödeme yapıldı. Tutar ve para birimi eşleştiğinde sipariş Order Status After Payment durumunu alır.
authorized: ödeme yetkilendirildi ama tahsil edilmedi. Sipariş bir notla birlikte beklemeye alınmış durumunu alır; ödemeyi Mollie Dashboard içinde tahsil edin, sipariş otomatik olarak ödenmiş işaretlenir.
open (bank transfer): Mollie parayı bekliyor. Sipariş beklemede durumunu alır ve Mollie parayı aldığında ödenmiş işaretlenir.
open, pending: ödeme henüz tamamlanmadı. Hiçbir şey değişmez.
failed, expired, canceled: son ödeme denemesi başarılı olmadı. Durumsuz bir sipariş durumsuz kalır ve müşteri yeniden ödeme yapabilir; bu ödemeyi bekleyen bir sipariş ödeme hatası durumunu alır. Ödenmiş bir sipariş asla değiştirilmez.
chargeback: Mollie geri ödenen (chargeback) bir tutar bildirir. Bir not eklenir ve ödenmiş bir sipariş beklemeye alınır.

Müşteri döndüğünde eklenti ödemeyi aynı şekilde Mollie API ile kontrol eder. Sipariş, OpenCart'ın olağan yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle durumunu alır; müşteri OpenCart sipariş başarı sayfasını Your payment with Mollie has been received. ifadesiyle görür. Banka havalesi için sayfa Your order will be processed as soon as Mollie receives your bank transfer. gösterir. Sipariş beklemedeyse sayfa We are confirming your payment with Mollie. The order will be updated automatically — please do not pay again. gösterir. Beklenen bir ödeme başarısız olduysa sayfa Your Mollie payment was not completed. Please contact us about this order. gösterir.

Ödeme iptal edildiyse, başarısız olduysa, süresi dolduysa veya tamamlanmadıysa müşteri bir mesajla ödeme sayfasına döner, örneğin 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. OpenCart 4'te bu mesajlar ödeme sayfasının üst kısmında gösterilir. Sepet korunur. Mollie'ye ulaşılamıyorsa veya henüz karar vermediyse, müşteriye tekrar ödeme yapmamasını söyleyen ve bir Check again düğmesi sunan Payment confirmation sayfası açılır; webhook geldiği anda sipariş durumunu ayarlar.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme için tek bir sipariş tutar ve aynı siparişi yeni bir Mollie ödemesiyle yeniden öder. Her iki durumda da eklenti, bir sepetin tüm siparişlerini tek bir ödeme olarak ele alır. Müşteri yeniden ödeme yaptığında, aynı tutar için hâlâ açık olan Mollie ödemesi, ikinci bir ödenebilir ödeme oluşturmak yerine yeniden kullanılır. Toplam değiştiyse, Mollie izin verdiğinde eski açık ödeme Mollie'de iptal edilir. Bu arada eski bir ödeme yapıldıysa, o ödeme onaylanır ve müşteri yeni bir ödeme yapmadan başarı sayfasına gider.

OpenCart 4, ödeme başarı sayfası gösterilene kadar siparişi ödeme akışında tutar. Bu arada sipariş ödeme yapılmadan kapatılmışsa (örneğin banka havalesinin süresi dolmuşsa ya da siz siparişi iptal etmiş veya iade etmişseniz), müşteri Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir sipariş için ödeme yapar. Ödenmiş ve sonra iptal edilmiş ya da iade edilmiş bir sipariş artık sepeti kilitlemez.

Mollie ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde kısa bir mesaj görü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. (yanlış 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; çünkü OpenCart 3 ödeme eklentisi isteklerine izin verir ve OpenCart 4'te eklenti bunun için bir başlatma eylemi ekler; bu eylem müşterinin Mollie'den dönüşüne de izin verir.

Müşteri, Mollie yöntemini ödeme sayfanızda değil, Mollie sayfasında seçer. Eklentide abonelik veya yinelenen ödemeler, kayıtlı kartlar veya mandatlar, sitenizde kart alanları, Apple Pay veya PayPal ekspres düğmeleri ve Orders API yoktur; bu nedenle sipariş satırları gerektiren yöntemler (örneğin bazı Klarna, Billie veya in3 varyantları) bu ödemeler için Mollie tarafından sunulmaz. Yetkilendirilmiş ödemeler OpenCart'tan değil, Mollie Dashboard içinde tahsil edilir veya iptal edilir.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Mollie'ye gönderildi ve ödeme yapmadı ya da Mollie ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan İşleniyor): ödeme onaylandı. Bir not Mollie ödemesini (tr_...), yöntemi ve modu gösterir.

Awaiting Mollie Payment Status (varsayılan Beklemede): müşteri Mollie sayfasında banka havalesini seçti. Mollie parayı aldığında sipariş ödenmiş durumuna geçer.

Mollie Payment On Hold Status (varsayılan Beklemede): yetkilendirilmiş bir ödeme tahsilat bekliyor, Mollie bir chargeback bildirdi, ödenen tutar veya para birimi siparişten farklıydı, mağaza canlı moddayken bir test ödemesi yapıldı (hiçbir para alınmadı) ya da ödeme, sipariş başka bir duruma geçtikten sonra geldi (örneğin iptal edilmişti). Not durumu açıklar. Ödemeyi Mollie Dashboard içinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Payment Error Status (varsayılan Başarısız): bir siparişin banka havalesi veya yetkilendirmesi başarısız oldu, süresi doldu ya da iptal edildi.

Refunded Status (varsayılan İade edildi): ödeme eklenti aracılığıyla tamamen iade edildi.

OpenCart, bu durum değişikliklerini müşteriye olağan yöntemle bildirir. Aynı sepetin ikinci bir ödemesi yapılırsa sipariş değiştirilmez. Ödenmiş siparişteki bir not, yinelenen ödemeyi Mollie Dashboard içinde iade etmenizi ister.

Notlar, müşterinin görmediği siparişin History bölümündeki kayıtlardır.

VibeFox Mollie Gateway sekmesi

Sales > Orders bölümünde Mollie ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Mollie Gateway sekmesi test ödemeleri için Test mode etiketiyle birlikte Mollie payment kimliğini, Method bilgisini, ödemenin Status değerini, Paid / refunded tutarlarını, iade formunu, iade geçmişini (tarih, iade kimliği, tutar, mod, Mollie durumu, neden) ve siparişin Mollie notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Mollie Gateway sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir Reason (optional) 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. Eklentiyi değiştirme izniniz olmalıdır (System > Users > User Groups bölümünde ayarlanır). İadeler Mollie'nin tahsil ettiği tutar ve para biriminde yapılır; bu nedenle 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 ödemeye, ödemenin yapıldığı modun API anahtarıyla gönderilir; bu nedenle o modun anahtarının ayarlanmış olması gerekir. Mollie iadeyi reddederse veya başarısız ya da iptal edilmiş olarak bildirirse sekme mesajı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Mollie iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade, müşteriye bildirilmeden ve ürünler stoğa geri alınmadan, elle yapılan bir durum değişikliği gibi siparişi Refunded Status durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, Mollie ödemeyi ödenmiş olarak bildirdikten sonra kullanılabilir.

Sales > Returns bölümündeki ürün iadeleri Mollie üzerinden para geri göndermez. Mollie Dashboard içinde oluşturulan iadeler siparişte gösterilmez; bir chargeback ise bir not ekler.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Mollie Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Mollie Gateway > Edit sayfasında, ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı) ve 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 düğmelerini gösterir. Bunların altında Product: opencart-payment-mollie satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici panelinin diline uyar (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedeni 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 veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. 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 yoksa 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. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, anahtar satın almadan önce eklentiyi kurup test edebilmeniz için mağazada ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar yoksa ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici panelinin Dashboard bölümünde bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici panelinin Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklenti kaldırıldığında lisans anahtarı ve lisans durumu her zaman silinir.

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 modda bir API anahtarı bulunduğunu kontrol edin: test modunda Test API Key, canlı modda Live API Key. Ödeme para biriminin Mollie tarafından desteklendiğini, ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin. Ayarlar sayfası eksik anahtar ve desteklenmeyen mağaza para birimi için uyarı gösterir.

Ödeme geçti ama sipariş durumsuz kaldı: webhook mağazanıza ulaşamıyor. Webhook URL alanında gösterilen adres internetten erişilebilir olmalıdır (temel kimlik doğrulama veya araya giren bir güvenlik duvarı olmamalıdır). Sipariş, müşteri ödemeden sonra mağazaya döndüğünde ya da müşteri Check again düğmesine tıkladığında da durumunu alır.

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

Webhook Payment ID mismatch. yanıtı veriyor: ödeme, oluşturulduğu siparişe 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 aynı anda başka bir istek tarafından işleniyordu veya sipariş durumu ayarlanamadı. 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 Confirm Order sonrasında bir hata görüyor: eklenti sayfasındaki Log alanına bakın. HTTP kodunu ve Mollie mesajını gösterir. 401 yanlış bir API anahtarı anlamına gelir; 422 isteğin bir alanına, örneğin Mollie'nin kabul etmediği bir tutara veya para birimine işaret eder. This payment method is not available. ifadesi, ödeme oturumunun artık siparişle eşleşmediği ya da bu sırada ödeme yönteminin kapatıldığı anlamına gelir: müşterinin ödeme sayfasını yeniden yüklemesi gerekir.

Sipariş beklemede durumunda: VibeFox Mollie Gateway sekmesindeki notları okuyun (bkz. Order statuses), ardından siparişi işleyin veya ödemeyi iade edin.

Sekmede iade formu yok: sekme nedenini belirtir: ödeme henüz ödenmemiş, tamamen iade edilmiş, kullanıcı grubunuzun eklentiyi değiştirme izni yok ya da ödeme test veya canlı modda yapıldı ve o modun API anahtarı ayarlanmamış (anahtarı girin ve siparişi yeniden açın).

Geliştiriciler için: eklenti, OpenCart olaylarını tetikler: molg_supported_currencies (para birimi listesi) ve molg_payment_data (Mollie ödemesi oluşturulmadan önce ödeme isteği ve sipariş).

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Mollie Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca eklentinin olayları ve bakım modunda webhook'a izin veren başlatma eylemi kaldırılır). Delete Data on Uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, API anahtarları, günlükleme) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Mollie ödeme kimlikleri ve iade kayıtları her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklentinin dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Mollie Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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