VibeFox Moyasar for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

Para birimi: sepetin para birimi SAR, AED, USD, EUR, KWD, BHD veya OMR olmalıdır. Diğer tüm para birimleri için ödeme yöntemi ödeme adımı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 anahtar gerekmez. Moyasar Dashboard'da bir webhook önerilir (bkz. Yapılandırma).

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

Kurulum

1. Yönetici panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Moyasar Payment Gateway modülünü bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üst kısmındaki lisans bloğundaki License key alanına girin 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. Moyasar Dashboard'da webhook'u ayarlayı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 verin, ardından Test mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Moyasar payment ve Moyasar payment on hold. PrestaShop, tüm para birimleri, ülkeleri ve müşteri gruplarını kapsayan yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünde sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Moyasar Payment Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, geçerli modun gizli anahtarı yoksa (bu durumda ödeme yöntemi ödeme adımında gizlenir), kayıtlı bir webhook paylaşılan sırrı yoksa (bu durumda webhook her çağrıyı reddeder) ya da mağazanın varsayılan para birimi desteklenmiyorsa sizi uyarır. Modül test modunda etkinken Test mode is active: payments are simulated, no money is charged. mesajını gösterir. Kaydederken modül, yayımlanabilir bir anahtarı, diğer moddaki bir anahtarı veya boşluk içeren bir anahtarı reddeder, önceki değeri korur ve nedenini gösterir.

Moyasar

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

Title: müşterinin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Pay with Moyasar. Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen 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 ödeme adımı (Test mode: no real payment is made.) ifadesini ekler.

API anahtarları

Gizli anahtarları Moyasar Dashboard > Settings > API Keys bölümünden kopyalayın. 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 hiçbir para tahsil edilmez. Varsayılan: açık. Gerçek ödemeleri canlı gizli anahtarla kabul etmek için kapatın.

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

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

Kayıtlı anahtarlar ve sırlar bir daha 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.

Ödeme bildirimleri (webhook)

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

Webhook URL: salt okunur olarak, Copy düğmesiyle birlikte gösterilir. Dostça URL'ler etkinse şöyle görünür: https://your-shop/module/wcp_moyasar_payment_gateway/webhook; sonunda /en/ gibi bir dil kodu da olabilir. URL'yi ayarların gösterdiği biçimde tam olarak kopyalayın. HTTP yöntemi: POST.

Webhook shared secret: Moyasar'daki webhook'un Shared secret değerinin aynısını girin. Kayıtlı bir değer yoksa Save rastgele bir sır üretir; Generate a new secret kayıtlı olanı değiştirir. Üretilen sır, kaydettikten sonra ayarların üstünde yalnızca bir kez gösterilir ve bir daha gösterilmez; bu yüzden hemen Moyasar'a kopyalayın. Doğru paylaşılan sır olmayan webhook'lar reddedilir.

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

Bir webhook veya bildirimdeki hiçbir veriye doğrudan güvenilmez: her biri için modül, faturayı oluşturulduğu modun gizli anahtarıyla Moyasar API'sinden okur ve faturanın bu sepet için oluşturulduğunu doğrular. Aynı Moyasar hesabındaki diğer entegrasyonların ödemeleri yok sayılır. Tek bir paylaşılan sır her iki mod için de kullanılır.

Siparişler

Status after payment: onaylanmış bir ödemeden sonra ayarlanan sipariş durumu. Sipariş doğrudan bu durumda oluşturulur.

Gelişmiş

Clear saved secrets: kaldırmak için Test secret key, Live secret key veya Webhook shared secret seçeneğini işaretleyin ve Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Debug log: API çağrılarını ve bildirimleri modül klasöründeki logs/moyasar_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. 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 modül kaldırıldığında modül ayarları ve günlük silinir. Siparişlerle birlikte saklanan ödeme bilgileri (Moyasar fatura ve ödeme kimlikleri) korunur, böylece iadeler izlenebilir kalır. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Pay with Moyasar) ve onaylar. Modül, sepet tutarı için sepet para biriminde bir Moyasar faturası oluşturur ve müşteriyi bu faturanın ödeme sayfasına gönderir. Müşteri orada Moyasar hesabınızda etkin olan herhangi bir yöntemle öder. Fatura Order #, sepet numarasını ve mağazanızın adını gösterir. Bu noktada henüz bir sipariş yoktur.

Sipariş yalnızca Moyasar ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: modül faturayı Moyasar API'sinden okur ve ödendiğini, bu sepete ait olduğunu ve tam sepet tutarında ve para biriminde olduğunu doğrular. Ardından sipariş oluşturulur ve müşteri Your payment with Moyasar has been received. mesajıyla standart sipariş onay sayfasını görür. Moyasar ödemeyi inceleme için tutarsa sayfa Your payment is being reviewed by Moyasar. The order will be updated automatically when Moyasar confirms it — please do not pay again. mesajını gösterir. Sipariş sizin incelemeniz için beklemeye alındıysa sayfa ödemenin alındığını ve siparişin incelendiğini belirtir. İncelenen bir ödeme daha sonra başarısız olursa veya ödenmemiş sipariş iptal edilirse sayfa Your Moyasar payment was not completed. Please contact us about this order. mesajını gösterir.

Müşteri ödeme yapmadan geri dönerse (örneğin ödeme sayfasındaki geri düğmesiyle), şu mesajlardan biriyle ödeme adımına döner: The payment at Moyasar was not completed. You can try again or choose another payment method., Your Moyasar payment was declined or has expired. Please try again or choose another payment method. veya ödeme henüz doğrulanamıyorsa We could not confirm your payment with Moyasar yet. If you completed the payment, the order will be updated automatically in a few minutes — please check your e-mail before paying again. Sepet korunur.

Müşteri yeniden deneyebilir. Sepetin açık ödeme sayfasında hâlâ aynı tutar ve para birimi varsa yeniden kullanılır. Sepet toplamı değiştiyse eski ödeme sayfası Moyasar'da iptal edilir ve yenisi oluşturulur; böylece eskisi artık ödenemez. Önceki fatura zaten ödenmiş çıkarsa, yeni bir ödeme yerine sipariş oluşturulur.

Moyasar ödemeyi başlatamazsa müşteri ödeme adımında kısa bir mesajla kalır, örneğin The Moyasar payment service is not responding. Please try again in a few minutes., ve başka bir ödeme yöntemi seçebilir. Ayrıntılar günlüğe yazılır.

Webhook ve fatura bildirimi, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modül yalnızca Moyasar sayfasında tek seferlik ödemeleri kabul eder. Kendi ödeme sayfanızda kart formu, kayıtlı kartlar veya tokenizasyon, abonelikler ve ayrı yetkilendirme ile tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri Moyasar'a yönlendirildi ve henüz ödeme yapmadı ya da Moyasar ödemeyi henüz onaylamadı. Yalnızca sepet mevcuttur.

Payment accepted, Delivered veya Moyasar payment on hold: ödeme onaylandı. Durum, Status after payment ayarını izler. Ödeme, işlem kimliği olarak Moyasar ödeme kimliğiyle kaydedilir; bir not ödemenin nasıl onaylandığını (webhook, fatura bildirimi, müşterinin geri dönüşü veya ödeme sayfası), fatura kimliğini, ödeme kimliğini ve ödeme yöntemini gösterir.

Awaiting Moyasar payment: Moyasar ödemeyi inceleme için tutuyor. Moyasar ödemeyi onayladığında sipariş ödenmiş duruma geçer.

Ödeme hatası: incelenen ödeme başarısız oldu.

Moyasar payment on hold after payment: Moyasar, sepet toplamından farklı bir tutar veya para birimi bildirdi (örneğin ödeme başladıktan sonra sepet başka bir sekmede değiştirildi) ya da siparişi iptal ettikten sonra fatura ödendi. Sipariş ödenmiş olarak işaretlenmez, ancak gerçekte alınan tutar sipariş para biriminde olduğunda kaydedilir. Not bunu açıklar. Ödemeyi Moyasar Dashboard'da kontrol edin ve siparişi tamamlayın ya da ödemeyi iade edin.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Ödenmiş bir sipariş, sonradan gelen olaylarla asla geri alınmaz. Zaten ödenmiş bir sepetin ikinci faturası da ödenirse (örneğin iki tarayıcı sekmesinden), sipariş değişmez. Bir not, mükerrer ödemeyi Moyasar Dashboard'da iade etmenizi ister.

Moyasar ödeme bloğu

Sipariş sayfasında Moyasar fatura kimliği, ödeme kimliği, yöntem (örneğin kart markası ve son dört hane), durum, ödenen ve iade edilen tutarlar, test ödemeleri için bir Test mode rozeti, iade geçmişi ve siparişin Moyasar notes bölümünü gösteren bir Moyasar payment bloğu bulunur.

İadeler

Moyasar payment bloğunda tutarı girin (henüz iade edilmeyen tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Moyasar düğmesine tıklayın. Refund this amount through Moyasar? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir; Modüller sayfalarına erişim gerekmez. İadeler, Moyasar'ın tahsil ettiği tutar ve para biriminde yapılır; bu yüzden bir 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ılan kart ödemesinin tam iadesi iptal (void) olarak gönderilir: tahsilattan önce iptal, ücret yok. Aksi halde bir iade yapılır. İade, ödemenin yapıldığı modun (test veya canlı) gizli anahtarını kullanır; bu nedenle o anahtarın ayarlanmış olması gerekir. Modül önce Moyasar'da ödemenin para birimini, durumunu ve iade edilebilir tutarını kontrol eder. Moyasar iadeyi kabul etmezse blok 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 Refunded durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, Moyasar ödemeyi onayladıktan sonra kullanılabilir.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Moyasar üzerinden para göndermez.

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

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Moyasar Payment Gateway lisans bloğu, Modules > Module Manager > VibeFox Moyasar Payment Gateway > Configure sayfasında, ayarların üstünde ilk bloktur. Anahtarı License key alanına girin 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 Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-moyasar satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir, örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da aynı şekilde. 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 olmadan Moyasar, ödeme adımı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. PrestaShop vitrini, yönetim paneline giriş yaptığınızı bilmez; bu yüzden ödeme yöntemi sizin için de gizlenir: modülü lisans satın almadan önce yapılandırabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma çıkar. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Lisans süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Moyasar ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun bir gizli anahtarı bulunduğunu (test modunda Test secret key, canlı modda Live secret key) ve sepet para biriminin SAR, AED, USD, EUR, KWD, BHD veya OMR olduğunu kontrol edin. Anahtar eksikse ya da mağaza para birimi desteklenmiyorsa ayarlar sayfası bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme yapıldı ama sipariş oluşturulmadı: onaylar mağazanıza ulaşmadı. Webhook'u ayarlayın: Moyasar Dashboard'da webhook'un var olduğunu, URL'sinin ayarlardaki Webhook URL ile tam olarak aynı olduğunu, yönteminin POST olduğunu, dört olayın seçili olduğunu ve paylaşılan sırrının Webhook shared secret alanına kaydedilenle aynı olduğunu kontrol edin. Müşteri mağazaya döndüğünde veya aynı sepeti yeniden ödemeye çalıştığında da sipariş oluşturulur.

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

Webhook Webhook secret not configured yanıtı veriyor: kayıtlı bir paylaşılan sır yok; örneğin Clear saved secrets ile kaldırıldıktan sonra. Bir sır üretmek için Save düğmesine tıklayın ve Moyasar'a kopyalayın.

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

Webhook Verification failed veya Try again later yanıtı veriyor: fatura Moyasar API'sinden okunamadı, sepet aynı anda başka bir istek tarafından güncelleniyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). Moyasar webhook'u yeniden dener. 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ı: yayımlanabilir bir anahtar (pk_...) veya diğer moda ait bir anahtar yapıştırıldı ya da anahtar boşluk içeriyor. Önceki değer korundu. Test anahtarları sk_test_, canlı anahtarlar sk_live_ ile başlar.

Müşteri Moyasar'ı seçerken bir hata görüyor: Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın. This payment method is temporarily unavailable. Please choose another payment method or contact us. genellikle yanlış veya eksik bir gizli anahtar anlamına gelir. A payment for this order has already been received and is being reviewed. Please contact us instead of paying again. ise sepetin siparişe dönüştürülemeyen ödenmiş bir faturası olduğu anlamına gelir; günlüğü kontrol edin.

Order is Moyasar payment on hold after payment: Moyasar payment bloğundaki Moyasar notes bölümünü okuyun. Ödenen tutar veya para birimi sepetten farklıydı ya da ödeme siparişin iptalinden sonra geldi. Siparişi tamamlayın veya ödemeyi iade edin.

İ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 üzerinden. Moyasar iade edilen tutarı onaylamadıysa tekrar denemeden önce ödemeyi Moyasar Dashboard'da kontrol edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Moyasar Payment Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Clean uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Moyasar faturaları, ödemeleri ve iadeleri ile Awaiting Moyasar payment ve Moyasar payment on hold sipariş durumları her zaman saklanır; böylece eski siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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