VibeFox MultiSafepay 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.

Para birimi: mağaza veya sipariş para birimi, MultiSafepay'in kabul ettiği bir para birimi olmalıdır; örneğin EUR, USD, GBP, PLN, CHF, SEK, DKK veya NOK. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

MultiSafepay hesabı: MultiSafepay Control'deki web siteniz için API anahtarına ihtiyacınız vardır. Test ve canlı hesapların anahtarları farklıdır. MultiSafepay'de başka bir şey yapılandırmanız gerekmez: bildirim adresi her ödemeyle birlikte gönderilir.

Herkese açık site: MultiSafepay, bildirim göndermek için sitenize erişebilmelidir. Aksi halde, müşteri MultiSafepay'den döndüğünde siparişler yine de güncellenir.

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

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

3. Ayarları açın: WooCommerce > Settings > Payments > MultiSafepay > Manage veya 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. MultiSafepay Control'den test ve/veya canlı API anahtarını yapıştırın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve kaydedin. Test mode açıkken bir ödemeyi deneyin, ardından gerçek ödemeleri kabul etmek için işareti kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > MultiSafepay. Test modu açıkken sayfa başlığında bir Test mode rozeti görünür. Alanların üstünde sayfa, geçerli modda API anahtarı yoksa (bu durumda ödeme yöntemi ödeme sayfasında gösterilmez) veya MultiSafepay mağaza para birimini kabul etmiyorsa sizi uyarır. Ödeme yöntemleri listesinde, geçerli modda API anahtarı girilene kadar MultiSafepay kurulum gerektiren olarak işaretlenir.

Ödeme

Enable/Disable: Enable MultiSafepay ö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: MultiSafepay.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

API anahtarları

API anahtarını MultiSafepay Control > Manage settings > Website settings bölümünde bulabilirsiniz. Test hesabının (testmerchant.multisafepay.com) ve canlı hesabın (merchant.multisafepay.com) anahtarları farklıdır. Test modu yalnızca test anahtarını, canlı mod ise yalnızca canlı anahtarı kullanır.

Test mode: Use the MultiSafepay test environment (no real payments). Hem API adresini hem de API anahtarını değiştirir. Daha önce yapılmış ödemeler, durum kontrolleri ve iadeler için yapıldıkları ortamı kullanmaya devam eder. Varsayılan: açık.

Test API key: MultiSafepay test hesabınızın API anahtarı.

Live API key: MultiSafepay canlı hesabınızın API anahtarı.

Bildirimler

Yapılandırılacak bir şey yoktur. Bu bölüm, her ödemeyle birlikte MultiSafepay'e gönderilen bildirim URL'sini gösterir. Şuna benzer: https://your-site/?wc-api=mspg_webhook. MultiSafepay sitenize erişebilmelidir. Bir bildirim, eklentiye yalnızca hangi ödemenin değiştiğini söyler: durum, tutar ve para birimi, bir sipariş değiştirilmeden önce her zaman API anahtarınızla MultiSafepay API'sinden okunur. Mağazanızın bir siparişine ait olmayan ödemelerin bildirimleri yok sayılır.

Siparişler

Order status after payment: ödenmiş bir siparişin durumu. Durum hemen ayarlanır; tek bir durum değişikliği ve müşteriye tek bir e-posta gönderilir.

Gelişmiş

Debug log: Log API calls and notifications ayrıntıları WooCommerce > Status > Logs bölümüne, kaynak wcp_multisafepay_gateway olarak yazar. Hatalar her zaman kaydedilir. API anahtarları ve müşteri bilgileri kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak MultiSafepay) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde bir MultiSafepay ödemesi oluşturur ve müşteriyi MultiSafepay ödeme sayfasına gönderir. Orada müşteri, MultiSafepay hesabınızda etkin olan herhangi bir ödeme yöntemini seçer ve öder. Müşterinin fatura bilgileri ve mağaza dili MultiSafepay'e aktarılır; ödeme Order #, sipariş numarası ve site adınızla birlikte görünür. Test modunda ödeme sayfası Test mode: no real payment will be made. ifadesini gösterir.

Müşteri ödeme yaparken stok ayrılır ve sepet, sipariş alındı sayfasına kadar saklanır. Ödemeden sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş yalnızca MultiSafepay onayladıktan sonra ödenmiş olarak işaretlenir: bildirimle veya müşteri bu sayfaya ulaştığında MultiSafepay API'si üzerinden yapılan bir kontrolle.

Müşteri ödeme sırasında MultiSafepay sayfasında iptal ederse, sipariş WooCommerce'in standart yöntemiyle iptal edilir, stok serbest bırakılır ve ürünler sepette kalır. Müşteri Pay for order sayfasından ödeme yapıyorsa bu sayfaya döner ve olanı açıklayan bir mesaj görür: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. veya The payment session has expired. Please try again.

Müşteri ödenmemiş bir siparişi yeniden ödeyebilir. Yeni bir ödeme oluşturmadan önce eklenti, öncekini MultiSafepay üzerinden kontrol eder. Zaten ödenmişse sipariş onaylanır. Aynı tutarla hâlâ açıksa aynı ödeme sayfası yeniden kullanılır. Tutar değiştiyse eski ödeme MultiSafepay'de iptal edilir, böylece artık ödenemez.

MultiSafepay ödemeyi başlatamazsa müşteri, Could not connect to MultiSafepay. Please try again in a moment. veya MultiSafepay cannot accept this order amount or currency. Please choose another payment method. gibi kısa bir mesaj görür ve başka bir ödeme yöntemi seçebilir. MultiSafepay hatası sipariş notlarına eklenir.

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

Eklenti, MultiSafepay sayfasına yönlendiren tek bir ödeme yöntemi sunar. MultiSafepay'in her ödeme yöntemi için ayrı WooCommerce yöntemleri, gömülü kart alanları, Apple Pay veya Google Pay ekspres düğmeleri, abonelik, yinelenen ödeme veya kayıtlı kart yoktur; WooCommerce üzerinden tahsilat veya iptal yapılamaz. Sepet verisi gönderilmediği için MultiSafepay bu siparişler için bunu gerektiren sonradan ödeme yöntemlerini (örneğin Klarna, in3 veya Riverty) sunmaz.

Siparişler ve iadeler

Sipariş durumları

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

Processing veya Completed: MultiSafepay ödemeyi onayladı (tamamlandı veya gönderildi). Durum Order status after payment ayarını izler. Sipariş notunda MultiSafepay ödeme kimliği, ödeme yöntemi ve ortam gösterilir. İşlem kimliği, ödemenin MultiSafepay sipariş kimliğidir.

On hold before payment: ödeme mutabakatı yapılmamış (MultiSafepay tarafından inceleniyor) veya rezerve edilmiş (yetkilendirilmiş). Parayı almak için MultiSafepay Control'de rezerve edilmiş ödemeyi tahsil edin. MultiSafepay ödendi olarak bildirdiğinde sipariş otomatik tamamlanır.

On hold after payment: MultiSafepay, sipariş toplamından farklı bir tutar veya para birimi onayladı; mağaza canlı modda iken bir test ödemesi tamamlandı (gerçek para alınmadı) veya ödeme, sipariş iptal edildikten sonra tamamlandı. Sipariş notu bunu açıklar. MultiSafepay Control'deki işlemi kontrol edin ve siparişi manuel olarak işleyin ya da iade edin.

On hold after a chargeback: MultiSafepay, ödenmiş bir sipariş için geri ödeme (chargeback) bildirdi: para hesabınızdan geri alındı.

Failed: ödenmemiş bir siparişin son ödemesi reddedildi, iptal edildi, süresi doldu veya geçersiz kılındı (void). Tutulan stok serbest bırakılır. Müşteri yeniden deneyebilir.

Ödenmiş, iade edilmiş veya iptal edilmiş bir sipariş, gecikmiş bir bildirimle asla yeniden açılmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme tamamlanırsa sipariş tekrar değiştirilmez. Bir not, yinelenen ödemeyi MultiSafepay Control üzerinden iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via MultiSafepay düğmesine tıklayın. MultiSafepay ile ödenmiş siparişler için tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı ortama (test veya canlı) gönderilir; bu nedenle o ortamın API anahtarı ayarlanmış olmalıdır. MultiSafepay iadeyi kabul etmezse WooCommerce MultiSafepay hatasını gösterir ve hiçbir iade kaydedilmez. Başarılı bir istek, MultiSafepay iade kimliğiyle birlikte sipariş notlarına eklenir.

MultiSafepay Control'de yapılan iadeler, MultiSafepay bunları bildirdiğinde sipariş notlarına eklenir. Bunlar otomatik olarak WooCommerce iadesi olarak kaydedilmez. Gerekirse Refund via MultiSafepay kullanmadan WooCommerce'de manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Payments > MultiSafepay 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 düğmesini 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ı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan MultiSafepay, ö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, bir anahtar satın almadan eklentiyi kurup test edebilmeniz için ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder. 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.

Bir lisansın 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

MultiSafepay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda bir API anahtarı bulunduğunu (test modunda Test API key, canlı modda Live API key) ve mağaza veya sipariş para biriminin MultiSafepay tarafından kabul edildiğini kontrol edin. Anahtar eksikse veya para birimi kabul edilmiyorsa ayarlar sayfasında bir uyarı görünür.

Ödeme yapıldı ancak sipariş Pending payment durumunda kalıyor: bildirim mağazanıza ulaşmadı. Sitenizin internetten erişilebilir olduğunu ve ödemenin ortamının API anahtarının ayarlandığını kontrol edin, çünkü eklenti durumu MultiSafepay API'sinden okur. API'ye erişilemezse bildirim ERROR yanıtı verir ve MultiSafepay bildirimi yeniden dener. Sipariş ayrıca müşteri sipariş alındı sayfasına döndüğünde ve aynı siparişi yeniden ödemeye çalıştığında da güncellenir.

Müşteri sipariş verirken bir hata görüyor: sipariş notlarını açın veya Debug log seçeneğini açıp WooCommerce > Status > Logs bölümüne, kaynak wcp_multisafepay_gateway olarak bakın. This payment method is temporarily unavailable. Please choose another payment method. genellikle yanlış veya eksik bir API anahtarı anlamına gelir. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. ise MultiSafepay'in tutarı veya para birimini reddettiği anlamına gelir.

Sipariş On hold after payment durumunda: sipariş notunu okuyun. Ödeme mutabakatı yapılmamış veya rezerve edilmiş olabilir, ödenen tutar veya para birimi siparişten farklı olabilir, bir test ödemesi canlı modda gelmiş olabilir, ödeme sipariş iptal edildikten sonra tamamlanmış olabilir ya da bir geri ödeme (chargeback) olmuş olabilir. MultiSafepay Control'deki işlemi kontrol edin.

Test ödemeleri canlı bir siparişi onaylamıyor: mağaza canlı modda iken bir test ödemesi hiçbir siparişi ödemez; bunun yerine sipariş beklemeye alınır. Canlı moda geçtikten sonra da önceki test ödemeleri kontrol edilmeye ve test anahtarıyla iade edilmeye devam eder.

İade ortamla ilgili bir mesajla başarısız oluyor: ödeme test veya canlı ortamda yapıldı ve o ortamın API anahtarı ayarlanmamış. Anahtarı 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 yuva serbest bırakı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 kaldırılır. Ağ geçidi ayarları, siparişlerde saklanan MultiSafepay verileri ve günlükler yalnızca Delete data on uninstall seçeneği açıksa kaldırılır. Aksi hâlde sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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