VibeFox Moyasar for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Daha eski bir WooCommerce sürümüyle eklenti bir bildirim gösterir ve yüklenmez.

PHP: 8.0 veya üzeri.

Para birimi: mağaza veya sipariş para birimi SAR, AED, USD, EUR, KWD, BHD veya OMR olmalıdır. Diğer 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ınlanabilir anahtara gerek yoktur. Moyasar Dashboard'da bir webhook kurulması ö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

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_moyasar_payment_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 > Moyasar > 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. Moyasar gizli anahtarlarınızı yapıştırın ve kaydedin. Moyasar Dashboard'da webhook'u, ayarlarda gösterilen URL ve paylaşılan gizli anahtar ile yapılandırın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın. Test modunda deneme siparişi verin, ardından Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Moyasar. Sayfa başlığında TEST MODE veya LIVE rozeti görünür. Alanların üstünde sayfa, geçerli modda gizli anahtar yoksa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) veya mağaza para birimi desteklenmiyorsa sizi uyarır; test modu açıkken Test mode is active: payments are simulated, no money is charged. ifadesini gösterir. Ödeme yöntemleri listesinde, geçerli modda gizli anahtar girilene kadar Moyasar kurulum gerektiren olarak işaretlenir. Kaydetme sırasında eklenti yayınlanabilir anahtarı, diğer moda ait bir anahtarı veya boşluk içeren bir anahtarı reddeder, önceki değeri korur ve nedenini gösterir. Ağ geçidi etkinken geçerli modun gizli anahtarı boşsa da uyarır.

Genel

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ı. Varsayılan: Pay with Moyasar.

Description: ödeme sayfası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 sayfası (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: Enable test mode test gizli anahtarını kullanır: ödemeler simüle edilir ve hiçbir tutar 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.

Ö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, tarayıcısını geri dönmeden kapatan müşterileri kapsar ve Moyasar Dashboard üzerinden yapılan iadeler hakkında bilgi verir. Moyasar Dashboard > Settings > Webhooks bölümünde, bu bölümdeki URL ve paylaşılan gizli anahtarla bir webhook ekleyin; HTTP yöntemi POST olmalıdır.

Webhook URL: salt okunur olarak, Copy düğmesiyle gösterilir. Şuna benzer: https://your-site/wp-json/moyasar_p/v1/webhook. HTTP yöntemi: POST.

Webhook shared secret: Moyasar'daki webhook'un Shared secret değeriyle aynı değeri girin. Alanı boş bırakıp kaydederek rastgele bir gizli anahtar oluşturun, ardından Show düğmesine tıklayıp Moyasar'a kopyalayın. Doğru paylaşılan gizli anahtarı olmayan webhook'lar reddedilir.

Webhook için şu olayları seçin:

Hiçbir webhook veya bildirim doğrudan güvenilmez: eklenti her biri için faturayı, siparişin modundaki gizli anahtarla Moyasar API'sinden okur ve faturanın bu sipariş için oluşturulduğunu doğrular. Aynı Moyasar hesabındaki diğer entegrasyonların ödemeleri yok sayılır.

Siparişler

Status after payment: onaylanmış bir ödemeden sonra siparişin alacağı durum. Durum ikinci bir durum değişikliği olmadan hemen ayarlanır.

Gelişmiş

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

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Siparişlerde saklanan ödeme bilgileri (Moyasar fatura ve ödeme kimlikleri) korunur, böylece iadeler izlenebilir kalır. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Pay with Moyasar) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde bir Moyasar faturası oluşturur ve müşteriyi ödeme sayfasına gönderir. Orada müşteri, Moyasar hesabınızda etkin olan herhangi bir yöntemle, örneğin mada, Visa, Mastercard, Apple Pay veya STC Pay ile öder. Fatura Order, sipariş numarasını ve site adınızı gösterir.

Sipariş, yalnızca Moyasar onayladıktan sonra ödenmiş olarak işaretlenir: eklenti faturayı Moyasar API'sinden okur ve ödendiğini, bu siparişe ait olduğunu ve tam sipariş tutarı ile para birimine sahip olduğunu doğrular. Ödemeden sonra müşteri, mağazanızın sipariş alındı sayfasına döner. Müşteri ödeme yapmadan geri dönerse (örneğin ödeme sayfasının geri düğmesiyle), şu mesajlardan biriyle ödeme sayfasına veya Pay for order sayfası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.

Müşteri ödenmemiş bir siparişi yeniden ödeyebilir. Siparişin hâlâ açık olan ödeme sayfası aynı tutar ve para birimine sahipse yeniden kullanılır. Sipariş toplamı değiştiyse eski ödeme sayfası iptal edilir ve yenisi oluşturulur, böylece eskisi artık ödenemez. Önceki fatura zaten ödenmişse yeni bir ödeme oluşturmak yerine sipariş onaylanır.

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

Ö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 tek seferlik ödemeleri yalnızca Moyasar sayfasında kabul eder. Kendi ödeme sayfanızda kart formu, kayıtlı kart veya tokenizasyon, WooCommerce Subscriptions ve ayrı yetkilendirme ile tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: fatura oluşturuldu ve müşteri henüz ödeme yapmadı. Sipariş notunda fatura kimliği, tutar ve mod gösterilir.

Processing, Completed or On hold: ödeme onaylandı. Durum Status after payment ayarını izler. Sipariş notunda ödemenin nasıl onaylandığı (webhook, fatura bildirimi, müşterinin geri dönüşü veya ödeme sayfası), fatura kimliği, ödeme kimliği ve ödeme yöntemi gösterilir. İşlem kimliği, Moyasar ödeme kimliğidir.

On hold after payment: Moyasar, sipariş toplamından farklı bir tutar veya para birimi bildirdi (sipariş ödenmiş olarak işaretlenmez) ya da fatura, sipariş iptal edildikten sonra ödendi. Sipariş notu bunu açıklar. Ödemeyi Moyasar Dashboard'da kontrol edin ve siparişi tamamlayın ya da ödemeyi iade edin.

On hold before payment: Moyasar ödemeyi inceleme için tutuyor. Moyasar karar verdiğinde sipariş güncellenir.

Failed: ödenmemiş bir siparişin son faturası reddedildi, süresi doldu veya iptal edildi. Müşteri yeniden ödemeyi deneyebilir.

Cancelled: sipariş müşteri, siz veya WooCommerce stok tutma zaman aşımı tarafından iptal edildi. Siparişin açık Moyasar faturası da iptal edilir, böylece artık ödenemez.

Ödenmiş, iptal edilmiş veya iade edilmiş bir sipariş, sonraki olaylarla asla değiştirilmez. Zaten ödenmiş bir siparişin ikinci faturası ödenirse (örneğin iki tarayıcı sekmesinden), sipariş yeniden değiştirilmez. Bir not, yinelenen ödemeyi Moyasar Dashboard üzerinden iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Pay with Moyasar düğmesine tıklayın (düğme ödeme yönteminin başlığını kullanır). Moyasar ödemesi olan siparişler için tam ve kısmi iadeler desteklenir. 2 saatten daha kısa süre önce yapılan bir kart ödemesinin tam iadesi, iptal (void, mutabakattan önce iptal) olarak gönderilir; aksi hâlde iade olarak işlenir. İade, ödemenin yapıldığı modun (test veya canlı) gizli anahtarını kullanır, bu nedenle o anahtar ayarlanmış olmalıdır. İadeden önce eklenti ödemeyi Moyasar'da kontrol eder: para birimini, durumunu ve hâlâ iade edilebilir tutarı. Moyasar iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade veya iptal, sipariş notlarına eklenir.

Moyasar Dashboard üzerinden yapılan iadeler ve iptaller webhook ile gelir. Moyasar, WooCommerce'den daha fazla iade edilmiş tutar gösterirse siparişe bir not eklenir. Bunlar otomatik olarak WooCommerce iadesi olarak kaydedilmez. Gerekirse Refund via Pay with Moyasar 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 > Moyasar 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 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. 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

Moyasar ö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 gizli anahtar bulunduğunu (test modunda Test secret key, canlı modda Live secret key) ve mağaza veya sipariş para biriminin SAR, AED, USD, EUR, KWD, BHD veya OMR olduğunu kontrol edin. Anahtar eksikse veya para birimi desteklenmiyorsa ayarlar sayfasında bir uyarı görünür.

Ödeme yapıldı ancak sipariş Pending payment durumunda kalıyor: onaylar mağazanıza ulaşmadı. Webhook'u kurun: Moyasar Dashboard'da webhook'un var olduğunu, URL'sinin ayarlardaki Webhook URL ile birebir aynı olduğunu, yönteminin POST olduğunu, dört olayın da seçili olduğunu ve paylaşılan gizli anahtarının Webhook shared secret ile aynı olduğunu kontrol edin. Sipariş ayrıca müşteri mağazaya döndüğünde ve aynı siparişi yeniden ödemeye çalıştığında da onaylanır.

Webhook Unauthorized yanıtı veriyor: Moyasar'daki paylaşılan gizli anahtar, Webhook shared secret değerinden farklı. Show düğmesine tıklayın, değeri kopyalayın ve Moyasar'daki webhook'a yapıştırın.

Webhook Webhook secret not configured yanıtı veriyor: ayarlar henüz paylaşılan bir gizli anahtarla kaydedilmedi. Bir anahtar oluşturmak için ayarları kaydedin ve Moyasar'a kopyalayın.

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

Webhook Verification failed veya Try again later yanıtı veriyor: fatura Moyasar API'sinden okunamadı ya da sipariş aynı anda başka bir istek tarafından güncelleniyordu. Moyasar webhook'u yeniden dener.

Anahtarla ilgili kaydetme hatası: yayınlanabilir bir anahtar (pk_...) veya diğer moda ait bir anahtar yapıştırıldı. Önceki değer korundu. Test anahtarları sk_test_, canlı anahtarlar sk_live_ ile başlar.

Müşteri siparişi verirken bir hata görüyor: Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümüne, kaynak wcp_moyasar_payment_gateway olarak 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 siparişin incelemenizi gerektiren ödenmiş bir faturası olduğu anlamına gelir.

Sipariş On hold after payment durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı ya da ödeme sipariş iptal edildikten 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.

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ı ve günlükler yalnızca Clean 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.

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