VibeFox Flow for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: Şili pesosu (CLP) veya ABD doları (USD). Diğer ödeme para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. CLP için, Flow tam peso tahsil ettiği için System > Localisation > Currencies bölümünde CLP para biriminin ondalık basamak sayısını 0 olarak ayarlayın.

Flow hesabı: Flow hesabınızın API Key ve Secret Key bilgilerine ihtiyacınız var; bunlar Flow içinde Mis datos, Datos técnicos altında bulunur. Testler için sandbox.flow.cl üzerinde ayrı bir sandbox hesabı oluşturun ve onun anahtarlarını kullanın. Sandbox ve canlı anahtarlar farklıdır. Flow hesabında herhangi bir ayar yapmanız gerekmez.

Herkese açık web sitesi: Mağazanızın onay, dönüş ve iade URL'lerine internet üzerinden erişilebilmelidir; 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 tek bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümünün paketlerini içeren tek bir zip dosyasıdır. Bilgisayarınıza çıkarın. Dosya README.txt, OpenCart 3 paketi wcp_flow_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_flow_gateway.ocmod.zip içerir. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı her iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_flow_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentide OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Flow Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı, sayfanın üst kısmındaki lisans bloğunda bulunan License key alanına yapıştırın 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 oluşturun.

5. Gerçek ödemeleri kabul etmek için canlı anahtarları girin, Sandbox mode seçeneğini kapatın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_flow_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfada kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Flow Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve Flow anahtarlarını OpenCart 3 için 3-5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları her iki sürümde de aynıdır. Yalnızca Flow URLs farklıdır (bkz. Flow URLs); bunlar her ödemeyle birlikte gönderilir, bu nedenle Flow hesabında bir şeyi değiştirmeniz gerekmez.

Yeni bir kurulum, ödeme yöntemi kapalı ve sandbox modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Flow Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa; mevcut modun anahtarları boşsa (bu durumda Flow ö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 bunları 0 olarak ayarlayın). Sandbox modunda Sandbox mode — payments go to sandbox.flow.cl, no real money is charged. ifadesini gösterir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title alanı 1 ila 128 karakter olmalıdır, Sort Order boş veya tam sayı olmalıdır, Total boş veya 0 ya da daha büyük bir sayı olmalıdır ve seçilen coğrafi bölge ile sipariş durumları mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez ve sayfa neyin düzeltileceğini gösterir.

Flow.cl

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ı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Flow. Zorunlu, 128 karaktere kadar.

Description: onay düğmesinin üstünde, Confirm Order adımında gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.

Sort Order: Flow'un ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Flow'u yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Flow'un sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki sepet tutarı. Flow'u her tutarda sunmak için boş bırakın.

Flow API kimlik bilgileri

API Key ve Secret Key bilgilerini Flow hesabınızdan (Mis datos, Datos técnicos) kopyalayın: canlı anahtarlar www.flow.cl adresinde, sandbox anahtarları sandbox.flow.cl adresinde bulunur (ayrı bir sandbox hesabı). Sandbox modu yalnızca sandbox anahtarlarını, canlı mod ise yalnızca canlı anahtarları kullanır.

Sandbox mode: Flow sandbox ortamını (sandbox.flow.cl) ve sandbox anahtarlarını kullanır. Sandbox modunda gerçek para tahsil edilmez. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın ve canlı anahtarları girin. İadeler her zaman siparişin ödendiği ortamı kullanır. Açık olduğu sürece müşteriler Confirm Order adımında SANDBOX MODE — Payments go to the Flow sandbox. No real charges. ifadesini görü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.

Kaydedilmiş anahtarlar 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. Kayıtlı bir anahtarı kaldırmak için alanın altındaki Clear the saved key on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Bildirimler

Eklenti, her ödeme ve her iade için Flow'a üç URL gönderir; bu nedenle Flow hesabında herhangi bir ayar yapmanız gerekmez. Bu bölümdeki Flow URLs alanı bunları başvuru amacıyla listeler. URL'ler OpenCart kurulumunuzun mağaza adresinden oluşturulur ve şu şekildedir:

OpenCart 4'te yöntem adı noktadan sonra gelir: https://your-store/index.php?route=extension/wcp_flow_gateway/payment/wcp_flow_gateway.confirmation, ….back ve ….refundCallback.

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

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş, «missing order»). Sipariş, Flow ödemeyi onaylayana kadar, yani onay veya müşterinin dönüşü ile bildirilene kadar bir durum almaz. Durum her zaman imzalı bir istekle Flow'dan okunur. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: doğrulanmış bir Flow ödemesinden sonra ayarlanan durum. Varsayılan: İşleniyor.

Awaiting Flow Payment Status: müşteri nakit ödeme kuponu oluşturdu (Servipag, Multicaja ve benzerleri). Para daha sonra gelir ve Flow bunu onaylar. Varsayılan: Beklemede.

Flow Payment On Hold Status: ödendi, ancak tutar veya para birimi siparişle uyuşmuyor ya da para iptal edilmiş bir sipariş için geldi. Bir not nedenini açıklar; ödemeyi elle kontrol edin. Varsayılan: Beklemede, çünkü OpenCart'ta «On hold» durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Payment Rejected Status: Flow ödemesi reddedilmiş, kupon ödemesi bekleyen bir sipariş. Varsayılan: Başarısız.

Payment Annulled Status: Flow ödemesi iptal edilmiş (annulled), kupon ödemesi bekleyen bir sipariş. Varsayılan: İptal Edildi.

Refunded Status: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: Geri Ödendi.

Gelişmiş

Debug log: API çağrılarını ve bildirimleri OpenCart günlük klasöründeki (storage/logs) flw_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz; 5 MB'a ulaştığında flw_p_debug.old.log.php olarak taşınır. Anahtarlar, imzalar ve müşteri verileri hiçbir zaman günlüğe yazılmaz. Hatalar, kapalı olsa bile her zaman günlüğe yazılır. Varsayılan: kapalı.

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

Delete data on uninstall: açık olduğunda eklentiyi kaldırmak, ayarlarını ve günlüğü siler. Siparişlerde kaydedilen Flow verileri korunur. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. API Keys ve Secret Keys dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı anahtarlar korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Flow). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to Flow to complete the payment. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı için sipariş para biriminde bir Flow ödemesi oluşturur; konusu Order # ile başlayıp sipariş numarası ve mağaza adıyla devam eder 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. Sipariş, tutar, Flow sipariş numarası ve ortam bilgileriyle birlikte Flow payment started notunu alır.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş yalnızca Flow onayladığında ödenmiş olarak işaretlenir: onay ile veya müşteri döndüğünde imzalı bir durum isteğiyle. Ardından sipariş, OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle durum alır ve müşteri OpenCart sipariş başarı sayfasını görür. Müşteri bir Servipag veya Multicaja kuponu oluşturduysa sipariş Awaiting Flow Payment Status durumunu alır ve sayfa ayrıca Your Flow payment coupon was generated. The order will be processed as soon as Flow confirms the payment. mesajını gösterir. Tutar eşleşmediyse sayfa Your Flow payment was received and is being reviewed by the store. mesajını gösterir.

Müşteri döndüğünde Flow'a ulaşılamazsa veya o anda başka bir istek siparişi onaylıyorsa, bir Payment confirmation sayfası We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly — please do not pay again. mesajını, bir Check again düğmesini ve bir Back to checkout düğmesini gösterir.

Ödeme reddedildiyse müşteri Your Flow payment was rejected. Please try again or choose another payment method. mesajıyla ödeme sayfasına döner. Sipariş durumsuz kalır. 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. Dönüş herhangi bir ödemeyle eşleştirilemediyse 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. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

Müşteri yeniden deneyebilir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme sayfasındaki siparişi günceller, böylece yeni bir deneme aynı siparişi yeni bir Flow ödemesiyle öder. Flow, zaten başlatılmış bir ödemeyi iptal edemez. Bu nedenle yeni bir ödemeden önce, bu siparişin ve aynı sepetteki diğer siparişlerin son iki gündeki açık Flow ödemeleri Flow üzerinden kontrol edilir. Bunlardan biri ödenmişse veya kuponu varsa, müşteri yeniden ödeme yapmak yerine başarı sayfasına gider. Aynı sepetteki başka bir sipariş zaten Flow ile ödenmişse yeni bir ödeme de başlatılmaz. Aynı sepet, örneğin iki tarayıcı sekmesinde, iki kez ödenirse yalnızca ilk ödeme siparişine durum verir: diğer sipariş durumsuz kalır ve ödenmiş sipariş, ikinci ödemeyi Flow hesabınızdan iade etmeniz için bir not alır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Bu sipariş ödeme yapılmadan kapatıldıysa (örneğin siz iptal ettiyseniz), müşteri The Flow payment was not completed. You can try again or choose another payment method. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order işlemi, sepetteki yeni bir siparişi öder. Bu sipariş zaten ödenmişse veya kuponu varsa, ancak sepet o zamandan beri değişmişse (yeni bir adet dahil), müşteri ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order işlemi yeni sepeti yeni bir siparişle öder. Ödenmiş bir sipariş, farklı bir sepet için asla ödenmiş gibi gösterilmez.

Flow ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve 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üktedir.

Eklenti yalnızca tek seferlik ödemeleri destekler. Kayıtlı kart, abonelik, yinelenen tahsilat veya ödeme bağlantısı yoktur ve hiçbir Flow ödeme yöntemini önceden seçmez. Sipariş zaten ödenmişken bir müşteri eski bir Flow ödemesini öderse, sipariş, kopyayı Flow'dan iade etmeniz için bir not alır.

Siparişler ve iadeler

Sipariş durumları

Durumsuz (missing order): müşteri Flow'a yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya tamamlanmadı ya da Flow henüz ödemeyi onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (default Processing): Flow ödemeyi ödenmiş olarak bildirdi ve tutar ile para birimi eşleşiyor. Bir not, tutarı ve Flow sipariş numarasını gösterir.

Awaiting Flow Payment Status (default Pending): müşteri nakit ödeme kuponu oluşturdu. Bir not kupon türünü belirtir. Flow ödemeyi onayladığında sipariş Order Status After Payment durumuna geçer.

Flow Payment On Hold Status (default Pending): Flow, siparişin toplamından farklı bir tutar veya para birimi bildirdi ya da iptal edilmiş bir sipariş için ödeme geldi. Flow'un tahsil ettiği ödeme kaydedilir ve not bunu açıklar. Siparişi kontrol edin ve gönderin ya da ödemeyi iade edin.

Payment Rejected Status (default Failed): Flow, bekleyen bir siparişin kupon ödemesini reddetti.

Payment Annulled Status (default Canceled): bekleyen bir siparişin kupon ödemesi Flow'da iptal edildi.

Refunded Status (default Refunded): ödeme, eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş bir sipariş için başka bir ödeme gelirse sipariş değişmez. Bir not, kopyayı Flow hesabınızdan iade etmenizi ister. İade edilmiş bir sipariş asla yeniden açılmaz.

Notlar, müşterinin görmediği siparişin History kısmındaki kayıtlardır.

VibeFox Flow Gateway sekmesi

Sales > Orders bölümünde Flow ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanındaki VibeFox Flow Gateway sekmesi; ödeme yöntemiyle birlikte Flow order numarasını, sandbox ödemeleri için Sandbox etiketini, commerceOrder referansını (ve deneme sayısını), ödemenin Status bilgisini, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Flow notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir Reason (optional) girin 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. Eklentiyi değiştirme izniniz olması gerekir (System > Users > User Groups bölümünde ayarlanır). İadeler, Flow'un gerçekten tahsil ettiği tutarla sınırlıdır; dolayısıyla bir tutar uyuşmazlığından sonra sipariş toplamını 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 nedenle o ortamın anahtarları girilmiş olmalı ve müşterinin geçerli bir e-posta adresi bulunmalıdır. Flow iadeyi reddederse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir istek, Flow iade numarası ve durumuyla birlikte iade geçmişine ve notlara eklenir. Tam iade, müşteriye bildirim göndermeden ve ürünleri stoğa geri eklemeden siparişi Refunded Status durumuna alır; tıpkı elle yapılan bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, Flow ödemeyi onayladıktan sonra kullanılabilir.

Flow'un bildirdiği iadenin sonraki durum değişiklikleri notlara eklenir. Flow daha sonra bir iadeyi reddeder veya iptal ederse, not paranın müşteriye iade edilmediğini belirtir ve tutar yeniden iade edilebilir. Sales > Returns bölümündeki ürün iadeleri Flow üzerinden para geri göndermez. Flow panelinde oluşturulan iadeler OpenCart'a aktarılmaz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Flow Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Flow Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın 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 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 düğmelerini gösterir. Bunların altında Product: opencart-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 eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetim paneli 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 tarihiyle birlikte License expired on. Mağaza adresini değiştirdikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti, bilinen son durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresinde. 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. Aynı tarayıcıda yönetim paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard ekranında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. 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. Yönetim paneli Dashboard veya Edit sayfası açıldığında durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez.

Sorun giderme

Flow ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, mevcut modun anahtarlarının doldurulduğunu (sandbox modunda sandbox anahtarları, canlı modda canlı anahtarlar) ve ödeme para biriminin CLP veya USD olduğunu kontrol edin. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme gerçekleşti, ancak sipariş durumsuz kaldı: Flow onayı mağazanıza ulaşmıyor ve müşteri geri dönmedi. Flow URLs içinde 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 eklenti sayfasındaki Log alanına bakın.

Onay şu yanıtı veriyor: Payment does not belong to the order: jeton, bu mağazanın oluşturduğu bir ödemeye ait değil veya Flow onun için başka bir referans bildirdi. Hiçbir şey değişmez.

Onay şu yanıtı veriyor: Gateway not configured: ödemenin ortamındaki 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 veya sipariş aynı anda başka bir istekle onaylanıyordu. Flow onayı yeniden dener.

Müşteri şunu görüyor: Flow payments are not available at the moment: anahtarlar eksik veya Flow bunları reddetti. Mevcut modun API Key ve Secret Key bilgilerini kontrol edin.

Müşteri şunu görüyor: This payment method is not available. Please reload the checkout page.: ödeme oturumu artık siparişle eşleşmiyor veya ödeme yöntemi bu arada kapatıldı. Müşteri ödeme sayfasını yeniden yükler.

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

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

Müşteri ödedi, ancak sipariş beklemede veya bekletmede durumunda: VibeFox Flow Gateway sekmesindeki notları okuyun. Müşteri henüz ödenmemiş bir nakit kupon oluşturdu veya Flow'un bildirdiği tutar ya da para birimi siparişle eşleşmiyor. Ondalıklı CLP toplamları tam pesolara yuvarlanır; bu nedenle CLP ondalık basamaklarını 0 olarak ayarlayın.

Sekmede iade formu yok: sekme nedenini belirtir: ödeme henüz onaylanmadı, tamamen iade edildi, kullanıcı grubunuzun eklentiyi değiştirme izni yok veya ödemenin yapıldığı ortamın anahtarları boş.

İade, sandbox veya canlı anahtarlarla ilgili bir mesajla başarısız oluyor: sipariş o ortamda ödendi ve bu 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: eklenti, OpenCart olaylarını tetikler: wc_flw_supported_currencies (ödeme yönteminin sunulduğu para birimleri) ve wc_flw_payment_subject (Flow'a gönderilen ödeme konusu).

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Flow Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable / Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda Flow URLs'nin geçişine izin veren başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa diğer ayarlar (başlık, açıklama, sandbox modu, anahtarlar, hata ayıklama günlüğü anahtarı) ve günlük silinir. Kapalıysa, daha sonraki bir yeniden kurulum için saklanırlar. Flow ödeme ve iade kayıtları her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Flow Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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