VibeFox Flow for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmaz.

Para birimi: Şili pesosu (CLP) veya ABD doları (USD). Diğer para birimlerindeki sepetler için ödeme yöntemi ödeme adımında gizlenir. CLP için International > Localization > Currencies bölümünde CLP para biriminin hassasiyetini 0 olarak ayarlayın, çünkü Flow tam peso tahsil eder.

Flow hesabı: Flow hesabınızın API Key ve Secret Key bilgilerine ihtiyacınız var; Flow'da Mis datos, Datos técnicos bölümünde bulunurlar. Testler için sandbox.flow.cl adresinde ayrı bir sandbox hesabı oluşturun ve onun anahtarlarını kullanın. Sandbox ve canlı anahtarlar farklıdır. Flow hesabında herhangi bir yapılandırma gerekmez.

Herkese açık site: mağazanızın onay, dönüş ve iade URL'lerine internet üzerinden erişilebilmeli; parola koruması veya Flow'u engelleyen bir güvenlik duvarı olmamalıdır. Mağazanın bakım modu bunları engellemez.

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

Kurulum

1. Back office'te 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 bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Flow Gateway öğesini bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğundaki License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Sandbox API Key ve Secret Key bilgilerini girin, Enable / Disable seçeneğini açın, Save düğmesine tıklayın ve bir test siparişi verin.

5. Gerçek ödemeleri kabul etmek için canlı anahtarları girin ve Sandbox mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Flow payment ve Flow payment on hold. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Flow Gateway > Configure. Alan içeren 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 anahtarları boşsa (Flow o durumda ödeme sayfasında gizlenir), mağazanın varsayılan para birimi CLP veya USD değilse ve CLP para biriminin ondalık basamakları varsa sizi uyarır (fiyatların, toplamların ve iadelerin tam olarak eşleşmesi için hassasiyetini 0 yapın). Sandbox modunda Sandbox mode — payments go to sandbox.flow.cl, no real money is charged. mesajını gösterir.

Flow.cl

Enable / Disable: Enable Flow.cl payments ödeme yöntemini açar veya kapatır. Varsayılan: off.

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

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

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

Sandbox mode: Flow sandbox'ını (sandbox.flow.cl) ve sandbox anahtarlarını kullanır. Sandbox modunda gerçek para tahsil edilmez. Varsayılan: on. Gerçek ödemeleri kabul etmek için kapatın ve canlı anahtarları girin. İadeler her zaman siparişin ödendiği ortamı kullanır.

Sandbox API Key: sandbox.flow.cl hesabınızın API Key değeri.

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

Live API Key: www.flow.cl hesabınızın API Key değeri.

Live Secret Key: www.flow.cl hesabınızın Secret Key değeri. Gizli tutun.

Kaydedilmiş anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek için yeni bir değer girin.

Clear saved keys: bir anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan kaydedilmiş değeri korur.

Bildirimler

Modül, her ödeme ve iade ile Flow'a üç URL gönderir; bu yüzden Flow hesabında hiçbir şey yapılandırmanız gerekmez. Bu bölümdeki Flow URLs alanı bunları listeler. Dostu URL'lerle şöyle görünürler:

Onay yalnızca bir ödeme jetonu içerir. Modül jetonu kendi oluşturduğu ödemeler arasında arar, ödemenin oluşturulduğu ortamda imzalı bir istekle Flow'a ödeme durumunu sorar ve yalnızca Flow'un yanıtını uygular. Bu mağazanın oluşturmadığı bir ödeme, Flow'a sorulmadan reddedilir. Onay olmazsa sipariş, müşteri Flow'dan döndüğünde oluşturulur.

Gelişmiş

Debug log: API çağrılarını ve bildirimleri modül klasöründeki logs/flw_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtarlar ve müşteri verileri asla günlüğe yazılmaz. Hatalar, kapalı olsa bile her zaman günlüğe yazılır. Varsayılan: off.

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

Delete data on uninstall: açıksa modülü kaldırmak, modül ayarlarını ve günlüğü siler. Siparişlerde kaydedilen Flow verileri korunur. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Flow) ve açıklamayı görür. Sandbox modunda SANDBOX MODE — ödemeler Flow sandbox'ına gider. Gerçek tahsilat yapılmaz. Müşteri onayladıktan sonra modül, sepet toplamı için sepetin para biriminde bir Flow ödemesi oluşturur; konu olarak Cart #, sepet numarası ve mağaza adı kullanılır ve müşteriyi Flow ödeme sayfasına yönlendirir. Müşterinin e-posta adresi Flow'a iletilir. Orada müşteri Flow hesabınızda etkin olan bir ödeme yöntemi seçer. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Flow onayladığında ödenmiş olarak işaretlenir: onay ile veya müşteri döndüğünde imzalı bir durum isteği ile. Sipariş daha sonra oluşturulur ve müşteri Your payment with Flow has been received. mesajıyla standart sipariş onay sayfasını görür. Müşteri bir Servipag veya Multicaja kuponu oluşturduysa sipariş Awaiting Flow payment durumunda oluşturulur ve sayfa Your Flow payment coupon was generated. The order will be processed as soon as Flow confirms the payment. mesajını gösterir. Kuponlu bir siparişin ödemesi daha sonra başarısız olur veya iptal edilirse sayfa Your Flow payment was not completed. Please contact us about this order. mesajını gösterir. Tutar eşleşmediyse sayfa Your Flow payment was received and is being reviewed by the shop. mesajını gösterir.

Müşteri döndüğünde Flow'a ulaşılamazsa veya o anda başka bir istek siparişi oluşturuyorsa, Payment confirmation sayfası müşteriden tekrar ödeme yapmamasını ister ve Check again ve Back to checkout seçeneklerini sunar.

Ödeme reddedilmişse müşteri Your Flow payment was rejected. Please try again or choose another payment method. mesajıyla ödeme sayfasına döner. Müşteri ödeme yapmadan Flow sayfasından ayrıldıysa mesaj The Flow payment was not completed. You can try again or choose another payment method. olur. Sonucun doğrulanamadığı durumda 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. Sepet korunur ve her yeni deneme, sepete bağlı yeni bir Flow ödemesi oluşturur.

Flow ödemeyi başlatamazsa müşteri kısa bir mesajla ödeme sayfasında kalır, örneğin Could not connect to Flow. Please try again in a moment. Ayrıntılar günlüktedir.

Ödeme ile onayı arasında sepetteki bir kupon geçerliliğini yitirirse PrestaShop onu siparişten kaldırır. Müşteri indirimli fiyatı ödediği için sipariş bir notla birlikte Flow payment on hold durumuna geçer.

Modül 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, zaten oluşturulmuş bir ödeme bağlantısını iptal edemez: sepet zaten ödendikten sonra bir müşteri eski bir bağlantıyla ödeme yaparsa, sipariş Flow'da mükerrer ödemeyi iade etmenizi isteyen bir not alır.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Flow'a yönlendirildi ve ödeme yapmadı ya da Flow ödemeyi henüz onaylamadı. Yalnızca sepet mevcut.

Payment accepted: Flow ödemeyi ödenmiş olarak bildirdi ve tutar ile para birimi eşleşiyor. Ödeme, Flow sipariş numarası işlem kimliği olarak kaydedilir; bir not tutarı, Flow sipariş numarasını ve ödeme yöntemini gösterir.

Awaiting Flow payment: müşteri bir Servipag veya Multicaja ödeme kuponu oluşturdu. Flow ödemeyi onayladığında sipariş Payment accepted durumuna geçer.

Flow payment on hold: Flow, sipariş toplamından farklı bir tutar veya para birimi bildirdi (örneğin ödeme başladıktan sonra sepet değiştirildi), bir kupon kaldırıldı ya da iptal edilmiş bir sipariş için ödeme geldi. Flow'un tahsil ettiği ödeme kaydedilir ve not durumu açıklar. Siparişi kontrol edin ve gönderin veya ödemeyi iade edin.

Payment error: Flow, beklemedeki bir siparişin kupon ödemesini reddetti.

Canceled: beklemedeki bir siparişin kupon ödemesi Flow'da iptal edildi.

Refunded: ödeme, modül aracılığıyla tamamen iade edildi.

Zaten ödenmiş bir sipariş için başka bir ödeme gelirse sipariş değişmez. Bir not, mükerrer ödemeyi Flow hesabınızda iade etmenizi ister. Tamamen iade edilen bir sipariş asla yeniden açılmaz.

Flow ödeme bloğu

Sipariş sayfasında Flow sipariş numarası ve ödeme yöntemi, commerceOrder referansı, ödeme durumu, ödenen ve iade edilen tutar, sandbox ödemeleri için bir Sandbox rozeti, iade geçmişi ve siparişin Flow notes bölümünü gösteren bir Flow payment bloğu bulunur.

İadeler

Flow payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Flow düğmesine tıklayın. Refund this amount via Flow? Flow e-mails the customer to complete the refund. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir. İadeler, Flow'un gerçekten tahsil ettiği tutarla sınırlıdır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin ödediği tutara kadar iade yapabilirsiniz. CLP iadeleri tam tutar olmalıdır. İade, ödemenin yapıldığı ortama (sandbox veya canlı) gönderilir; bu yüzden o ortamın anahtarları girilmiş olmalı ve müşterinin geçerli bir e-posta adresi bulunmalıdır. Flow iadeyi reddederse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir istek, iade geçmişine ve notlara Flow iade numarası ve durumuyla birlikte eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, Flow ödemeyi onayladıktan sonra kullanılabilir.

Flow'un bildirdiği sonraki iade durumu değişiklikleri notlara eklenir. Flow bir iadeyi daha sonra reddeder veya iptal ederse, not paranın müşteriye iade edilmediğini belirtir ve tutar yeniden iade edilebilir. Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Flow üzerinden para göndermez. Flow panelinde oluşturulan iadeler PrestaShop'a aktarılmaz.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Flow Gateway lisans bloğu, Modules > Module Manager > VibeFox Flow Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskelenmiş olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğu 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 ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-payment-flow satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloktaki metinler back office 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 bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını boşalttı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. 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 Flow, ö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. PrestaShop mağazası back office'te oturum açtığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonra haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Flow ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, geçerli modun anahtarlarının doldurulduğunu (sandbox modunda sandbox anahtarları, canlı modda canlı anahtarlar) ve sepet para biriminin CLP veya USD olduğunu kontrol edin. 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ı: Flow onayı mağazanıza ulaşmadı ve müşteri dönmedi. Flow URLs bölümünde gösterilen onay URL'sinin internetten açıldığını ve parola koruması ya da güvenlik duvarı tarafından engellenmediğini kontrol edin. Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Onay şu yanıtı veriyor: Payment does not belong to the order: jeton bu mağaza tarafından oluşturulmuş bir ödeme değil ya da Flow bunun için başka bir referans bildirdi. Hiçbir şey değişmez.

Onay şu yanıtı veriyor: Gateway not configured: ödemenin ortamına ait anahtarlar boş. Bunları yeniden girin. Flow onayı yeniden dener.

Onay şu yanıtı veriyor: Flow API unavailable or Busy, retry: Flow'a durum isteği başarısız oldu ya da sipariş tam o sırada başka bir istek tarafından oluşturuluyordu. Flow onayı yeniden dener.

Müşteri şunu görüyor: Flow payments are not available at the moment: anahtarlar eksik ya da Flow bunları reddetti. Geçerli modun API Key ve Secret Key değerlerini kontrol edin.

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

Müşteri şunu görüyor: The order total is too small to be paid with Flow: sepet toplamı, sepet para biriminde sıfıra yuvarlanıyor.

Müşteri ödeme yaptı ama sipariş Awaiting Flow payment ya da Flow payment on hold durumunda: Flow payment bloğundaki notları okuyun. Müşteri henüz ödenmemiş bir nakit ödeme kuponu oluşturdu ya da Flow'un bildirdiği tutar veya para birimi siparişle eşleşmiyor. Ondalıklı CLP toplamları tam pesoya yuvarlanır; bu yüzden CLP hassasiyetini 0 yapın.

İade, sandbox veya canlı anahtarlarla ilgili bir mesajla başarısız oluyor: sipariş bu ortamda ödendi ve o ortamın anahtarları boş. Anahtarları girin ve yeniden deneyin.

İade, Flow accepts CLP refunds in whole units only mesajıyla başarısız oluyor: tam bir tutar girin.

Geliştiriciler için README, actionWcpFlowSupportedCurrencies (ödeme yönteminin sunulduğu para birimleri) ve actionWcpFlowPaymentSubject (Flow'a gönderilen ödeme konusu) hook'larını listeler.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Flow 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. Delete data on uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Flow ödeme ve iade kayıtları ile Awaiting Flow payment ve Flow payment on hold sipariş durumları her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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