VibeFox Montonio for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

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

PHP: 8.0 veya üzeri.

Para birimi: mağaza veya sipariş para birimi EUR veya PLN olmalıdır. Diğer tüm para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

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

Herkese açık site: Montonio bildirimlerini alabilmek için sitenizin internetten erişilebilir olması gerekir. Aksi halde müşteri mağazaya döndüğünde siparişler yine de onaylanır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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_montonio_payment klasörünü FTP ile /wp-content/plugins/ klasörüne de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Montonio > 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. Montonio Partner System'de Stores > your store > API keys bölümünü açın ve sandbox erişim anahtarını ile gizli anahtarını kopyalayın. Bunları ayarlara yapıştırın ve Sandbox mode seçeneğini açık tutun.

6. Enable/Disable seçeneğini etkinleştirin ve sandbox'ta bir ödeme deneyin. Ardından canlı anahtarları girin ve Sandbox mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Montonio. Alanların üstünde sayfa, geçerli ortamın anahtarları eksik olduğunda (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağaza para birimi EUR veya PLN değilse sizi uyarır; sandbox açıkken Sandbox mode is on: payments are simulated and no real money is charged. ifadesini gösterir. Ödeme yöntemleri listesinde, geçerli ortamın her iki anahtarı da girilene kadar Montonio kurulum gerektiren olarak işaretlenir.

Genel

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Bank payment (Montonio).

Description: ödeme sayfası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 bulabilirsiniz. Sandbox ve canlı anahtarlar farklıdır. Sandbox yalnızca sandbox anahtarlarını, canlı mod yalnızca canlı anahtarları kullanır. Ayarların bu bölümü bildirim URL'sini de gösterir. Şuna benzer: https://your-site/wc-api/wc_mnt_payment/. Bunu bir yere girmeniz gerekmez: eklenti her ödemeyle birlikte bunu Montonio'ya gönderir.

Sandbox mode: Use the Montonio sandbox (test payments, no real money). Hem Montonio API adresini hem de anahtar çiftini değiştirir. Varsayılan: açık. Yalnızca canlı anahtarları girdikten sonra kapatın.

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

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

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

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

Gelişmiş

Debug log: Log payment events tüm ödeme olaylarını WooCommerce > Status > Logs bölümüne, kaynak wcp_montonio_payment olarak yazar. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Anahtarlar, token'lar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete data: Delete the gateway settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Sipariş verileri (Montonio UUID'leri, notlar) her zaman korunur. Varsayılan: kapalı.

Ödeme bildirimleri

Montonio, her ödemeyi imzalı bir token ile mağazanıza bildirir. Token iki şekilde gelir: bildirim adresine sunucudan sunucuya bir bildirimle ve müşteri mağazaya döndüğünde onunla birlikte. İkisi de kontrol edilir: imza gizli anahtarınızla, son kullanma tarihi, erişim anahtarınız ve ödemenin, mağazanızın aynı ortamda o sipariş için oluşturduğu bir ödeme olup olmadığı. Kontrolü geçemeyen token'lar reddedilir. Her durum yalnızca bir kez uygulanır; bu nedenle tekrarlanan bildirimler not, e-posta veya stok değişikliği eklemez.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Bank payment (Montonio)) ve siparişi verir. Eklenti, sipariş toplamı için sipariş 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 siparişleri için Polonya). Ödeme, Order ve sipariş 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ında açıklamanın altında SANDBOX MODE — test payment, no real money is charged. görünür.

Sipariş, Montonio PAID durumuyla ve siparişin tam tutarı ve para birimiyle onaylayınca ödenmiş olarak işaretlenir. Ödemeden sonra müşteri mağazanızın sipariş alındı sayfasına döner. Montonio ödemeyi henüz onaylamadığı sürece bu sayfada Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. ifadesi görünür. Ödeme iptal edilir ya da reddedilirse müşteri Pay for order sayfasına döner ve şu mesajlardan birini görür: 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. ya da Montonio could not complete the payment. Please try again or choose another payment method.

Müşteri, ödenmemiş bir siparişi Pay for order sayfasından yeniden ödeyebilir. Yeni bir ödeme oluşturulmadan önce eklenti, önceki ödemeyi Montonio'ya sorar. Önceki ödeme zaten yapılmışsa sipariş onaylanır ve ikinci bir ödeme oluşturulmaz.

Montonio ödemeyi başlatamazsa müşteri 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., ve başka bir ödeme yöntemi seçebilir. Montonio hatası 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.

Eklenti yalnızca banka ödemelerini (ödeme başlatma) destekler. 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ı

Ödeme bekliyor: müşteri Montonio'ya gönderildi ve henüz ödeme yapmadı. Montonio ödemeyi beklemede olarak bildirdiğinde bir not eklenir.

İşleniyor veya Tamamlandı: Montonio ödemeyi onayladı (PAID). Sipariş, ödenmiş siparişler için WooCommerce'in standart durumunu izler. Sipariş notu bankayı, Montonio ödeme UUID'sini, tutarı ve ortamı gösterir. İşlem kimliği Montonio ödeme UUID'sidir.

Beklemede: banka ödemeyi henüz onaylamadı (AUTHORIZED); Montonio PAID bildirdiğinde sipariş ödenmiş olur. Montonio, sipariş toplamından farklı bir tutar veya para birimi bildirdiğinde, mağaza canlı modda çalışırken bir sandbox ödemesi geldiğinde ya da ödeme siparişin iptalinden sonra ulaştığında da sipariş Beklemede durumuna getirilir. Sipariş notu nedenini açıklar. Ödemeyi Montonio Partner System'de kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

Başarısız: müşteri ödemeyi tamamlamadı ya da banka reddetti. Yalnızca ödenmemiş bir siparişin son ödemesi siparişi başarısız duruma getirebilir. Müşteri, Pay for order sayfasından yeniden deneyebilir.

Ödenmiş, iptal edilmiş veya iade edilmiş siparişler, sonraki bildirimlerle asla 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.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Bank payment (Montonio) düğmesine tıklayın (düğme ödeme yöntemi adını kullanır). Montonio ile ödenen siparişler için tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı ortama (sandbox veya canlı) gönderilir; bu nedenle o ortamın anahtarları girilmiş olmalıdır. Montonio iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Gönderilen bir iade, durumu ve Montonio iade kimliğiyle birlikte sipariş notlarına eklenir.

Montonio, her iadeyi daha sonra bir bildirimle onaylar ya da reddeder. Onay, sipariş notlarına eklenir. Montonio iadeyi reddederse not, paranın müşteriye iade edilmediğini belirtir; bunu Montonio Partner System'de kontrol edin ve WooCommerce iadesini düzeltin.

Montonio Partner System'de yapılan iadeler, Montonio bildirdiğinde sipariş notlarına eklenir. Bunlar otomatik olarak WooCommerce iadesi olarak kaydedilmez. Gerekirse WooCommerce'de manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Montonio sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu) ve alan adınızı gösterir. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, 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 tek bir alan adında çalışır. Anahtarın bir siteden kaldırılması alan adı hakkını serbest bırakmaz. Bunu vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Montonio ö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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece 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 onaylanmaya devam eder ve iadeler çalışır.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Montonio ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli ortamın her iki anahtarının da girilmiş olduğunu (sandbox modunda Sandbox access key ve Sandbox secret key, canlı modda Live access key ve Live secret key) ve mağaza ya da sipariş para biriminin EUR veya PLN olduğunu kontrol edin. Ayarlar sayfası anahtarlar eksik olduğunda ya da para birimi desteklenmediğinde uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş Ödeme bekliyor durumunda kaldı: bildirim mağazanıza ulaşmadı. Sitenin internetten erişilebilir olduğunu ve ayarlardaki anahtarların ödemenin ortamına ait olduğunu kontrol edin. Sipariş, müşteri ödemeden sonra mağazaya döndüğünde ve aynı siparişi yeniden ödemeye çalıştığında da onaylanır.

Bildirim Invalid token yanıtı veriyor: token imzası, son kullanma tarihi veya erişim anahtarı eşleşmedi. Erişim anahtarının ve gizli anahtarın doğru kopyalandığını, doğru ortama ait olduklarını ve sunucu saatinin doğru olduğunu kontrol edin.

Bildirim Payment does not belong to this order veya Wrong environment yanıtı veriyor: ödeme, bu mağaza tarafından bu sipariş için oluşturulmamış ya da diğer ortamda (sandbox veya canlı) oluşturulmuş. Bu, iki mağazanın aynı Montonio hesabını ve aynı sipariş numaralarını kullanmasında olur.

Bildirim Gateway not configured yanıtı veriyor: hiçbir Montonio anahtarı ayarlanmamış. Anahtarları girin; Montonio bildirimi yeniden deneyecektir.

Müşteri sipariş verirken bir hata görüyor: sipariş notlarını açın ya da Debug log seçeneğini etkinleştirip WooCommerce > Status > Logs bölümünde kaynak wcp_montonio_payment kayıtlarına bakın. This payment method is temporarily unavailable. Please choose another payment method. genellikle yanlış ya da 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 notta yer alır.

Ödemeden sonra sipariş Beklemede: sipariş notunu okuyun. Banka ödemeyi henüz onaylamadı, ödenen tutar veya para birimi siparişle uyuşmuyor, mağaza canlı modda iken bir sandbox ödemesi geldi ya da ödeme siparişin iptalinden sonra ulaştı. Ödemeyi Montonio Partner System'de kontrol edin.

Sandbox ödemeleri canlı bir siparişi onaylamaz: mağaza canlı modda iken bir sandbox ödemesi hiçbir zaman siparişi tamamlamaz; bunun yerine sipariş Beklemede durumuna getirilir. Sandbox mode ayarını istediğiniz ortama değiştirin ve o ortamın anahtarlarını kullanın.

İade ortamla ilgili bir mesajla başarısız oluyor: ödeme sandbox ya da canlı ortamda yapıldı ve o ortamın anahtarları girilmemiş. Anahtarları girin ve yeniden deneyin.

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 yer açın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı 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 silinir. Ağ geçidi ayarları ve günlükler yalnızca Delete data seçeneği açıksa silinir. Aksi halde ileride yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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