VibeFox Moyasar for OpenCart — Yardım

Gereksinimler

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

PHP: 8.0 veya üzeri.

Para birimi: ödeme sayfasındaki para birimi SAR, AED, USD, EUR, KWD, BHD veya OMR olmalıdır. Diğer tüm para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Moyasar hesabı: Moyasar hesabınızın gizli API anahtarlarına (test ve canlı) ihtiyacınız vardır. Yalnızca gizli anahtarlar kullanılır. Ödeme Moyasar sayfasında gerçekleştiği için yayımlanabilir anahtara (publishable key) gerek yoktur. Moyasar Dashboard'da bir webhook eklemeniz önerilir (bkz. Yapılandırma).

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

Kurulum

İndirme, her iki OpenCart sürümünün paketlerini içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_moyasar_payment_gateway.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini 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_moyasar_payment_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketteki 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 ve tür olarak Payments seçin. VibeFox Moyasar Payment Gateway eklentisini bulun ve Install düğmesine (yeşil +) tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin listesini değiştirme iznine sahip olması gerekir.

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

4. Moyasar gizli anahtarlarınızı yapıştırın ve Save düğmesine tıklayın. İlk kaydetmede webhook paylaşılan gizli anahtarı oluşturulur ve ayarların üstünde yalnızca bir kez gösterilir. Webhook'u bu anahtarla Moyasar Dashboard'da yapılandırın (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test modunda bir deneme siparişi oluşturun, ardından Test mode seçeneğini kapatın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_moyasar_payment_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 +) tıklayın.

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

4. Lisans anahtarını, Moyasar anahtarlarını ve webhook'u 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 Moyasar Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa; geçerli modun gizli anahtarı yoksa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir), kayıtlı bir webhook paylaşılan gizli anahtarı yoksa (bu durumda webhook her çağrıyı reddeder) veya mağazanın varsayılan para birimi desteklenmiyorsa sizi uyarır. Eklenti test modunda etkinken Test modu etkin: ödemeler simüle edilir, herhangi bir tutar tahsil edilmez. ifadesini gösterir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir, ancak kaydedemez.

Kaydederken Title alanı 1 ila 128 karakter uzunluğunda olmalıdır, Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve bölge ile sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Eklenti bir yayımlanabilir anahtarı, diğer modun bir anahtarını veya boşluk içeren bir anahtarı reddeder: Geri kalanı Ayarlar kaydedildi, kırmızıyla gösterilen anahtar hariç. ifadesiyle kaydedilir, önceki anahtar korunur ve nedeni gösterilir. Eklenti, geçerli modun gizli anahtarı olmadan etkinleştirilirse ayarlar bir uyarıyla kaydedilir.

Moyasar

Enable/Disable: Enable Moyasar ö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 yöntem adıdır. Varsayılan: Pay with Moyasar. Zorunlu, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde gördüğü metin. Varsayılan: You will be redirected to the secure Moyasar payment page to pay with mada, Visa, Mastercard, Apple Pay or STC Pay. Test modunda bu adım (Test modu: Gerçek bir ödeme yapılmaz.) ifadesini ekler.

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

Geo Zone: Moyasar'ı yalnızca seçilen bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones bölümünde tanımlanır.

Total: Moyasar'ın sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde sepet toplamı. Moyasar'ı her toplam için sunmak üzere boş bırakın.

API anahtarları

Gizli anahtarları Moyasar Dashboard > Settings > API Keys bölümünden kopyalayın (sayfada oraya bir bağlantı bulunur). Test ve canlı anahtarları ayrıdır. Test modu yalnızca test anahtarını, canlı mod ise yalnızca canlı anahtarı kullanır.

Test mode: test gizli anahtarını kullanır: ödemeler simüle edilir ve herhangi bir tutar tahsil edilmez. Varsayılan: açık. Gerçek ödemeleri canlı gizli anahtarla kabul etmek için kapatın. Diğer moddaki faturalar, durum kontrolleri ve iadeler için kendi modlarının anahtarını kullanmaya devam eder.

Test secret key: test modunun gizli anahtarı. sk_test_ ile başlar.

Live secret key: canlı modun gizli anahtarı. sk_live_ ile başlar.

Kaydedilmiş anahtarlar ve gizli değerler bir daha gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kaydedilmiş bir değeri kaldırmak için alanın altındaki Clear the saved value on save kutucuğunu işaretleyin ve Save düğmesine tıklayın.

Ödeme bildirimleri (webhook)

Webhook önerilir, ancak zorunlu değildir. Siparişler, müşteri mağazaya döndüğünde ve fatura ödendiğinde Moyasar'ın mağazanıza otomatik olarak gönderdiği fatura bildirimiyle de onaylanır. Webhook, geri dönmeden önce tarayıcısını kapatan müşterileri kapsar ve Moyasar Dashboard'da yapılan iadeleri bildirir. Bunu Moyasar Dashboard > Settings > Webhooks bölümünde ekleyin.

Webhook URL: salt okunur olarak, bir Copy düğmesiyle gösterilir. OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_moyasar_payment_gateway/webhook biçimindedir, OpenCart 4'te https://your-store/index.php?route=extension/wcp_moyasar_payment_gateway/payment/wcp_moyasar_payment_gateway.webhook biçimindedir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın. HTTP yöntemi: POST. URL, internet üzerinden erişilebilir olmalıdır.

Webhook shared secret: Moyasar'daki webhook'un Shared secret değerini aynen girin ya da Generate a new secret seçeneğini işaretleyip kaydedin. Kayıtlı bir değer yoksa Save rastgele bir gizli anahtar oluşturur. Oluşturulan gizli anahtar, kaydettikten sonra ayarların üstünde yalnızca bir kez gösterilir ve bir daha gösterilmez; bu nedenle hemen Moyasar'a kopyalayın. Doğru paylaşılan gizli anahtar olmayan webhook'lar reddedilir. Tek bir paylaşılan gizli anahtar iki mod için de geçerlidir.

Webhook için şu olayları seçin (bu bölümde de listelenmişlerdir):

Bir webhook veya bildirimdeki hiçbir veri doğrudan güvenilir kabul edilmez: her biri için eklenti, faturayı Moyasar API'sinden, faturanın oluşturulduğu modun gizli anahtarıyla okur ve faturanın bu mağaza tarafından oluşturulduğunu doğrular. Aynı Moyasar hesabındaki diğer entegrasyonların ödemeleri yok sayılır.

Siparişler

OpenCart, siparişi Confirm Order adımında durum olmadan oluşturur (eksik sipariş). Sipariş, yalnızca Moyasar faturayı onayladıktan sonra bir durum alır. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Status after payment: onaylanmış bir ödemeden sonra ayarlanan durum. Varsayılan: İşleniyor. Ödenen siparişlerin hemen tamamlanmasını istiyorsanız Complete, her ödenmiş siparişin manuel kontrol beklemesini istiyorsanız inceleme durumunuzu seçin.

Awaiting Moyasar payment status: Moyasar ödemeyi inceleme için bekletir; Moyasar onayladığında sipariş Status after payment durumuna geçer. Varsayılan: Beklemede.

Moyasar payment on hold status: Moyasar, sipariş toplamından farklı bir tutar veya para birimi bildirdi ya da fatura, sipariş iptal edildikten veya başka bir duruma alındıktan sonra ödendi. Sipariş ödenmiş olarak işaretlenmez. Varsayılan: Beklemede; çünkü OpenCart'ta Beklemeye alındı durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Payment error status: inceleme altındaki ödeme başarısız oldu. 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ükleri klasöründeki (storage/logs) moyasar_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında moyasar_p_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar her zaman kaydedilir. API anahtarları, kart verileri ve müşteri bilgileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Log: günlüğün mevcut boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Clean uninstall: açıkken eklentiyi kaldırmak, ağ geçidi ayarlarını ve günlüğü siler. Siparişlerle birlikte kaydedilen ödeme ayrıntıları (Moyasar fatura ve ödeme kimlikleri) korunur; böylece iadeler izlenebilir kalır. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Anahtarlar ve gizli değerler 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ş anahtarlar ve gizli değerler korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Pay with Moyasar). Confirm Order adımında müşteri sizin açıklamanızı görür. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı için sipariş para biriminde bir Moyasar faturası oluşturur ve müşteriyi bu faturanın ödeme sayfasına yönlendirir. Orada müşteri, Moyasar hesabınızda etkin olan herhangi bir yöntemle öder. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle ve Payment method options penceresinde ödeme yöntemini seçer, ardından ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Fatura, Order #, sipariş numarası ve mağaza adınızı gösterir.

Sipariş, yalnızca Moyasar onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, faturayı Moyasar API'sinden okur ve faturanın ödenmiş olduğunu, bu siparişe ait olduğunu ve tam olarak sipariş tutarı ile para birimine sahip olduğunu doğrular. Sipariş daha sonra, olağan sipariş e-postaları ve stok güncellemesiyle OpenCart'ın standart yoluyla durumunu alır ve müşteri OpenCart sipariş başarı sayfasında Moyasar ile yaptığınız ödeme alındı. ifadesini görür. Moyasar ödemeyi inceleme için bekletiyorsa sayfa Ödemeniz Moyasar tarafından inceleniyor. Moyasar onayladığında sipariş otomatik olarak güncellenecektir — lütfen tekrar ödeme yapmayın. ifadesini gösterir. Sipariş sizin incelemeniz için beklemede ise sayfa Ödemenizi aldık ve siparişinizi inceliyoruz. Bir ihtiyaç olursa sizinle iletişime geçeceğiz — lütfen tekrar ödeme yapmayın. ifadesini gösterir. İnceleme altındaki bir ödeme daha sonra başarısız olursa sayfa Moyasar ödemeniz tamamlanamadı. Bu sipariş hakkında lütfen bizimle iletişime geçin. ifadesini gösterir.

Müşteri ödeme yapmadan geri dönerse (örneğin ödeme sayfasının geri düğmesiyle), şu mesajlardan biriyle ödeme sayfasına döner: Moyasar'daki ödeme tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz., Moyasar ile yaptığınız ödeme reddedildi veya süresi doldu. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. ya da ödeme henüz kontrol edilemiyorsa, Moyasar ödemenizi henüz doğrulayamadık. Ödemeyi tamamladıysanız sipariş birkaç dakika içinde otomatik olarak güncellenecektir — lütfen tekrar ödeme yapmadan önce e-postanızı kontrol edin. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Sepet korunur.

Müşteri tekrar deneyebilir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme sürecinde bir siparişi tutar ve aynı siparişi yeniden öder. Eklenti önce aynı sepetin açık faturalarını kontrol eder: bu siparişin açık ödeme sayfası hâlâ aynı mod, tutar ve para birimine sahipse yeniden kullanılır; aksi halde eski fatura Moyasar'da iptal edilir ve yeni bir fatura oluşturulur, böylece eski fatura artık ödenemez. Sepetin önceki bir faturasının zaten ödenmiş olduğu anlaşılırsa, yeni bir ödeme oluşturmak yerine o ödeme onaylanır.

OpenCart 4, sipariş başarı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Bu sipariş ödeme yapılmadan kapatılmışsa (örneğin siz iptal ettiyseniz veya ödemesi başarısız olduysa), müşteri Your previous order was cancelled or its payment failed. Please confirm the order again. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişi öder. Ödenmiş, ardından iptal edilmiş veya iade edilmiş olan sepet siparişi artık sepeti tutmaz.

Moyasar ödemeyi başlatamazsa müşteri, düğmenin üstündeki kısa bir mesajla Confirm Order adımında kalır; örneğin Moyasar ödeme hizmeti yanıt vermiyor. Lütfen birkaç dakika içinde tekrar deneyin. ve başka bir ödeme yöntemi seçebilir. Ayrıntılar günlüğe yazılır.

Webhook ve fatura bildirimi, OpenCart 3 ödeme eklentisi isteklerine izin verdiği için mağaza bakım modundayken de çalışır; OpenCart 4'te ise eklenti bunlar için bir başlatma eylemi (startup action) ekler ve bu eylem müşterinin Moyasar'dan dönüşüne de izin verir.

Eklenti yalnızca Moyasar sayfasındaki tek seferlik ödemeleri kabul eder. Kendi ödeme sayfanızda kart formu, kayıtlı kart veya tokenizasyon, abonelik ve ayrı yetkilendirme ile tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Moyasar'a yönlendirildi ve ödeme yapmadı, Moyasar ödemeyi henüz onaylamadı ya da ödeme reddedildi, süresi doldu veya iptal edildi. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Status after payment (varsayılan İşleniyor): ödeme onaylandı. Bir not; ödemenin nasıl onaylandığını (webhook, fatura bildirimi, müşterinin dönüşü veya ödeme sayfası), fatura kimliğini, ödeme kimliğini ve ödeme yöntemini (örneğin kart markası ve son dört hane) gösterir.

Awaiting Moyasar payment status (varsayılan Beklemede): Moyasar ödemeyi inceleme için bekletir. Moyasar ödemeyi onayladığında sipariş Status after payment durumuna, ödeme başarısız olduğunda ise Payment error status durumuna geçer.

Moyasar payment on hold status (varsayılan Beklemede): Moyasar, sipariş toplamından farklı bir tutar veya para birimi bildirdi ya da fatura, siparişi iptal ettikten veya durumunu değiştirdikten sonra ödendi. Sipariş ödenmiş olarak işaretlenmez, ancak gerçekte tahsil edilen tutar iadeler için kaydedilir. Not bunu açıklar. Ödemeyi Moyasar Dashboard'da kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

Payment error status (varsayılan Başarısız): inceleme altındaki ödeme başarısız oldu.

Refunded status (varsayılan İade edildi): ödeme, eklenti üzerinden tamamen iade edildi.

Ödenmiş veya iade edilmiş bir sipariş, sonraki olaylarla asla geri değiştirilmez. Ödenmiş bir durumu zaten siz ayarladıysanız ödeme kaydedilir ve durum değişmez. Zaten ödenmiş bir sepetin ikinci faturası da (örneğin iki tarayıcı sekmesinden) ödenirse, ödenmiş sipariş değişmez. Bir not, mükerrer ödemeyi Moyasar Dashboard'da iade etmenizi ister.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Moyasar Payment Gateway sekmesi

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

İadeler

VibeFox Moyasar Payment Gateway sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Moyasar düğmesine tıklayın. Bu tutar Moyasar üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme izniniz olması gerekir (System > Users > User Groups bölümünde ayarlanır). İadeler, Moyasar'ın 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. 2 saatten daha kısa süre önce yapılmış bir kart ödemesinin tam iadesi, iptal (void) olarak gönderilir: tahsilat öncesi iptal, ücret yok. STC Pay ödemeleri ve diğer tüm durumlar iade edilir. İade, ödemenin yapıldığı modun (test veya canlı) gizli anahtarını kullanır; bu nedenle o anahtarın ayarlanmış olması gerekir. Eklenti önce Moyasar'da ödemenin para birimini, durumunu ve iade edilebilir tutarını kontrol eder. Moyasar iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade veya iptal, iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoğa geri koymadan Refunded status durumuna getirir; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, Moyasar ödemeyi onayladıktan sonra kullanılabilir.

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

Moyasar Dashboard'da yapılan iadeler ve iptaller webhook ile gelir. Moyasar, eklentinin kaydettiğinden daha fazla iade edilmiş tutar gösterirse siparişe bir not eklenir. Sipariş durumu otomatik olarak değişmez. Gerekirse Refund via Moyasar kullanmadan manuel olarak güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Moyasar Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Moyasar Payment 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 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, anahtarı bu mağazadan kaldırmak için Remove key. Altlarında Product: opencart-payment-moyasar 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 iznine sahip 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 belirtir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumuyla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır. 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 Moyasar, ö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 (unlicensed — visible to admins only) işaretiyle yine görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici panelindeki Dashboard üzerinde bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine onaylanır 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 panelindeki Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonra haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak, lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Moyasar ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun bir gizli anahtarı olduğunu kontrol edin: test modunda Test secret key, canlı modda Live secret key. Anahtar eksik olduğunda ayarlar sayfası bir uyarı gösterir. Müşteri SAR, AED, USD, EUR, KWD, BHD veya OMR ile ödeme yapmalıdır (mağazada seçili para birimi). 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.

Ödeme geçti ama sipariş durumsuz kaldı: onaylar mağazanıza ulaşmadı. Webhook'u yapılandırın: Moyasar Dashboard'da var olduğunu, URL'sinin ayarlardaki Webhook URL ile birebir aynı olduğunu, yöntemin POST olduğunu, dört olayın da seçili olduğunu ve paylaşılan gizli anahtarının Webhook shared secret alanına kaydedilenle aynı olduğunu kontrol edin. Sipariş, müşteri mağazaya döndüğünde veya aynı sepeti tekrar ödemeye çalıştığında da durumunu alır.

Webhook Unauthorized yanıtını veriyor: Moyasar'daki paylaşılan gizli anahtar, kayıtlı olandan farklı. Moyasar webhook'unun gizli anahtarını Webhook shared secret alanına yazın ve kaydedin ya da Generate a new secret seçeneğini işaretleyip kaydedin ve gösterilen anahtarı Moyasar'a yapıştırın.

Webhook Webhook secret not configured yanıtını veriyor: kayıtlı bir paylaşılan gizli anahtar yok; örneğin Clear the saved value on save ile silindikten sonra. Bir tane oluşturmak için Save düğmesine tıklayın ve Moyasar'a kopyalayın.

Webhook Key not configured yanıtını veriyor: fatura, gizli anahtarı boş olan bir modda (test veya canlı) oluşturulmuş. Bu anahtarı girin.

Webhook Verification failed veya Try again later yanıtını veriyor: fatura Moyasar API'sinden okunamadı, sepet aynı anda başka bir istek tarafından güncelleniyordu ya da sipariş durumu ayarlanamadı. Moyasar webhook'u yeniden deneyecektir. Nedeni görmek için Debug log seçeneğini açın.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Moyasar'dan gelen POST isteklerini kabul eder.

Anahtarla ilgili kaydetme hatası: bir yayımlanabilir anahtar (pk_...) ya da diğer modun bir anahtarı yapıştırılmış veya anahtar boşluk içeriyor. Önceki değer korunmuştur. Test anahtarları sk_test_, canlı anahtarlar sk_live_ ile başlar.

Müşteri Confirm Order sonrasında bir hata görüyor: Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. Bu ödeme yöntemi kullanılamıyor. mesajı, ödeme oturumunun artık siparişle eşleşmediği ya da bu arada ödeme yönteminin kapatıldığı anlamına gelir: müşteri ödeme sayfasını yeniden yükler. Bu ödeme yöntemi geçici olarak kullanılamıyor. Lütfen başka bir ödeme yöntemi seçin veya bizimle iletişime geçin. mesajı genellikle yanlış veya eksik bir gizli anahtara işaret eder. Bu sipariş için bir ödeme zaten alındı ve inceleniyor. Lütfen tekrar ödeme yapmak yerine bizimle iletişime geçin. mesajı, sepetin, sipariş durumu ayarlanamayan ödenmiş bir faturası olduğu anlamına gelir; günlüğü kontrol edin.

Sipariş, ödemeden sonra beklemeye alınmış durumda: VibeFox Moyasar Payment Gateway sekmesindeki Moyasar notes bölümünü okuyun. Ödenen tutar veya para birimi siparişten farklıydı ya da ödeme sipariş iptal edildikten sonra geldi. Siparişi yerine getirin veya ödemeyi iade edin.

Sekmede iade formu yok: sekme nedeni belirtir: ödeme henüz onaylanmamıştır, tamamen iade edilmiştir veya kullanıcı grubunuzun eklentiyi değiştirme izni yoktur.

İade başarısız oluyor: mesajı okuyun. Ödeme diğer modda yapıldıysa o modun gizli anahtarını girin. Tutar, Moyasar'da hâlâ iade edilebilir tutardan büyükse, ödemenin bir kısmı zaten iade edilmiştir, örneğin Moyasar Dashboard'da. Moyasar iade edilen tutarı onaylamadıysa, yeniden denemeden önce Moyasar Dashboard'da ödemeyi kontrol edin.

Geliştiriciler için: eklenti, desteklenen para birimlerini ve fatura verilerini değiştirmek üzere moyasar_p_supported_currencies ve moyasar_p_invoice_params OpenCart olaylarını tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Moyasar Payment Gateway yanındaki Uninstall düğmesine (kırmızı −) 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ılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve webhook'un bakım modundan geçmesini sağlayan başlatma eylemi de kaldırılır). Clean uninstall açıksa, diğer ağ geçidi ayarları (başlık, açıklama, test modu, anahtarlar, webhook paylaşılan gizli anahtarı, hata ayıklama günlüğü) ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Moyasar faturaları, ödemeleri ve iadeleri her zaman korunur; bu nedenle eski 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ırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesindeki VibeFox Moyasar Payment Gateway yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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