VibeFox HyperPay 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: OpenSSL eklentisi bulunan 8.0 veya üzeri (webhook'ların şifresini çözer).

HyperPay hesabı: HyperPay, satıcı hesabınız kurulduğunda Access Token ve Entity ID bilgilerini verir. Test ve canlı kimlik bilgileri birbirinden farklıdır. Ayrıca HyperPay panelinde bir ödeme webhook'una ve Administration > Webhooks altında gösterilen şifre çözme anahtarına (webhook key) ihtiyacınız vardır (bkz. Yapılandırma).

Kart verileri: kart yalnızca HyperPay arayüzüne girilir; bu nedenle kart verileri hiçbir zaman sunucunuzdan geçmez (PCI DSS SAQ A).

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

Kurulum

İndirilen dosya, 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_hyperpay_payment_gateway-oc3-(sürüm).ocmod.zip ve OpenCart 4 paketi wcp_hyperpay_payment_gateway.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önetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_hyperpay_payment_gateway-oc3-(sürüm).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi 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 bölümüne gidin ve türü Payments olarak seçin. VibeFox HyperPay Payment Gateway eklentisini bulun ve Install düğmesine (yeşil +) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme yetkisi olmalıdır.

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ğundaki License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. HyperPay tarafından verilen test Access Token, Entity ID ve webhook anahtarını girin ve Test Mode seçeneğini açık bırakın.

5. HyperPay panelinde (Administration > Webhooks) bu bölümdeki Webhook başlığında gösterilen URL ile bir ödeme webhook'u ekleyin ve şifre çözme anahtarını aynı mod için webhook anahtarı alanına kopyalayın.

6. Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve bir HyperPay test kartıyla test ödemesi yapın. Ardından canlı kimlik bilgilerini girin ve Test Mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_hyperpay_payment_gateway.ocmod.zip dosyasını seçin. Dosyanın 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 +) tıklayın.

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

4. Lisans anahtarını, HyperPay kimlik bilgilerini ve webhook'u OpenCart 3 için 3. ila 6. adımlardaki gibi girin. Ayarlar sayfası ve alanları her iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Webhook).

Yeni bir kurulum, ödeme yönteminin kapalı ve test modunun açık olduğu durumla başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox HyperPay Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde, test modu açık olduğu sürece sayfa Test mode is on: payments go to the HyperPay test system and no real money is charged. uyarısını gösterir. Geçerli modun Access Token veya Entity ID bilgisi eksikse (bu durumda ödeme yöntemi ödeme sayfasında gösterilmez) ve geçerli modda geçerli bir webhook anahtarı yoksa (bu durumda ödemeler yalnızca müşteri mağazaya döndüğünde onaylanır) sayfa sizi uyarır. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş olamaz ve en fazla 128 karakter olabilir, Transaction Type geçerli olmalıdır, Sort Order tam sayı olmalıdır, Total 0 veya daha büyük bir sayı olmalıdır ve bölge (geo zone) ile sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Kimlik bilgilerindeki boşluklar silinir. Bir webhook anahtarı 64 karakterlik onaltılık bir anahtar değilse veya hiçbir ödeme markası işaretlenmemişse ayarlar uyarıyla kaydedilir.

HyperPay

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

Title: müşterinin ödeme sırasında gördüğü başlık. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit/Debit Card (HyperPay). Zorunlu.

Description: müşterinin Confirm Order adımında, onay düğmesinin üstünde, bir kart simgesinin altında gördüğü metin. Varsayılan: Pay securely using your credit or debit card.

Sort Order: HyperPay'in ödeme sayfasındaki ödeme yöntemleri arasındaki sırası. Boş bırakın ya da bir tam sayı girin.

Geo Zone: HyperPay'i yalnızca seçilen bölgedeki fatura adresleri için sunun. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones bölümünde tanımlanır.

Total: HyperPay'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası tutarı. Her tutarda HyperPay'i sunmak için boş bırakın.

API kimlik bilgileri

Access Token, Entity ID ve webhook anahtarı, satıcı hesabınız kurulduğunda HyperPay tarafından verilir. Test ve canlı kimlik bilgileri birbirinden farklıdır. Webhook anahtarı HyperPay panelinde Administration > Webhooks altında gösterilir. Bölümde HyperPay web sitesine ve geliştirici belgelerine bağlantılar bulunur.

Test Mode: HyperPay test sistemini (eu-test.oppwa.com) ve test kimlik bilgilerini kullanır. Gerçek para tahsil edilmez. Canlı kimlik bilgileriyle (eu-prod.oppwa.com) gerçek ödemeler almak için kapatın. Varsayılan: açık. Açıkken müşteriler Confirm Order adımında Test mode: no real payment will be made. mesajını görür.

Test Access Token: HyperPay test hesabınızın bearer token'ı.

Test Entity ID: test ödeme kanalının Entity ID'si.

Test Webhook Key: test sisteminin webhook bildirimlerinin şifresini çözmek için kullanılan 64 karakterlik onaltılık anahtar.

Live Access Token: HyperPay canlı hesabınızın bearer token'ı.

Live Entity ID: canlı ödeme kanalının Entity ID'si.

Live Webhook Key: canlı sistemin webhook bildirimlerinin şifresini çözmek için kullanılan 64 karakterlik onaltılık anahtar.

Kayıtlı Access Token'lar ve webhook 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 değeri kaldırmak için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook

Webhook, müşteri mağazaya dönmeden tarayıcıyı kapatsa bile mağazanıza ödemeler hakkında bilgi verir. HyperPay panelinde (Administration > Webhooks) bu bölümdeki Webhook URL alanında gösterilen URL ile bir ödeme webhook'u ekleyin. OpenCart 3'te URL şuna benzer: https://your-store/index.php?route=extension/payment/wcp_hyperpay_payment_gateway/webhook; OpenCart 4'te https://your-store/index.php?route=extension/wcp_hyperpay_payment_gateway/payment/wcp_hyperpay_payment_gateway.webhook. OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın. Ardından webhook şifre çözme anahtarını aynı mod için Test Webhook Key veya Live Webhook Key alanına kopyalayın.

HyperPay webhook'ları şifrelidir (AES-256-GCM). Anahtarlarınızla şifresi çözülemeyen bir webhook reddedilir. Yalnızca ödeme bildirimleri işlenir ve ödeme, sizin siparişlerinizden birinin ödeme sayfasına ait olmalı ve onu çözen anahtarla aynı modda oluşturulmuş olmalıdır. HyperPay test bildirimleri onaylanır. Webhook ayrıca HyperPay panelinde yapılan tahsilatları, iptalleri, iadeleri ve itirazları da bildirir (bkz. Siparişler ve iadeler). Webhook olmadan bir ödeme, müşteri ödemeden sonra mağazaya döndüğünde onaylanır. Webhook, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentisi isteklerini geçirir ve OpenCart 4'te eklenti, webhook'un ve müşterinin HyperPay'den dönüşünün geçmesine izin veren bir başlangıç eylemi ekler.

Payment

Transaction Type: kartın nasıl tahsil edileceği.

Payment Brands: ödeme arayüzünde gösterilen markalar: VISA, Mastercard, mada, American Express, STC Pay, Apple Pay. Varsayılan: VISA ve Mastercard. Hiçbir marka işaretli değilse sayfa uyarır ve arayüz VISA ile Mastercard'ı gösterir. Yalnızca HyperPay'in Entity ID'niz için etkinleştirdiği markaları seçin; mada, STC Pay ve Apple Pay genellikle kendi kuruluşlarını kullanır ve bu eklenti bunu desteklemez.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, HyperPay ödemeyi onayladıktan sonra bir durum alır. Reddedilen veya terk edilen bir ödeme siparişi durumsuz bırakır ve sepet korunur. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler. OpenCart'ta «On hold» durumu yoktur, bu nedenle bunlardan üçü varsayılan olarak Beklemede'dir; kendi durumlarınızı System > Localisation > Order Statuses bölümünde oluşturabilir ve burada seçebilirsiniz.

Order Status After Payment: HyperPay, doğru tutar ve para birimiyle bir tahsilatı onayladığında veya bir ön yetkilendirme tahsil edildiğinde ayarlanır. Varsayılan: İşleniyor.

Authorized (Capture Required) Status: bir ön yetkilendirme tutarı ayırdı; bunu sipariş sekmesinde tahsil edin. HyperPay panelindeki bir iptal, sipariş bu durumdayken siparişi iptal eder. Varsayılan: Beklemede.

Awaiting Payment Status: HyperPay, onay bekleyen bir ödeme bildirdi; webhook bunu daha sonra onaylar. Varsayılan: Beklemede.

On Hold (Review) Status: ödenen tutar veya para birimi siparişten farklıdır ya da sipariş iptal edildikten sonra bir ödeme gelmiştir. Bir not nedeni açıklar. Varsayılan: Beklemede.

Canceled Status: ön yetkilendirme HyperPay'de iptal edildiğinde ayarlanır. Bu durumdaki bir siparişe yapılan ödeme, siparişi yeniden açmak yerine beklemeye alır. Varsayılan: İptal Edildi.

Refunded Status: bu durumdaki bir siparişe alınan ödeme yalnızca not edilir; sipariş değişmez. Varsayılan: İade Edildi.

Gelişmiş

Enable Logging: API isteklerini ve yanıtlarını OpenCart günlük klasöründeki (storage/logs) hyperpay_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında hyperpay_p_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar her zaman kaydedilir. Günlükler kart verisi, anahtar veya müşteri verisi içermez. Varsayılan: kapalı.

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

Delete Data on Uninstall: açıkken eklentinin kaldırılması ayarları ve günlük dosyalarını siler. Siparişler ve HyperPay ödeme girişimleri her zaman saklanır, çünkü geç gelen webhook'lar ve mevcut siparişlerin tahsilatları bunlara ihtiyaç duyar. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Access Token'lar ve webhook anahtarları dışa aktarılmaz.

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

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card (HyperPay)). Confirm Order adımında müşteri açıklamanızı görür. OpenCart siparişi bu adımda, yine durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı ve para birimi için bir HyperPay ödeme oturumu hazırlar ve mağazanızın HyperPay arayüzü ile Please complete your payment below: yazısı bulunan HyperPay payment sayfasını açar. HyperPay destekliyorsa arayüz müşterinin dilini kullanır. Test modunda sayfa Test mode: use a HyperPay test card, no real payment will be made. gösterir. Müşteri kart bilgilerini arayüze girer ya da Choose another payment method bağlantısını izleyerek ödeme sayfasına döner. Sayfa yenilenirse sipariş tutarı değişmediği sürece aynı ödeme oturumu en fazla 25 dakika yeniden kullanılır; bu süreden sonra yeni bir oturum hazırlanır.

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. OpenCart 4 varsayılan olarak fatura adresi istemez; bu durumda eklenti, teslimat adresini fatura adresi olarak HyperPay'e gönderir.

Ödemeden sonra müşteri mağazanıza döner. Eklenti, ödemenin bu siparişin ödeme oturumlarından birine ait olduğunu doğrular ve sonucu, oturumun oluşturulduğu modda, sunucudan sunucuya bir istekle HyperPay'den ister. Sipariş yalnızca HyperPay onayladığında ödenmiş olarak işaretlenir: bu istekle ya da webhook ile. Tutar ve para birimi siparişle eşleşmelidir. Aynı anda gelen bir dönüş ve webhook ile aynı sepete ait iki siparişin sonuçları sırayla işlenir, böylece ödeme asla iki kez uygulanmaz. Sipariş ardından 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.

Ödeme tamamlanamadıysa müşteri ödeme sayfasına bir mesajla döner: Payment failed: ve HyperPay'in nedeni, Payment was not completed. Please try again. ya da We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again. Sepet korunur ve müşteri yeniden ödeyebilir. Ödeme formu hazırlanamazsa müşteri Confirm Order adımında düğmenin üstünde kısa bir mesajla kalır; örneğin ödeme sağlayıcısının bazı fatura bilgilerini kabul etmediğini ya da bir yapılandırma hatası nedeniyle ödeme formunun kullanılamadığını belirten bir mesaj. Teknik neden günlüğe yazılır.

OpenCart 4'te bu 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ının siparişini günceller, bu nedenle reddedilen bir ödemeden sonra müşteri aynı siparişi yeni bir ödeme denemesiyle öder. Aynı sepet zaten başka bir sipariş üzerinden ödenmişse müşteri yeniden ödeme yapmak yerine başarı sayfasına yönlendirilir. Yeni miktar dahil sepette yapılan bir değişiklik, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu sipariş bu arada ödeme yapılmadan kapatılmışsa (örneğin siz iptal ettiyseniz), müşteri Payment failed. Please try again or use another card. mesajıyla ödeme sayfasına geri gönderilir. Sipariş ödenmiş, sonra iptal edilmiş ya da iade edilmişse mesaj Your previous order was closed by the store. Please confirm the order again to pay with a new order. olur. Sipariş zaten ödenmişse ve sepette artık yeni bir satın alma varsa mesaj Your previous order #(numara) has already been placed. Your cart has changed: please confirm the new order to pay for it. olur. Her durumda bir sonraki Confirm Order işlemi sepet için yeni bir sipariş öder. Ödenmiş bir sipariş, farklı bir sepet için asla ödenmiş gibi gösterilmez.

Tutarlar, HyperPay API'sinin gerektirdiği şekilde iki ondalık basamakla gönderilir. 3 ondalık basamaklı para birimlerinde (KWD, BHD, JOD, OMR) sipariş tutarı iki ondalık basamağa yuvarlanır.

Eklentinin OpenCart'tan iade veya iptal, kayıtlı kart veya tokenizasyon, abonelik, Apple Pay alan adı doğrulaması, marka başına ayrı kuruluş ve Tabby, Tamara ya da diğer şimdi-al-sonra-öde yöntemleri gibi özellikleri yoktur.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri ödeme sayfasına gönderildi ve ödeme yapmadı, ödeme reddedildi ya da HyperPay ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.

Order Status After Payment (default Processing): bir banka kartı tahsilatı onaylandı veya bir ön yetkilendirme tahsil edildi. Bir not, HyperPay sonuç kodunu, açıklamasını ve ödeme kimliğini gösterir. HyperPay ödemeyi manuel incelemeye işaretlediyse not bunu belirtir; göndermeden önce HyperPay panelinde kontrol edin.

Authorized (Capture Required) Status (default Pending): tutar bir ön yetkilendirme ile ayrıldı. Sipariş sekmesinde ya da HyperPay panelinde tahsil edin; tahsilat webhook'u siparişi bundan sonra Order Status After Payment durumuna taşır.

Awaiting Payment Status (default Pending): HyperPay ödemeyi beklemede olarak bildirdi. HyperPay onayladığında sipariş Order Status After Payment durumuna geçer.

On Hold (Review) Status (default Pending): HyperPay, siparişten farklı bir tutar veya para birimi bildirdi (örneğin ödeme sayfası açıldıktan sonra sepet değiştirildi) ya da ödeme sipariş iptal edildikten sonra geldi. Not nedeni açıklar. Ödemeyi HyperPay panelinde kontrol edin, ardından siparişi tamamlayın ya da ödemeyi iade edin.

Canceled Status (default Canceled): bir ön yetkilendirme HyperPay panelinde iptal edildi ve iptal webhook'u yetkilendirilmiş siparişi iptal eder.

Reddedilen bir sonuç, zaten bir durumu olan siparişi asla değiştirmez. Zaten ödenmiş bir sipariş için başka bir başarılı ödeme gelirse ya da zaten ödenmiş bir sepetin başka bir siparişi ödenirse, ödenmiş sipariş değişmez. Bir not, kopya ödemeyi HyperPay panelinde iade etmenizi ister. Refunded Status durumundaki bir sipariş için yapılan başarılı bir ödeme yalnızca bir not ekler.

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

VibeFox HyperPay Payment Gateway sekmesi

Sales > Orders bölümünde HyperPay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox HyperPay Payment Gateway sekmesi; ödeme kimliğini (tahsilattan sonra tahsilat kimliğini de), test ödemeleri için Test mode etiketini, işlem türünü, ödeme sayfası kimliğini, satıcı işlem kimliğini, HyperPay'e gönderilen tutarı, sonucu ve siparişin HyperPay notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

Tahsilat

Henüz tahsil edilmemiş, ön yetkilendirmeli bir sipariş için sekme tutarla birlikte Capture payment gösterir. Tıklayın ve Capture the pre-authorized amount through HyperPay? sorusunu onaylayın. Ön yetkilendirmenin yapıldığı modda mevcut sipariş tutarı tahsil edilir; bu nedenle o modun Access Token ve Entity ID bilgileri ayarlanmış olmalıdır. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). Başarılı bir tahsilattan sonra sipariş Order Status After Payment durumunu alır ve tahsilat kimliği sekmeye ve notlara eklenir. Durum doğrudan yazılır; sipariş e-postaları gönderilmez ve stok güncellenmez. HyperPay tahsilatı reddederse sonuç kodu ve açıklama gösterilir, notlara eklenir ve sipariş yetkili kalır. Çift tıklama iki kez tahsilat yapmaz. Bir ön yetkilendirmenin iptali (void) HyperPay panelinde yapılır.

İadeler

OpenCart'tan yapılan iadeler desteklenmez. Sales > Returns bölümündeki ürün iadeleri HyperPay üzerinden para geri göndermez. Ödemeyi HyperPay panelinde iade edin. HyperPay'de yapılan iadeler ve itirazlar, webhook tarafından siparişe not olarak eklenir; sipariş durumu değişmez. Gerekirse durumu elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox HyperPay Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox HyperPay Payment 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 tarihi 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: opencart-payment-hyperpay 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 yetkisine sahip 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 açıklar; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihle birlikte License expired on. Mağaza adresi değiştikten sonra ya da 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 bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. 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 yoksa HyperPay ö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önetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada yine görür ve (unlicensed — visible to admins only) etiketiyle işaretlenir; böylece bir 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 herkes için gizlidir. Edit sayfasını bir kez açtıktan sonra yönetim panelinin 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 onaylanmaya devam eder, tahsilat 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. Durum, yönetim panelindeki Dashboard veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtarın girildiği tarihten sonraki ilk 14 gün boyunca günde bir kez, sonra haftada bir kez. Cron işi gerekmez. Eklentinin kaldırılması her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

HyperPay ö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 Access Token ile Entity ID bilgisine sahip olduğunu kontrol edin: test modunda test bilgileri, canlı modda canlı bilgiler. Eksikse ayarlar sayfası bir uyarı gösterir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total tutarına ulaştığını kontrol edin.

Ödeme yapıldı, ancak sipariş durumsuz kaldı: webhook çalışmıyor ve müşteri mağazaya dönmedi. HyperPay panelinde, kullandığınız mod için ödeme webhook'unun var olduğunu, URL'sinin Webhook URL alanında gösterilenle tam olarak aynı olduğunu ve şifre çözme anahtarının aynı modun webhook anahtarı alanında bulunduğunu kontrol edin. Enable Logging seçeneğini açın ve eklenti sayfasındaki Log alanına bakın.

Webhook Decryption failed yanıtı veriyor: webhook anahtarı başka bir webhook'a ya da başka bir moda ait. Anahtarı HyperPay panelinden yeniden kopyalayın.

Webhook Webhook key not configured yanıtı veriyor: geçerli bir webhook anahtarı ayarlanmamış. Ayarlara 64 karakterlik anahtarı yapıştırın. HyperPay webhook'u yeniden dener.

Webhook Busy, retry later yanıtı veriyor: sipariş tam o sırada başka bir istek tarafından işleniyordu ya da sipariş durumu ayarlanamadı. HyperPay webhook'u yeniden dener. Nedeni günlükte yazılıdır.

Günlükte Webhook ignored görünüyor: ödeme bu mağazanın bir siparişine ait değil ya da diğer modda yapıldı. Test ve canlı ödemeler ayrı tutulur.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca HyperPay'den gelen POST isteklerini kabul eder.

Ödeme formu yüklenmiyor: günlüğe bakın. Yapılandırma hatası genellikle geçerli mod için yanlış bir Access Token veya Entity ID anlamına gelir. Fatura bilgileriyle ilgili bir mesaj, HyperPay'in müşteri verilerinin bir kısmını kabul etmediği anlamına gelir. Seçili Payment Brands markalarının Entity ID'niz için etkin olduğundan emin olun.

Müşteri The payment session was not found. Please confirm the order again.: mesajını görüyor: ödeme sayfası bağlantısı bu sipariş için artık geçerli değil. Müşteri siparişi ödeme sayfasında yeniden onaylar.

Order is in the on hold status: sipariş sekmesindeki notları okuyun (bkz. Sipariş durumları), ödemeyi HyperPay panelinde kontrol edin, ardından siparişi tamamlayın ya da ödemeyi iade edin.

Tahsilat başarısız oluyor: sekmedeki ve notlardaki sonuç kodunu ve açıklamayı okuyun. Tahsilat ön yetkilendirmenin modunda gönderilir; bu nedenle o modun kimlik bilgileri ayarlanmış olmalıdır, aksi halde sekmede o modun Access Token / Entity ID bilgilerinin boş olduğu belirtilir.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments seçin ve VibeFox HyperPay Payment Gateway yanındaki Uninstall düğmesine (kırmızı −) 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. OpenCart 4'te ayrıca eklentinin olayları ve bakım modunda webhook'un ve müşterinin dönüşünü geçiren başlangıç eylemi de kaldırılır. Delete Data on Uninstall açıksa diğer ayarlar (başlık, açıklama, test modu, kimlik bilgileri, webhook anahtarları, işlem türü, markalar, günlükleme) ve günlük dosyaları silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanır. HyperPay ödeme girişimleri her zaman saklanır; böylece geç gelen webhook'lar ve mevcut siparişlerin tahsilatları 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ırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox HyperPay Payment Gateway yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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