VibeFox Hubtel for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonraki sürümler (4.1.0.3 üzerinde test edildi).

PHP: cURL eklentisi ile birlikte 8.0 veya üzeri.

Para birimi: yalnızca Gana sedisi (GHS). Sipariş para birimi GHS değilse ödeme yöntemi ödeme sayfasında gizlenir. Hubtel tam pesewa tahsil ettiği için GHS para biriminin ondalık basamak sayısını 2 olarak tutun.

Hubtel hesabı: API anahtarları (API ID ve API Key) ve satıcı hesap numarası (POS Sales ID) bulunan bir Hubtel iş hesabı. Anahtarlar, bo.hubtel.com adresindeki Hubtel iş paneline ait Programmable keys bölümünde bulunur.

IP beyaz listesi: Hubtel, Transaction Status API'sine yalnızca beyaz listedeki sunucu IP adreslerinden yanıt verir. Hubtel'den (hesap yöneticinizden veya support@hubtel.com adresinden) web sunucunuzun genel IP adresini beyaz listeye eklemesini isteyin. O zamana kadar ödemeler doğrulanamaz ve siparişler durumsuz kalır.

Test ortamı yok: Hubtel'in herkese açık bir sandbox ortamı yoktur. Tüm ödemeler gerçektir.

Cron: arka plan ödeme kontrolleri için, eklentinin cron URL'sini her 5 dakikada bir çağıran bir sunucu cron işi önerilir (bkz. Configuration).

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ü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_hubtel_pay-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_hubtel_pay.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

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

2. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox Hubtel Pay Gateway öğesini 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 yetkisine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) tıklayın. VibeFox lisans anahtarınızı, sayfanın üstündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. License key).

4. API ID, API Key ve satıcı hesap numarasını (POS Sales ID) girin.

5. Hubtel destek ekibinden, sunucu IP adresinizi Transaction Status API için beyaz listeye eklemesini isteyin.

6. Payment confirmation bölümünde gösterilen cron URL'sini sunucunuzun cron ayarlarına ekleyin.

7. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Callback URL'si her ödemede Hubtel'e gönderildiği için Hubtel panelinde bir şey yapılandırmanız gerekmez.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_hubtel_pay.ocmod.zip dosyasını seçin. Dosya adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

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

3. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox Hubtel Pay Gateway öğesini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, Hubtel kimlik bilgilerini ve cron'u OpenCart 3 için 3-7. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca callback URL'si ve cron URL'si farklıdır (bkz. Payment confirmation).

Yeni bir kurulum, ödeme yöntemi kapalı olarak başlar.

Yapılandırma

Tüm ayarlar eklentinin sayfasında bulunur: Extensions > Extensions > Payments > VibeFox Hubtel Pay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde, API ID, API Key veya satıcı hesap numarası eksikse ve mağazanın varsayılan para birimi GHS değilse sayfa sizi uyarır. Her iki durumda da Hubtel ödeme sayfasında gizlenir. Ayrıca GHS para birimi 2'den fazla ondalık basamak kullanıyorsa uyarır (bunu System > Localisation > Currencies bölümünde ayarlayın). Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir, ancak kaydedemez.

Kaydederken Title boş olamaz ve en fazla 128 karakter olabilir (Enter a title for the payment method (1 to 128 characters).), Sort Order tam sayı olmalı, Total 0 veya daha büyük bir sayı olmalı, coğrafi bölge ve sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Ödeme yöntemi kimlik bilgileri olmadan açılırsa ayarlar bir uyarıyla kaydedilir.

Hubtel

Enable/Disable: Enable Hubtel 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: Mobile Money or card (Hubtel). Zorunlu.

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde, Mobile Money ve kart simgesinin yanında gördüğü metin. Varsayılan: Pay with MTN MoMo, Telecel Cash, AirtelTigo Money or a Visa/Mastercard card. You will be redirected to Hubtel to complete the payment.

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

Geo Zone: Hubtel'i 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: Hubtel'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Minimum tutar istemiyorsanız boş bırakın.

Hubtel API kimlik bilgileri

API ID ve API Key değerlerini Hubtel iş panelinizden kopyalayın: bo.hubtel.com > Programmable keys (bölüm oraya bir bağlantı içerir). Satıcı hesap numarası, Hubtel hesabınızın POS Sales ID değeridir. Bölüm ayrıca IP beyaz listesi uyarısını tekrarlar.

API ID (Client ID): Hubtel programlanabilir anahtarlarınızın API ID değeri.

API Key (Client Secret): Hubtel programlanabilir anahtarlarınızın API Key değeri. Gizli tutun. Kayıtlı anahtar bir daha asla 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ı anahtarı kaldırmak için alanın altındaki Clear saved API Key kutusunu işaretleyin ve Save düğmesine tıklayın.

Satıcı hesap numarası (POS Sales ID): ödemeler bu Hubtel hesabına tahsil edilir ve bu hesapla karşılaştırılır.

Ödeme onayı

Callback URL: callback, mağazanıza bir ödemenin yapıldığını bildirir. Bu URL her ödemede Hubtel'e gönderildiği için Hubtel panelinde bir şey yapılandırmanız gerekmez. OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_hubtel_pay/callback, OpenCart 4'te https://your-store/index.php?route=extension/wcp_hubtel_pay/payment/wcp_hubtel_pay.callback gibi görünür ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. İnternetten erişilebilir olmalıdır: parola koruması olmamalı ve Hubtel'i engelleyen bir güvenlik duvarı bulunmamalıdır. Callback, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentilerinin isteklerini geçirir, OpenCart 4'te ise eklenti callback'i, cron URL'sini ve müşterinin Hubtel'den dönüşünü geçiren bir startup action ekler.

Hubtel callback'leri imzalanmaz. Eklenti bir callback'ten yalnızca ödeme referansını alır; referans mağazanıza ait bir ödemeye ait olmalıdır. Durum, tutar ve işlem kimliği her zaman Hubtel Transaction Status API'sinden gelir. Sipariş yalnızca bu API ödemeyi ve tutarını onayladıktan sonra ödenmiş olarak işaretlenir.

Arka plan ödeme kontrolleri (cron): eklenti kurulduğunda oluşturulan gizli bir jetonla birlikte gelen cron URL'si. Sunucunuzun cron ayarlarından her 5 dakikada bir çağırın, örneğin curl ile. Onaylanmamış ödemeler bunun ardından Hubtel ile otomatik olarak yeniden kontrol edilir: müşteri Hubtel'e yönlendirildikten 20 dakika sonra, ödeme hâlâ ödenmemişse bir saat sonra bir kez daha ve Hubtel'e ulaşılamadığında artan aralıklarla en fazla 5 kez. OpenCart 4'te cron URL'sinin yolu extension/wcp_hubtel_pay/payment/wcp_hubtel_pay.cron olur; extension/payment/wcp_hubtel_pay/cron yerine bu kullanılır. URL'yi ayarların gösterdiği gibi tam olarak kopyalayın. URL'yi gizli tutun. URL, OK checked=0 gibi kısa bir satırla yanıt verir.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik bir sipariş). Sipariş, yalnızca Hubtel ödemeyi onayladıktan sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order status after payment: Hubtel, GHS cinsinden tam sipariş tutarındaki ödemeyi onayladıktan sonra ayarlanan durum. Varsayılan: İşleniyor.

Hubtel payment on hold status: Hubtel, sipariş toplamından farklı bir ödenmiş tutar bildirdiğinde veya sipariş GHS cinsinden değilse ayarlanan durum. Sipariş geçmişindeki bir not bunu açıklar. 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.

Gelişmiş

Debug log: API çağrılarını ve callback'leri OpenCart günlükler klasöründeki (storage/logs) hubtel_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında hubtel_p_debug.old.log.php dosyasına taşınır. Anahtarlar ve müşteri verileri günlüğe kaydedilmez. Hatalar ve uyarılar, bu seçenek kapalı olsa bile her zaman günlüğe kaydedilir. Varsayılan: kapalı.

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

Delete data on uninstall: açıkken eklentiyi kaldırmak, bu eklentinin ayarlarını ve günlüğünü siler. Siparişler için kaydedilmiş Hubtel ödeme denemeleri her zaman kalır. Varsayılan: kapalı.

İçe Aktar / Dışa Aktar

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. API Key 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ı API Key korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Mobile Money or card (Hubtel)). Confirm Order adımında müşteri simgeyi ve açıklamanızı görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, GHS cinsinden sipariş toplamı için bir Hubtel ödeme oturumu oluşturur ve müşteriyi Hubtel ödeme sayfasına yönlendirir. Ödeme orada Order #, sipariş numarası ve mağazanızın adıyla görünür. Hubtel sayfasında müşteri MTN MoMo, Telecel Cash, AirtelTigo Money, Visa veya Mastercard kartı ya da GhQR ile öder. Confirm Order düğmesine her tıklamada kendi referansıyla yeni bir ödeme denemesi oluşturulur ve daha eski Hubtel sayfaları ödenebilir durumda kalır.

OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesi ve açılan Payment method options penceresiyle seçer; sayfanın altındaki Confirm Order düğmesine tıklar.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, Hubtel bunu Transaction Status API üzerinden onaylayana kadar ödenmiş olarak işaretlenmez: callback ile, müşteri geri döndüğünde yapılan kontrolle, arka plan kontrolüyle veya sipariş sayfasındaki düğmeyle. Aynı anda gelen bir callback ve geri dönüş birbiri ardına işlenir; böylece ödeme hiçbir zaman iki kez uygulanmaz. Sipariş ardından OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri OpenCart sipariş başarı sayfasını görür. Sipariş beklemeye alındıysa sayfa Your Hubtel payment was received and is being reviewed by the store. We will contact you if anything is needed. ifadesini gösterir.

Müşteri geri döndüğünde Hubtel ödemeyi henüz onaylamadıysa, bir Payment confirmation sayfası We are waiting for Hubtel to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. ifadesini ve Check again ile Back to checkout düğmelerini gösterir. Hubtel ödemeyi onaylar onaylamaz sipariş bir durum alır. Hubtel bu ödeme denemesini zaten başarısız olarak bildirdiyse, müşteri The Hubtel payment was not completed. You can try again or choose another payment method. mesajıyla ödeme sayfasına geri döner. Sepet korunur ve sipariş durumsuz kalır.

Müşteri Hubtel sayfasında Cancel düğmesine basarsa eklenti önce ödemenin yine de yapılıp yapılmadığını kontrol eder. Yapılmadıysa müşteri The Hubtel payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Sepet korunur. İptal edilen Hubtel sayfası üzerinden daha sonra yapılan bir ödeme yine de kabul edilir.

OpenCart 4'te iptal edilen veya başarısız olan bir ödemeye ilişkin mesajlar ödeme sayfasının üstünde gösterilir. 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, bu nedenle iptal veya başarısız bir ödemeden sonra müşteri aynı siparişi yeni bir ödeme denemesiyle öder. Yeni bir denemeden önce eklenti, bu siparişin ve aynı sepetin önceki siparişlerinin (son 24 saat) onaylanmamış denemelerini Hubtel'e sorar. Bunlardan biri ödenmiş çıkarsa o ödeme uygulanır ve müşteri iki kez ödeme yapmak yerine başarı sayfasına yönlendirilir. Sepetin değişmesi, yeni bir adet dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu arada sipariş kapatıldıysa (örneğin siz iptal ettiyseniz) ve ödenmediyse, müşteri The Hubtel 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 yeni bir sipariş öder. Sipariş zaten ödenmişse ve sepette artık yeni bir satın alma varsa, Confirm Order ödeme sayfasını yeniden yükler; bir sonraki Confirm Order yeni bir sipariş öder. Ödenmiş bir sipariş, farklı bir sepet için asla ödenmiş gibi gösterilmez.

Hubtel ödemeyi başlatamazsa müşteri, düğmenin üstünde kısa bir mesajla Confirm Order adımında kalır; örneğin Could not connect to Hubtel. Please try again in a moment., Hubtel could not start the payment. Please try again or choose another payment method. veya kimlik bilgileri yanlışsa Hubtel payments are not available at the moment. Please choose another payment method. Ayrıntılar günlüğe gider.

Eklentide OpenCart üzerinden iade, abonelik, kayıtlı kart ve mağaza içinde ödeme kanalı seçimi yoktur.

Siparişler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Hubtel'e yönlendirildi ve ödeme yapmadı ya da Hubtel ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu tür siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.

Order status after payment (varsayılan İşleniyor): ödeme, GHS cinsinden tam sipariş tutarı için onaylandı. Bir not tutarı, Hubtel işlemini, ödeme yöntemini ve referansı gösterir.

Hubtel payment on hold status (varsayılan Beklemede): Hubtel, sipariş toplamından farklı bir ödenmiş tutar bildirdi veya sipariş GHS cinsinden değil. Sipariş ödenmiş olarak işaretlenmedi ve bir not uyuşmazlığı açıklıyor. Hubtel panelinde ödemeyi kontrol edin ve siparişi yerine getirin veya elle iade edin. Aynı siparişin başka bir denemesi daha sonra doğru tutar için ödenirse, sipariş Order status after payment durumuna geçer.

Zaten ödenmiş bir siparişin başka bir denemesi de ödenirse veya zaten ödenmiş bir sepetin başka bir siparişi ödenirse, ödenmiş sipariş değiştirilmez. Bir not, kopyayı Hubtel panelinizde iade etmenizi ister. Başka bir duruma (örneğin iptal edildi) taşıdığınız bir sipariş için yapılan ödeme bir not ekler ve sipariş asla otomatik olarak yeniden açılmaz. Hubtel bir ödemenin iade edildiğini bildirdiğinde siparişe bir not eklenir.

Notlar, müşterinin görmediği siparişin History bölümündeki kayıtlardır.

VibeFox Hubtel Pay Gateway sekmesi

Sales > Orders bölümünde Hubtel ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Hubtel Pay Gateway sekmesi siparişin Hubtel payment attempts kayıtlarını listeler: tarih, referans ve Hubtel ödeme oturumu, tutar, Hubtel durumu, işlem ve sonuç. Denemelerin altında siparişin Hubtel notes kayıtları, en yenisi en üstte olacak şekilde listelenir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

Check Hubtel payment status düğmesi siparişin en son denemelerini kontrol eder (en fazla 5, en yenisi en üstte; sipariş ödendiğinde durur), sonucu uygular ve her denemenin durumunu gösteren bir not ekler. Sonuç sekmede gösterilir. Siparişleri değiştirme yetkisine ihtiyacınız vardır (Sales > Orders, System > Users > User Groups bölümünde ayarlanır). Düğme, durumsuz bir sipariş için de çalışır. Bu düğmeyle ayarlanan durum doğrudan yazılır; sipariş e-postaları gönderilmez ve stok güncellenmez. Callback, müşterinin geri dönüşü ve cron bu durumu standart yöntemle ayarlar.

İadeler

OpenCart üzerinden iadeler desteklenmez. Ödemeyi Hubtel panelinde iade edin, ardından iadeyi OpenCart'ta kaydedin. Sales > Returns bölümündeki ürün iadeleri Hubtel üzerinden para geri göndermez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Hubtel Pay Gateway lisans bloğu, ayarların üstünde, Extensions > Extensions > Payments > VibeFox Hubtel Pay Gateway > Edit sayfasındaki 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 tarihi ve alan adınızı) ve Check now düğmesini (durumu yeniden kontrol eder), Change key düğmesini (başka bir anahtar girmek için) ve Remove key düğmesini (anahtarı bu mağazadan kaldırmak için) gösterir. Bunların altında Product: opencart-payment-hubtel satırı ve hesabınızda, vibefox.net üzerinde açılan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici panelinin 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 tarihli License expired on. Mağaza adresi değiştikten 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart ayarlarındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Hubtel, ö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. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, mağazada ödeme yöntemini hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurabilir ve test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetici paneli Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler, arka plan kontrolleri dahil, onaylanmaya devam eder.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici 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. Lisans kontrolü için cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Hubtel ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, API ID, API Key ve satıcı hesap numarasının doldurulduğunu ve sipariş para biriminin GHS 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. Kimlik bilgileri veya para birimi yanlışsa ayarlar sayfası bir uyarı gösterir.

Ödeme yapıldı, ancak sipariş durumsuz kaldı: ödeme onaylanamadı. Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. Durum kontrolünde HTTP 401 veya 403, API anahtarlarının yanlış olduğu ya da sunucu IP'sinin Hubtel tarafından beyaz listeye alınmadığı anlamına gelir. Ayrıca callback URL'sinin internetten erişilebilir olduğunu ve cron URL'sinin çağrıldığını kontrol edin. Hubtel yanıt verdiği anda bir sonraki callback, arka plan kontrolü, müşterinin geri dönüşü veya Check Hubtel payment status sipariş durumunu ayarlar.

Callback, Unknown reference yanıtı veriyor: ödeme referansı bu mağazanın bir ödemesine ait değil.

Callback, Payment status unavailable yanıtı veriyor: Transaction Status API'sine ulaşılamadı veya istek reddedildi ya da sepet aynı anda başka bir istekle onaylanıyordu. Ödeme, 5 dakika sonra arka planda yeniden kontrol edilir.

Callback, Gateway not configured yanıtı veriyor: API ID, API Key veya satıcı hesap numarası eksik. Bunları doldurun; ödeme arka planda yeniden kontrol edilir.

Callback, Invalid request veya Invalid ClientReference yanıtı veriyor: istek geçerli bir Hubtel callback'i içermiyordu.

Callback URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Hubtel'den gelen istekleri kabul eder.

Cron URL'si Forbidden yanıtı veriyor: URL'deki jeton yanlış. Cron URL'sini ayarların gösterdiği gibi tam olarak kopyalayın. Delete data on uninstall açıkken yeniden kurulumdan sonra jeton yenidir.

Sipariş beklemede durumunda: VibeFox Hubtel Pay Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları), ödemeyi Hubtel panelinde kontrol edin ve siparişi yerine getirin veya elle iade edin.

Müşteri Confirm Order sonrası bir hata görüyor: Debug log seçeneğini açın ve günlüğe bakın. Yanlış API anahtarları Hubtel payments are not available at the moment. hatasını verir. Bağlantı sorunu Could not connect to Hubtel. hatasını verir. Başka bir para birimindeki sipariş Hubtel accepts payments in Ghana cedis (GHS) only. Please choose another payment method. hatasını verir. This payment method is not available. Please reload the checkout page. ise ödeme sayfasının artık siparişle eşleşmediği veya ödeme yönteminin bu arada kapatıldığı anlamına gelir.

Geliştiriciler için: OpenCart olayı wcp_hubtel_pay_icon ödeme yöntemi simgesini, wcp_hubtel_pay_payment_description ise Hubtel sayfasındaki ödeme açıklamasını değiştirir.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Hubtel Pay 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ılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve startup action'ı da; bu, bakım modunda callback'i, cron URL'sini ve müşterinin dönüşünü geçirir). Delete data on uninstall açıksa, diğer ayarlar (başlık, açıklama, API kimlik bilgileri, cron jetonu, hata ayıklama günlüğü anahtarı) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Siparişlerin Hubtel ödeme denemeleri her zaman korunur; bu nedenle geciken callback'ler ve kontroller yeniden kurulumdan sonra da çalışmaya devam eder. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırmanın ardından Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Hubtel Pay 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.

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