VibeFox Flutterwave for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri. Eski PHP sürümlerinde eklenti etkinleştirilemez.

Flutterwave hesabı: Flutterwave panelindeki Settings, API keys bölümünden hesabınızın gizli anahtarları gerekir: test modu için FLWSECK_TEST-… ve canlı mod için FLWSECK-…. Yalnızca gizli anahtarlar kullanılır. Genel ve şifreleme anahtarları gerekmez. Ayrıca seçtiğiniz bir gizli hash ile webhook kurmalısınız (bkz. Yapılandırma).

Para birimleri: sipariş her zaman siparişin para biriminde tahsil edilir. Eklenti ülke veya para birimi kısıtlamaz; hesabınız para birimini desteklemiyorsa Flutterwave hata gösterir.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yoluna gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_flutterwave_payment 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 > Flutterwave > Manage; ya da Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Gizli anahtarlarınızı girin, Flutterwave panelinde webhook'u kurun ve aynı gizli hash değerini eklentiye girin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini etkinleştirin, test modunda bir ödeme deneyin, ardından Live mode seçeneğini işaretleyin.

Yapılandırma

Tüm ayarlar tek sayfadadır: WooCommerce > Settings > Payments > Flutterwave. Alanların üstünde Live mode: real payments are accepted. veya Test mode: no real money is charged. gösterilir. Geçerli modun gizli anahtarı boşsa, canlı modda canlı anahtar alanında bir test anahtarı (FLWSECK_TEST-…) varsa ya da test modunda test anahtarı alanında bir canlı anahtar (FLWSECK-…) varsa uyarı verilir; sorun giderilene kadar ödeme yöntemi ödeme sayfasında gizlenir. Webhook gizli hash değeri ayarlanmadığında da uyarı verilir: webhook'lar reddedilir ve ödemeler yalnızca müşteri mağazanıza döndüğünde onaylanır. Ödeme yöntemleri listesinde Flutterwave, geçerli modda gizli anahtar bulunana kadar kurulum gerektiriyor olarak işaretlenir ve test modunda test modu rozeti gösterir.

Genel

Enable/Disable: Enable Flutterwave Payment ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterilerin ödeme sırasında gördüğü ödeme yöntemi başlığı. Varsayılan: Flutterwave.

Description: müşterilerin ödeme sırasında gördüğü metin. Varsayılan: Pay securely via Card, Bank Transfer, USSD, Mobile Money via Flutterwave.

API anahtarları

Flutterwave panelindeki Settings, API keys bölümünden gizli anahtarları kopyalayın. Test modu ve canlı mod farklı anahtarlar kullanır.

Live mode: Accept real payments (uncheck for test mode). Test modu test gizli anahtarını kullanır ve gerçek para tahsil edilmez. Canlı mod canlı gizli anahtarını kullanır. Varsayılan: off (test modu).

Test Secret Key: Flutterwave test gizli anahtarınız (FLWSECK_TEST-...).

Live Secret Key: Flutterwave canlı gizli anahtarınız (FLWSECK-...).

Webhook

Webhook, müşteri mağazanıza dönmese bile ödemeleri onaylar. Flutterwave panelindeki Settings, Webhooks bölümünde hem test hem canlı modda bu bölümde gösterilen Webhook URL değerini ve seçtiğiniz bir gizli hash değerini girin. URL şu biçimdedir: https://your-site/wc-api/flw_p_webhook/. Eklenti şu olaya tepki verir:

Diğer olaylar yok sayılır.

Secret Hash: webhook'un gizli hash değeri. Flutterwave panelinizin webhook ayarlarındaki değerle eşleşmelidir. Flutterwave bunu her webhook ile gönderir. Geçerli gizli hash içermeyen webhook'lar reddedilir. Webhook olmadan ödeme yalnızca müşteri mağazanıza döndüğünde onaylanır.

Ödeme

Payment Options: Flutterwave sayfasında gösterilecek, virgülle ayrılmış ödeme yöntemleri; örneğin card, banktransfer, ussd, mobilemoney. Hesabınızda etkin tüm yöntemler için boş bırakın. Liste kaydedilirken temizlenir.

Autocomplete Orders: Automatically mark orders as completed after successful payment. Etkinse, ödeme sonrasında siparişler tek durum değişikliğiyle İşleniyor yerine Tamamlandı durumuna geçirilir. Varsayılan: off.

Gelişmiş

Debug log: Log Flutterwave API events for debugging, WooCommerce > Status > Logs konumuna, wcp_flutterwave_payment kaynağıyla kaydedilir. Hatalar her zaman günlüğe kaydedilir. Anahtarlar ve müşteri verileri asla kaydedilmez. Varsayılan: off.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlere kaydedilen ödeme verileri her zaman korunur. Varsayılan: off.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Flutterwave) ve siparişi verir. Test modunda ödeme sayfası TEST MODE - no real payments will be processed. gösterir. Geçerli bir fatura e-postası gereklidir. Eklenti, sipariş toplamı için siparişin para biriminde; müşterinin e-postası, telefonu ve adı, sitenizin adı ve logosuyla bir Flutterwave ödemesi oluşturur ve müşteriyi Flutterwave ödeme sayfasına yönlendirir. Müşteri orada hesabınızda etkin olan (veya Payment Options alanında listelenen) yöntemlerden biriyle ödeme yapar.

Ödeme sonrasında müşteri mağazanıza döner. Sipariş yalnızca Flutterwave onayladıktan sonra ödenmiş olarak işaretlenir: webhook ile veya müşteri döndüğünde sunucu tarafındaki kontrolle. Ödeme henüz onaylanmadıysa, örneğin bekleyen bir banka havalesi, USSD veya mobil para ödemesiyse, sipariş alındı sayfası Your payment is being confirmed by Flutterwave. You will receive an e-mail as soon as it is confirmed. gösterir. Para geldiyse ancak eklenti, örneğin ödenen tutar siparişle eşleşmediği için siparişi incelemeye almak üzere Beklemede durumuna geçirdiyse sayfa Your payment was received and your order is being reviewed. We will contact you if anything is needed. gösterir.

Ödeme reddedilirse müşteri ödeme sayfasına (veya Pay for order sayfasına) döner ve Your payment was declined. You can try again or choose another payment method. görür. Müşteri Flutterwave sayfasında iptal ederse ödeme sayfasında verilen sipariş iptal edilir, elle oluşturulan sipariş ödenmemiş kalır ve Payment was cancelled. You can try again or choose another payment method. mesajı gösterilir. Ödeme tamamlanmadıysa mesaj The payment was not completed. You can try again or choose another payment method. olur.

Müşteri ödenmemiş bir siparişi yeniden ödemeyi deneyebilir. Her denemenin kendi referansı vardır ve daha sonra ödenen eski bir bağlantı da kabul edilir. Flutterwave ödemeyi başlatamazsa müşteri kısa bir mesaj görür; örneğin Flutterwave is temporarily unavailable. Please try again in a moment or choose another payment method.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur. Müşteriye gösterilen metinler Fransızcaya çevrilmiştir.

Eklenti yalnızca tek seferlik ödemeler alır. Sitenizde gömülü veya modal ödeme, kayıtlı kartlar, abonelikler, bölünmüş ödemeler ya da ödeme planları yoktur. Barındırılan ödeme bağlantıları Flutterwave API üzerinden iptal edilemez; bu nedenle siparişin eski bir bağlantısı hâlâ ödenebilir.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Flutterwave'e yönlendirildi ve henüz ödeme yapmadı veya ödeme Flutterwave'de hâlâ bekliyor.

Processing or Completed: ödeme onaylandı. Autocomplete Orders açıkken Tamamlandı kullanılır (yalnızca sanal indirilebilir ürünler içeren siparişler de WooCommerce'in varsayılan davranışıyla Tamamlandı olur). Sipariş notunda tutar, ödeme yöntemi, Flutterwave referansı, işlem ve mod gösterilir. Siparişin işlem kimliği Flutterwave referansıdır.

On hold after payment: doğrulanan tutar veya para birimi siparişle eşleşmedi ya da ödeme sipariş iptal edildikten sonra geldi. Notta açıklama bulunur. Siparişi yerine getirin veya ödemeyi iade edin. Tekrarlanan bir webhook, iade edilmiş veya iptal edilmiş siparişi asla yeniden açmaz.

Failed: Flutterwave, bekleyen siparişin son ödeme denemesini başarısız veya iptal edilmiş olarak bildirdi. Notta neden gösterilir.

Cancelled: müşteri ödeme sayfasında sipariş verdikten sonra Flutterwave sayfasında iptal etti ya da sipariş sizin tarafınızdan veya WooCommerce stok bekletme süresi dolduğu için iptal edildi.

Zaten ödenmiş bir sipariş için ikinci ödeme alınırsa sipariş değiştirilmez. Bir not, yinelenen ödemeyi Flutterwave panelinden iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Flutterwave düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı modun (test veya canlı) gizli anahtarıyla gönderilir; bu anahtar ayarlanmış olmalıdır. Flutterwave iadeyi reddederse WooCommerce hatayı gösterir ve iade kaydedilmez. Başarılı iade, iade kimliği ve durumuyla sipariş notlarına eklenir (tamamlanmış veya Flutterwave'in bildirdiği durumla başlatılmış).

Flutterwave panelinde yapılan iadeler WooCommerce'e aktarılmaz. Gerekirse WooCommerce'de Refund via Flutterwave kullanmadan elle iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Flutterwave sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölümde durum, örneğin lisansın geçerli olduğu son tarih ve alan adınız gösterilir. Durumu yeniden kontrol etmek için Check now, başka anahtar girmek için Change key, bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı siteden kaldırmak alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin anahtar olmadan Flutterwave, ödeme sayfasında müşterilere gösterilmez. Yine de ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. görür. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler ve WooCommerce sayfalarında hatırlatma gösterilir. Mevcut siparişler etkilenmez: başlamış ödemeler onaylanmaya devam eder ve iadeler çalışır.

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

Flutterwave ö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 gizli anahtarının girildiğini ve moda uyduğunu kontrol edin: test modunda test anahtarı (FLWSECK_TEST-…), canlı modda canlı anahtar (FLWSECK-…). Aksi hâlde ayarlar sayfası uyarı gösterir.

Ödeme gerçekleşti ancak sipariş Pending payment durumunda kalıyor: webhook çalışmıyor. Flutterwave panelinde kullandığınız modda (test veya canlı) webhook URL'sinin ayarlarda gösterilenle birebir aynı olduğunu ve gizli hash değerinin eklentideki Secret Hash ile eşleştiğini kontrol edin. Bekleyen banka havalesi, USSD ve mobil para ödemeleri Flutterwave onaylayana kadar bekler. Debug log seçeneğini açın ve WooCommerce > Status > Logs konumunda wcp_flutterwave_payment kaynağına bakın.

Webhook, Invalid hash veya Secret hash not configured yanıtı veriyor: Flutterwave panelindeki gizli hash eklentidekinden farklı veya eklentide yok. İki yere de aynı değeri girin.

Webhook, Verification failed veya Busy, retry later yanıtı veriyor: ödemeyi doğrulamak için Flutterwave'e ulaşılamadı, işlem henüz görünür değil veya sipariş başka bir istekle güncelleniyordu. Flutterwave webhook'u yeniden dener.

Müşteri Payment gateway is not properly configured görüyor: geçerli modun gizli anahtarı eksik veya diğer moda ait.

Müşteri We could not match this payment to an order görüyor: dönüş bağlantısı bu mağazanın oluşturmadığı bir referans içeriyor. Müşteriden tahsilat yapıldıysa ödemeyi Flutterwave panelinde bulun.

Flutterwave kendi sayfasında hata gösteriyor: Flutterwave hesabınız siparişin para birimini veya seçilen ödeme seçeneklerini desteklemiyor olabilir.

Ödemeden sonra sipariş On hold durumunda: sipariş notunu okuyun. Doğrulanan tutar veya para birimi siparişle eşleşmedi ya da ödeme sipariş iptal edildikten sonra geldi. Siparişi yerine getirin veya ödemeyi iade edin.

İade, modla ilgili mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o modun gizli anahtarı yapılandırılmamış. Anahtarı girin ve yeniden deneyin.

Lisans bölümü hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında kullanılıyorsa vibefox.net hesabınızdan bir alan adı hakkını serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Geliştiriciler için eklenti belgelerinde flw_p_payment_request (Flutterwave'e gönderilen veriler), flw_p_currency_decimals (para birimi hassasiyeti) ve flw_p_icon (ödeme simgesi) filtreleri listelenir.

Kaldırma

Eklenti devre dışı bırakıldığında tüm veriler korunur. Kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi hâlde daha sonra yeniden kurulum için tutulur. Siparişlerde kayıtlı Flutterwave verileri her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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