VibeFox Flow for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Şili pesosu (CLP) veya ABD doları (USD). Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. CLP mağazalarında WooCommerce > Settings > General > Number of decimals değerini 0 yapın; Flow tam peso tahsil eder.

Flow hesabı: Flow hesabınızın, Flow'da Mis datos, Datos técnicos altında bulunan API Key ve Secret Key bilgileri gerekir. Testler için sandbox.flow.cl üzerinde ayrı bir test hesabı oluşturun ve onun anahtarlarını kullanın. Test ve canlı anahtarlar farklıdır. Flow hesabında yapılandırma gerekmez.

Herkese açık web sitesi: mağazanızın onay, dönüş ve iade URL'lerine internetten erişilebilmelidir; bakım modu, parola koruması veya Flow'u engelleyen güvenlik duvarı bulunmamalıdır.

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. Ayrıca wcp_flow_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Flow.cl > Manage veya Eklentiler 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. Test API Key ve Secret Key bilgilerini girin, Enable / Disable seçeneğini açın, kaydedin ve bir test siparişi verin.

6. Gerçek ödemeleri kabul etmek için canlı anahtarları doldurun ve Sandbox mode işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek sayfadadır: WooCommerce > Settings > Payments > Flow.cl. Sayfa, alanların üzerinde mevcut modun anahtarları boşsa (Flow ödeme sayfasında gizlenir), mağazanın para birimi desteklenmiyorsa ve CLP mağazası ondalık basamak kullanıyorsa sizi uyarır (Flow tam peso tahsil eder; fiyatların, toplamların ve iadelerin tam eşleşmesi için Number of decimals değerini 0 yapın). Test modunda Sandbox mode gösterilir — ödemeler sandbox.flow.cl adresine gider, gerçek para tahsil edilmez. Ödeme yöntemleri listesinde Flow, mevcut modun anahtarları girilene kadar kurulum gerektiriyor olarak işaretlenir ve test modunda bir test rozeti gösterir.

Genel

Enable / Disable: Enable Flow.cl payments ö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: Flow.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.

Flow API kimlik bilgileri

Flow hesabınızdan API Key ve Secret Key bilgilerini kopyalayın (Mis datos, Datos técnicos): canlı anahtarlar www.flow.cl, test anahtarları sandbox.flow.cl üzerindedir (ayrı test hesabı).

Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys. Test modunda gerçek para tahsil edilmez. Varsayılan: açık. Gerçek ödeme kabul etmek için kapatın ve canlı anahtarları doldurun. İadeler her zaman siparişin ödendiği ortamı kullanır.

Sandbox API Key: sandbox.flow.cl hesabınızın API Key bilgisi.

Sandbox Secret Key: sandbox.flow.cl hesabınızın Secret Key bilgisi. Her isteği imzalamak için kullanılır.

Live API Key: www.flow.cl hesabınızın API Key bilgisi.

Live Secret Key: www.flow.cl hesabınızın Secret Key bilgisi. Gizli tutun.

Bildirimler

Eklenti, her ödeme ve iadeyle Flow'a üç URL gönderir; Flow hesabında yapılandırma gerekmez. Bu bölüm URL'leri listeler:

Onay yalnızca bir ödeme jetonu taşır. Eklenti daha sonra ödemenin oluşturulduğu ortamda imzalı bir istekle Flow'dan ödeme durumunu sorar ve yalnızca Flow'un yanıtını uygular. Bu mağazanın sipariş için oluşturmadığı bir ödeme reddedilir. Onay gelmezse müşteri Flow'dan döndüğünde sipariş güncellenir.

Gelişmiş

Debug log: Log API calls and notifications, WooCommerce > Status > Logs altında, wcp_flow_gateway kaynağıyla, anahtar veya müşteri verisi olmadan kaydedilir. Hatalar her zaman günlüğe yazılır. Varsayılan: kapalı.

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Flow data saved on orders is kept). Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan Flow) ve siparişi verir. Test modunda ödeme sayfasında SANDBOX MODE gösterilir — ödemeler Flow test ortamına gider. Gerçek tahsilat yapılmaz. Geçerli bir fatura e-postası gereklidir. Eklenti, sipariş toplamı için siparişin para biriminde, konusu Order # ile sipariş numarası ve site adından oluşan bir Flow ödemesi oluşturur ve müşteriyi Flow ödeme sayfasına gönderir. Müşteri orada Flow hesabınızda etkin bir ödeme yöntemini seçer.

Ödemeden sonra müşteri mağazanıza döner. Sipariş yalnızca Flow onayladıktan sonra ödenmiş olarak işaretlenir: onay bildirimiyle veya müşteri döndüğünde imzalı durum isteğiyle. Ödenmiş bir sipariş veya ödemesi beklenen nakit kuponu, sipariş alındı sayfasına yönlendirir.

Ödeme reddedilirse müşteri Your Flow payment was rejected. Please try again or choose another payment method. mesajıyla Pay for order sayfasına (veya ödeme sayfasına) döner. Müşteri Flow sayfasını ödeme yapmadan terk ettiyse mesaj The Flow payment was not completed. You can try again or choose another payment method. olur. Sonuç kontrol edilemediyse mesaj We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. olur. Her yeni girişim, siparişe bağlı yeni bir Flow ödemesi oluşturur.

Flow ödemeyi başlatamazsa müşteri kısa bir mesaj görür, örneğin Could not connect to Flow. Please try again in a moment. Ayrıntılar günlükte bulunur.

Ö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 İspanyolcaya (Şili ve İspanya) çevrilmiştir.

Eklenti yalnızca tek seferlik ödemeleri kabul eder. Kayıtlı kart, abonelik, yinelenen tahsilat veya ödeme bağlantısı yoktur ve bir Flow ödeme yöntemini önceden seçmez. Flow, oluşturulmuş bir ödeme bağlantısını iptal edemez: müşteri daha yeni bir bağlantıyı ödedikten sonra eski bağlantıyı öderse siparişe, mükerrer ödemeyi Flow'da iade etmenizi isteyen bir not eklenir.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Flow'a gönderildi ve henüz ödeme yapmadı. Sipariş notu, girişimin tutarını ve Flow sipariş numarasını gösterir.

On hold, awaiting coupon payment: müşteri Servipag veya Multicaja ödeme kuponu oluşturdu. Flow ödemeyi onayladığında sipariş değişir.

Processing: Flow ödemeyi ödenmiş olarak bildirdi ve tutar ile para birimi eşleşiyor (yalnızca sanal indirilebilir ürünler içeren siparişler WooCommerce'in varsayılanı olan Tamamlandı durumuna geçer). Sipariş notu tutarı ve Flow sipariş numarasını gösterir. Siparişin işlem kimliği Flow sipariş numarasıdır.

On hold, amount/currency mismatch: Flow siparişten farklı tutar veya para birimi bildirdi. Sipariş ödenmiş olarak işaretlenmedi; elle doğrulayın.

On hold, payment for a cancelled order: ödenmeden iptal edilmiş bir sipariş için ödeme geldi. Siparişi kontrol edip gönderin veya ödemeyi Flow'da iade edin.

Failed: Flow, ödenmemiş siparişin son ödeme girişimini reddetti. Müşteri tekrar deneyebilir.

Cancelled: son ödeme girişimi Flow'da iptal edildi.

Zaten ödenmiş bir siparişe başka bir ödeme gelirse sipariş değişmez. Bir not, mükerrer ödemeyi Flow hesabınızda iade etmenizi ister. Ödenip ardından iptal veya iade edilmiş bir sipariş yeniden açılmaz.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Flow düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, siparişin ödendiği ortama (test veya canlı) gönderilir; bu ortamın anahtarları ayarlanmış olmalı ve siparişte fatura e-postası bulunmalıdır. Flow, iadeyi tamamlaması için müşteriye e-posta gönderir. Flow iadeyi reddederse WooCommerce hatayı gösterir ve iade kaydedilmez. Başarılı istek, Flow iade numarası ve durumuyla sipariş notlarına eklenir.

Flow'un daha sonra bildirdiği iade durumu değişiklikleri sipariş notlarına eklenir. Flow iadeyi sonradan reddeder veya iptal ederse not, paranın müşteriye dönmediğini belirtir; WooCommerce iade kaydı korunur, bu nedenle elle işlem yapın. Flow panelinde oluşturulan iadeler WooCommerce'e aktarılmaz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Flow.cl sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, örneğin lisansın geçerli olduğu son tarih ve alan adınız gibi durum bilgilerini gösterir. 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ı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızda boşaltın.

Etkin anahtar olmadan Flow müşterilere ödeme sayfasında gösterilmez. Yine de ö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, anahtar satın almadan önce eklentiyi kurup test edebilmeniz için ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder. Eklentiler ve WooCommerce sayfalarında hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Lisans 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

Flow ödeme sayfasında görünmüyor: lisansın etkin, Enable / Disable seçeneğinin açık, mevcut modun anahtarlarının dolu (test modunda test, canlı modda canlı anahtarlar) ve mağaza para biriminin CLP veya USD olduğunu kontrol edin. Pay for order sayfasında siparişin para birimi kontrol edilir.

Ödeme gerçekleşti, ancak sipariş Pending payment durumunda kaldı: Flow onayı mağazanıza ulaşmadı ve müşteri dönmedi. Ayarlarda gösterilen onay URL'sinin internetten açıldığını ve bakım modu, parola koruması veya güvenlik duvarıyla engellenmediğini kontrol edin. Debug log seçeneğini açın ve WooCommerce > Status > Logs altında wcp_flow_gateway kaynağına bakın.

Onay, Payment does not belong to the order veya Unknown order yanıtı veriyor: ödeme bu mağaza tarafından bu sipariş için oluşturulmamış veya başka bir ortamda oluşturulmuştur. Sipariş değişmez.

Onay, Gateway not configured yanıtı veriyor: ödemenin ortamına ait anahtarlar boştur. Yeniden girin.

Onay, Flow API unavailable yanıtı veriyor: Flow'a durum isteği başarısız oldu. Flow onayı yeniden dener.

Müşteri Flow payments are not available at the moment mesajını görüyor: anahtarlar eksik veya Flow tarafından reddedildi. Mevcut modun API Key ve Secret Key bilgilerini kontrol edin.

Müşteri A valid billing email is required for Flow payments mesajını görüyor: Flow müşterinin e-posta adresine ihtiyaç duyar.

Müşteri ödedi, ancak sipariş On hold: sipariş notunu okuyun. Müşteri henüz ödenmemiş bir nakit kuponu oluşturdu veya Flow'un bildirdiği tutar ya da para birimi siparişle eşleşmiyor. Ondalıklı CLP toplamları tam pesoya yuvarlanır; bu nedenle Number of decimals değerini 0 yapın.

İade, test veya canlı anahtarlarla ilgili mesajla başarısız oluyor: sipariş o ortamda ödendi ve ortamın anahtarları boş. Anahtarları girip tekrar deneyin.

Lisans bloğu hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka alan adında kullanılıyorsa vibefox.net hesabınızda bir yuva boşaltı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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Geliştiriciler için readme dosyası wc_flw_supported_currencies filtresini listeler (ağ geçidinin sunulduğu para birimleri).

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çık olduğunda kaldırılır. Aksi halde sonraki kurulum için kalır. Siparişlere kaydedilmiş Flow verileri her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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