VibeFox MultiSafepay 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, 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 sitenizin API anahtarına ihtiyacınız vardır. Test ve canlı hesapların anahtarları farklıdır. MultiSafepay'de başka bir şey ayarlamanız gerekmez: bildirim adresi her ödemeyle birlikte gönderilir.

Herkese açık site: MultiSafepay, bildirim göndermek için mağazanıza erişebilmelidir. Aksi halde siparişler, müşteri MultiSafepay'den döndüğünde yine de durumlarını alır.

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

Kurulum

İndirme, OpenCart'ın her iki 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_multisafepay_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_multisafepay_gateway.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_multisafepay_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentide OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünü yenilemeniz 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 MultiSafepay 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. Sayfanın üstündeki lisans bloğunda bulunan License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. License key).

4. MultiSafepay Control'den aldığınız test ve/veya canlı API anahtarını yapıştırın (bkz. Configuration).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode açıkken bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için kapatın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_multisafepay_gateway.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış 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, Payments türünü seçin, VibeFox MultiSafepay 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ımlardaki gibi girin. Ayarlar sayfası ve alanları her iki sürümde aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Notification 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 MultiSafepay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, test modu açıkken Test mode: new payments use the MultiSafepay test environment (no real payments). ifadesini gösterir; ödeme yöntemi etkinse ancak geçerli modda API anahtarı yoksa uyarır (bu durumda ödeme yöntemi ödeme sayfasında gösterilmez) ve MultiSafepay mağazanızın varsayılan para birimini kabul etmiyorsa uyarır. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title 1 ila 128 karakter uzunluğunda olmalı, Sort Order tam sayı olmalı (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalı ve coğrafi bölge ile sipariş durumları mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez ve sayfa sorunu belirtir. Ödeme yöntemi, geçerli modun API anahtarı olmadan etkinleştirilmişse ayarlar bir uyarıyla kaydedilir.

Checkout

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ı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: MultiSafepay. Zorunlu, en fazla 128 karakter.

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

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

Geo Zone: MultiSafepay'i 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: MultiSafepay'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde toplam tutar. MultiSafepay'i her tutar için sunmak üzere boş bırakın.

API anahtarları

API anahtarını MultiSafepay Control > Manage settings > Website settings bölümünde bulabilirsiniz. Bu bölüm test hesabına (testmerchant.multisafepay.com) ve canlı hesaba (merchant.multisafepay.com) bağlantılar içerir. Farklı anahtarları vardır. Test modu yalnızca test anahtarını, canlı mod yalnızca canlı anahtarı kullanır.

Test mode: MultiSafepay test ortamını kullanır (gerçek ödeme yapılmaz). 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. Açık olduğu sürece müşteri Confirm Order adımında Test mode: no real payment will be made. ifadesini görür.

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

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

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

Bildirimler

Yapılandırılacak bir şey yoktur. Notification URL alanı, her ödemeyle MultiSafepay'e gönderilen adresi gösterir. OpenCart 3'te adres şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_multisafepay_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_multisafepay_gateway/payment/wcp_multisafepay_gateway.webhook biçimindedir. Adres, OpenCart kurulumunuzun vitrin adresinden oluşturulur. Bir bildirim eklentiye yalnızca hangi ödemenin değiştiğini söyler: durum, tutar ve para birimi, sipariş değiştirilmeden önce her zaman ödemenin ortamına ait API anahtarıyla MultiSafepay API'sinden okunur. Mağazanızda başlatılmamış ödemelerin bildirimleri yoksayılır. Bildirim, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentilerinin isteklerini geçirir, OpenCart 4'te ise eklenti bunun için bir startup action ekler ve bu, müşterinin MultiSafepay'den dönmesini de sağlar.

Siparişler

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

Order status after payment: ödenmiş bir siparişin durumu. Varsayılan: İşleniyor. Ödenmiş siparişleri hemen tamamlamak için Complete seçin.

MultiSafepay payment on hold status: ödeme dikkat gerektirir (bkz. Order statuses). Varsayılan: Beklemede, çünkü OpenCart'ta Beklemede durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Payment error status: tahsil edilmemiş veya ayrılmış bir ödeme daha sonra reddedildi, süresi doldu veya iptal edildi. Varsayılan: Başarısız.

Refunded status: ödeme, sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: İade edildi.

Gelişmiş

Debug log: API çağrılarını ve bildirimleri OpenCart günlük klasöründe (storage/logs) bulunan mspg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman kaydedilir. API anahtarları ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Delete data on uninstall: açıkken eklentiyi kaldırmak, ağ geçidi ayarlarını ve günlüğü siler. Siparişlerin MultiSafepay ödeme kayıtları her zaman saklanır, böylece eski siparişlerin iadeleri mümkün kalır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. 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. Kayıtlı API anahtarları korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak MultiSafepay). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to MultiSafepay 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 bir MultiSafepay ödemesi oluşturur ve müşteriyi MultiSafepay ödeme sayfasına yönlendirir. Orada müşteri, MultiSafepay hesabınızda etkin olan herhangi bir ödeme yöntemini 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 sayfanın altındaki Confirm Order düğmesine tıklar. Müşterinin fatura adresi, e-posta, telefon ve dili MultiSafepay'e iletilir ve ödeme, Order #, sipariş numarası ve mağazanızın adıyla görünür.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca MultiSafepay onayladıktan sonra ödenmiş olarak işaretlenir: bildirim yoluyla ya da müşteri döndüğünde MultiSafepay API'si ile yapılan kontrolle. Ardından sipariş, OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle durum alır ve müşteri, OpenCart sipariş başarı sayfasında Your payment with MultiSafepay has been received. ifadesini görür. Beklemedeki bir sipariş için sayfa We are confirming your payment with MultiSafepay. The order will be updated automatically — please do not pay again. ifadesini gösterir. Ödeme daha sonra başarısız olursa sayfa Your MultiSafepay payment was not completed. Please contact us about this order. ifadesini gösterir. Müşteri döndüğünde MultiSafepay henüz ödemeyi onaylamamışsa (örneğin bir banka havalesi bekleniyorsa), Payment confirmation sayfası aynı "onaylanıyor" metnini ve Check again düğmesini gösterir; MultiSafepay ödemeyi bildirir bildirmez bildirim sipariş durumunu ayarlar.

Müşteri MultiSafepay sayfasında iptal ederse veya ödeme reddedilir ya da süresi dolarsa, müşteri sepeti korunmuş halde ödeme sayfasına döner ve şu mesajlardan biriyle karşılaşı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. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise aynı siparişi yeniden öder. Yeni bir ödeme oluşturmadan önce eklenti, aynı sepetin önceki ödemelerini MultiSafepay'de kontrol eder. Bunlardan biri zaten ödenmişse veya işleniyorsa, o ödeme onaylanır ve müşteri tekrar ödeme yapmak yerine başarı sayfasına gider. Bu siparişin ödemesi aynı ortam, tutar ve para birimiyle hâlâ açıksa, aynı ödeme sayfası yeniden kullanılır. Aksi halde eski ödeme MultiSafepay'de iptal edilir ve artık ödenemez.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Bu sipariş ödeme yapılmadan kapatıldıysa (örneğin, beklemeye alındıktan sonra ödemesi reddedildi veya süresi doldu ya da siz iptal ettiniz), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına döner ve bir sonraki Confirm Order işlemi yeni bir sipariş için ödeme yapar. Sipariş ödendikten sonra mağaza tarafından kapatıldıysa (örneğin iade edildiyse), mesaj Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order. şeklindedir. Sipariş zaten oluşturulmuşsa ve o zamandan beri sepet değiştiyse mesaj Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. şeklindedir. Sepetteki her değişiklik, yeni miktar dahil, kendi ödemesini gerektiren yeni bir sepet sayılır. Ödenip ardından iptal edilen veya iade edilen bir siparişin sepeti artık tutmaz.

MultiSafepay ödemeyi başlatamazsa müşteri, düğmenin üstünde kısa bir mesajla Confirm Order adımında kalır; örneğin 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. Teknik neden günlüğe yazılır.

Eklenti, MultiSafepay sayfasına giden tek bir ödeme yöntemi sunar. Her MultiSafepay ödeme yöntemi için ayrı OpenCart ödeme yöntemleri, gömülü kart alanları, Apple Pay veya Google Pay ekspres düğmeleri, abonelikler, yinelenen ödemeler veya kayıtlı kartlar yoktur; OpenCart'tan tahsilat veya iptal de yapılamaz. Sepet verisi gönderilmediği için bunu gerektiren sonra öde yöntemleri (örneğin Klarna, in3 veya Riverty) bu siparişler için MultiSafepay tarafından sunulmaz.

Siparişler ve iadeler

Order statuses

No status (missing order): müşteri MultiSafepay'e yönlendirildi ve ödeme yapmadı, MultiSafepay ödemeyi henüz onaylamadı ya da ödeme iptal edildi, reddedildi veya süresi doldu. 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 (default Processing): MultiSafepay ödemeyi, siparişin tam tutarı ve para birimiyle onayladı (tamamlandı veya gönderildi). Bir not, ödemeyi, ödeme yöntemini ve ortamı gösterir.

MultiSafepay payment on hold status (default Pending), before payment: ödeme tahsil edilmemiş (MultiSafepay tarafından inceleniyor) veya ayrılmış (yetkilendirilmiş) durumda. Parayı almak için MultiSafepay Control'de ayrılmış bir ödemeyi tahsil edin. MultiSafepay ödemeyi tamamlandı olarak bildirdiğinde sipariş otomatik olarak Order status after payment durumuna geçer; reddedildiğinde, iptal edildiğinde, süresi dolduğunda veya geçersiz kılındığında ise Payment error status durumuna geçer.

MultiSafepay payment on hold status, after payment: MultiSafepay, sipariş toplamından farklı bir tutar veya para birimi onayladı; eklenti canlı moddayken bir test ödemesi tamamlandı (gerçek para alınmadı) veya ödeme, siparişe başka bir durum verildikten sonra tamamlandı (örneğin iptal edildikten sonra). Not bunu açıklar. MultiSafepay Control'de işlemi kontrol edin, ardından siparişi işleyin veya iade edin.

MultiSafepay payment on hold status, after a chargeback: MultiSafepay, ödenmiş bir siparişin ödemesi için bir chargeback bildirdi: para hesabınızdan geri alındı.

Payment error status (default Failed): tahsil edilmemiş veya ayrılmış bir ödeme daha sonra reddedildi, iptal edildi, süresi doldu veya geçersiz kılındı.

Refunded status (default Refunded): ödeme, eklenti üzerinden tamamen iade edildi.

Ödenmiş veya iade edilmiş bir sipariş, geç gelen bir bildirimle asla yeniden açılmaz. Zaten ödenmiş bir sepet için ikinci bir ödeme tamamlanırsa, ödenmiş sipariş değiştirilmez. Bir not, kopyayı MultiSafepay Control'de iade etmenizi ister.

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

VibeFox MultiSafepay Gateway sekmesi

Sales > Orders bölümünde MultiSafepay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox MultiSafepay Gateway sekmesi, MultiSafepay order bilgisini (test ödemeleri için Test environment etiketiyle), Method, Status, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin MultiSafepay notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox MultiSafepay Gateway sekmesinde Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak Reason (optional) alanını doldurun ve Refund via MultiSafepay düğmesine tıklayın. Refund this amount through MultiSafepay? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme iznine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İadeler, MultiSafepay'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamı değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İ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 sekme, MultiSafepay hatasıyla birlikte MultiSafepay refund failed: mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, MultiSafepay iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirim yapmadan ve ürünleri stoğa geri eklemeden Refunded status durumuna getirir; tıpkı elle yapılan bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, MultiSafepay ödemeyi bildirdikten sonra kullanılabilir.

Sales > Returns bölümündeki ürün iadeleri MultiSafepay üzerinden para geri göndermez.

MultiSafepay Control'de yapılan iadeler, MultiSafepay bildirdiğinde notlara eklenir. Sipariş durumu otomatik olarak değişmez. Gerekirse durumu elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox MultiSafepay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox MultiSafepay 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ı maskelenmiş 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 ve anahtarı bu mağazadan kaldırmak için Remove key. Altlarında Product: opencart-payment-multisafepay satırı ve hesabınızda, 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 paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini söyler; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihle birlikte License expired on. Mağaza adresi değiştikten veya hesabınızda bir alan adı yuvası boşaltıldıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır. Anahtarın mağazadan kaldırılması alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltı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. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici oturumunu görmediği için, etkin bir anahtar yoksa ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici paneli Dashboard bölümünde bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün boyunca gizlenir. 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. Yönetici paneli Dashboard veya Edit sayfası açıldığında durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında ise haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

MultiSafepay does not appear at checkout: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun bir API anahtarı olduğunu kontrol edin: test modunda Test API key, canlı modda Live API key. Anahtar eksikse ayarlar sayfası bir uyarı gösterir. Müşteri, MultiSafepay'in kabul ettiği bir para biriminde (mağazada seçili para birimi) ödeme yapmalıdır. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda belirtilen Total tutarına ulaştığını kontrol edin.

The payment went through, but the order stays without a status: bildirim mağazanıza ulaşmadı. Mağazanın internetten erişilebilir olduğunu ve ödemenin ortamına ait API anahtarının ayarlı olduğunu kontrol edin, çünkü eklenti durumu MultiSafepay API'sinden okur. API'ye ulaşılamıyorsa veya anahtar yoksa bildirim ERROR yanıtı verir ve MultiSafepay yeniden dener. Sipariş, müşteri mağazaya döndüğünde ve aynı sepeti tekrar ödemeye çalıştığında da durum alır.

Notification answers Invalid request: istekte geçerli bir işlem kimliği yoktu. MultiSafepay bildirimleri her zaman bir işlem kimliği içerir.

The customer sees an error after Confirm Order: Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. This payment method is not available. ifadesi, ödeme oturumunun artık siparişle eşleşmediği veya bu arada ödeme yönteminin kapatıldığı anlamına gelir: müşteri ödeme sayfasını yeniden yüklemelidir. 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. ifadesi ise MultiSafepay'in tutarı veya para birimini reddettiği anlamına gelir.

The customer comes back and sees Payment verification failed.: dönüş adresi bu mağazanın bir ödemesiyle eşleşmedi; örneğin eski veya değiştirilmiş bir bağlantı nedeniyle. Müşteri ödeme sayfasından tekrar ödeme yapabilir.

Order is in the on hold status: VibeFox MultiSafepay Gateway sekmesindeki notları okuyun. Ödeme tahsil edilmemiş veya ayrılmış olabilir, ödenen tutar veya para birimi siparişten farklı olabilir, canlı modda bir test ödemesi gelmiş olabilir, ödeme siparişin iptalinden sonra gelmiş olabilir ya da bir chargeback yaşanmış olabilir. MultiSafepay Control'de işlemi kontrol edin.

Test payments do not confirm a live order: eklenti canlı moddayken bir test ödemesi hiçbir zaman bir siparişi ödemez; bunun yerine sipariş beklemeye alınır. Canlıya geçtikten sonra da önceki test ödemeleri test anahtarıyla kontrol edilmeye ve iade edilmeye devam eder.

No refund form in the tab: sekme nedenini belirtir: ödeme henüz bildirilmemiştir, tamamen iade edilmiştir veya kullanıcı grubunuzun eklentiyi değiştirme izni yoktur.

Refund fails with a message about the environment: ödeme test veya canlı ortamda yapılmıştır ve o ortamın API anahtarı ayarlanmamıştır. Anahtarı girin ve yeniden deneyin.

Geliştiriciler için: eklenti, desteklenen para birimlerini ve MultiSafepay'e gönderilen ödeme verilerini değiştirmek üzere mspg_supported_currencies ve mspg_order_request OpenCart olaylarını tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox MultiSafepay 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 olayları ve bakım modunda bildirimleri geçiren startup action da 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ı, hata ayıklama günlüğü) ve günlük kaldırılır. Kapalıysa bunlar sonraki bir yeniden kurulum için saklanır. MultiSafepay ödeme ve iade kayıtları her zaman saklanır; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

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

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