VibeFox Mollie for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Mollie'nin desteklediği para birimlerinden biri: 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.

Sitenize internet erişimi: Mollie, webhook'ları mağazanıza gönderir; bu nedenle site internetten erişilebilir olmalıdır. Webhook'lar olmasa da müşteri Mollie'den döndüğünde siparişler güncellenir.

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. Ö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

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_mollie_gateway klasörünü FTP ile /wp-content/plugins/ klasörüne yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Mollie > Manage ya da 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. Test ve canlı API anahtarlarınızı girin (bkz. Yapılandırma). Mollie'de webhook ayarlamanız gerekmez.

6. Enable/Disable seçeneğini açın. Bir test ödemesi yapana kadar Test Mode açık kalsın, ardından işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Mollie. Alanların üstünde sayfa, Mollie etkin olduğu halde geçerli modun API anahtarı boşsa ve Mollie mağaza para birimini desteklemiyorsa uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde Mollie, geçerli modda API anahtarı olana kadar kurulum gerektiren olarak işaretlenir ve test modu açıkken Test mode gösterilir.

Kaydederken, test_ veya live_ ile başlamayan ve ardından en az 30 harf ve rakam içermeyen bir API anahtarı kaydedilmez: bir hata gösterilir ve önceki değer korunur.

Ödeme

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

Title: ödeme sayfasında müşteriye gösterilen ödeme yöntemi başlığı. Varsayılan: Mollie.

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

API anahtarları

API anahtarlarınızı Mollie Dashboard > Developers > API keys bölümünde bulabilirsiniz. Webhook kurulumu gerekmez: eklenti her ödemeyle birlikte kendi webhook URL'sini gönderir. URL bu bölümde gösterilir ve şuna benzer: https://your-site/?wc-api=molg_mollie_webhook. İnternetten erişilebilir olmalıdır; aksi hâlde siparişler yalnızca müşteri Mollie'den döndüğünde güncellenir.

Test Mode: Enable test mode, yeni ödemeler için test API anahtarını kullanır. Gerçek ödeme alınmaz. Mollie test ödeme sayfasında sonucu seçebilirsiniz (paid, failed, cancelled, expired). Müşteriler ödeme sayfası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: 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).

Siparişler

Order Status After Payment: başarılı bir ödemeden sonra ayarlanacak sipariş durumu. Durum tek adımda ayarlanır, ikinci bir durum değişikliği olmaz.

Gelişmiş

Logging: Enable debug logging, API çağrılarını ve webhook'ları WooCommerce > Status > Logs sayfasına, kaynak wcp_mollie_gateway olarak yazar. Hatalar her zaman günlüğe yazılır. API anahtarları ve müşteri verileri hiçbir zaman günlüğe yazılmaz. Varsayılan: kapalı.

Delete Data on Uninstall: Remove the plugin settings and logs when uninstalling. İşaretliyse eklenti silindiğinde eklenti ayarları ve günlük dosyaları silinir. Siparişlerde saklanan Mollie ödeme kimlikleri korunur. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Mollie) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde (JPY ve ISK ondalıksız) bir Mollie ödemesi oluşturur, açıklama olarak Order # ve sipariş numarasını ekler ve müşteriyi Mollie'nin barındırdığı ödeme sayfasına yönlendirir. Orada müşteri, Mollie hesabınızda etkinleştirilmiş ödeme yöntemlerinden birini seçer ve öder.

Mollie webhook'ları imza içermez, yalnızca ödeme kimliğini taşır. Bu nedenle eklenti bir webhook'a hiçbir zaman tek başına güvenmez: ödemeyi kendi API anahtarınızla Mollie API'sinden alır, ödemenin siparişe ait olduğunu kontrol eder ve ödenen tutarı ile para birimini siparişle karşılaştırır. Sipariş, Mollie bunu bu şekilde onayladıktan sonra ödenmiş olarak işaretlenir. Eklenti şu Mollie ödeme durumlarını işler:

Müşteri döndüğünde eklenti son ödemeyi aynı şekilde Mollie API'si üzerinden kontrol eder. Ödenmiş bir ödeme, sipariş alındı sayfasına yönlendirir. Ödeme iptal edildiyse, başarısız olduysa, süresi dolduysa veya tamamlanmadıysa müşteri, You cancelled the Mollie payment. You can try again or choose another payment method. ya da The Mollie payment has expired. Please try again or choose another payment method. gibi bir mesajla Pay for order sayfasına gider.

Müşteri yeniden ödeme yaptığında, ikinci bir ödenebilir ödeme oluşturmak yerine aynı tutardaki hâlâ açık Mollie ödemesi yeniden kullanılır. Sipariş 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 ödenmiş olarak işaretlenir.

Mollie ödemeyi başlatamazsa müşteri 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 sipariş notlarına ve günlüğe eklenir.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Müşteri Mollie yöntemini ödeme sayfanızda değil Mollie sayfasında seçer. Eklentide abonelik veya tekrarlayan ödemeler, kayıtlı kartlar veya mandalar, Mollie Components (sitenizdeki kart alanları), Apple Pay veya PayPal ekspres düğmeleri ve Orders API yoktur; bu nedenle sipariş satırı gerektiren yöntemler (örneğin bazı Klarna, Billie veya in3 seçenekleri) bu ödemeler için Mollie tarafından sunulmaz. Yetkilendirilmiş ödemeler WooCommerce'den değil, Mollie Dashboard'dan tahsil edilir veya iptal edilir.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Mollie'ye yönlendirildi ve henüz ödeme yapmadı.

Processing or Completed: ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Sipariş notu Mollie ödemesini, yöntemi ve modu gösterir. İşlem kimliği, siparişi ödeyen Mollie ödeme kimliğidir (tr_...).

On hold: bir banka havalesi parayı bekliyor, yetkilendirilmiş bir ödeme tahsilatı bekliyor veya Mollie bir geri ödeme (chargeback) bildirdi. Ödenen tutar veya para birimi siparişten farklıysa, mağaza canlı modda iken test ödemesi yapıldıysa (hiç para alınmadı), ya da ödeme siparişin iptalinden sonra geldiyse de Beklemede durumu ayarlanır. Sipariş notu nedenini açıklar. Ödemeyi Mollie Dashboard'da kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Failed: son ödeme denemesi başarısız oldu, süresi doldu veya iptal edildi. Ödenmiş bir sipariş hiçbir zaman değiştirilmez. Müşteri yeniden ödeme yapabilir.

Aynı siparişin ikinci bir ödemesi yapılırsa sipariş tekrar değiştirilmez. Bir not, Mollie Dashboard'unuzda çift ödemeyi iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Mollie düğmesine tıklayın (düğmede Title ayarınız görünür). Tam ve kısmi iadeler desteklenir. İade, siparişi gerçekte ödeyen ödeme için ve iadenin yapıldığı modun API anahtarıyla gönderilir; bu nedenle o modun anahtarı girilmiş olmalıdır. Düğme yalnızca ödenmiş bir Mollie ödemesi olan siparişler için kullanılabilir. Mollie iadeyi reddederse WooCommerce, Mollie'nin hata mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Mollie iade kimliğiyle birlikte sipariş notlarına eklenir.

Mollie Dashboard'da oluşturulan iadeler ve geri ödemeler WooCommerce iadelerine dönüştürülmez. Bir geri ödeme yalnızca bir not ekler.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Mollie sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu 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ı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Mollie müşterilere ödeme sayfasında 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler 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 ve iadeler çalışır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

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 API anahtarı bulunduğunu kontrol edin: test modunda Test API Key, canlı modda Live API Key. Mağaza para biriminin (ya da Pay for order sayfasındaki sipariş para biriminin) Mollie tarafından desteklendiğini kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir.

Ödeme gerçekleşti ama sipariş Pending payment durumunda kalıyor: webhook sitenize ulaşamıyor. Ayarlarda gösterilen webhook URL'si internetten erişilebilir olmalıdır (bakım modu, temel kimlik doğrulama veya erişimi engelleyen bir güvenlik duvarı olmamalıdır). Müşteri ödemeden sonra mağazaya döndüğünde sipariş de güncellenir.

Webhook answers Unknown payment.: ödeme kimliği, test veya canlı API anahtarınız için Mollie tarafından tanınmıyor; örneğin başka bir Mollie hesabına ait bir ödeme.

Webhook answers Payment ID mismatch.: ödeme, verilerine göre bu siparişe ait değil. Sipariş değiştirilmez.

Webhook answers Failed to fetch payment.: Mollie API'sine ulaşılamadı. Mollie webhook'u daha sonra yeniden dener.

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

Ödeme oluşturulmuyor: sipariş notu ve günlük, HTTP kodunu ve Mollie mesajını gösterir. 401 yanlış API anahtarı demektir; 422 isteğin bir alanına işaret eder, örneğin Mollie'nin kabul etmediği bir tutar veya para birimi. Logging seçeneğini açın ve WooCommerce > Status > Logs sayfasına, kaynak wcp_mollie_gateway olarak bakın.

Sipariş On hold durumunda: sipariş notunu okuyun. Neden; tutar veya para birimi uyuşmazlığı, canlı modda test ödemesi, iptalden sonra gelen ödeme, banka havalesi, tahsilatsız yetkilendirme veya geri ödeme olabilir.

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

Diğer para birimleri: geliştiriciler para birimi listesini molg_supported_currencies filtresiyle değiştirebilir.

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 serbest bırakı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 eklentiyi 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ı ve günlük dosyaları yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi hâlde sonraki yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını, Mollie ödeme kimliklerini ve işlem kimliklerini korur.

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