VibeFox OpenPay 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.

HTTPS: kart formu ödeme sayfanızda yer aldığı için mağazanız HTTPS kullanmalıdır.

OpenPay account: Meksika, Kolombiya veya Peru'ya ait bir OpenPay hesabı. Bu hesabın Merchant ID, özel anahtarı (sk_...) ve genel anahtarı (pk_...) gereklidir. Sandbox ve canlı panelleri farklı Merchant ID ve anahtarlara sahiptir; eklenti bunları birbirinden ayrı tutar.

Currency: müşteri, hesap ülkenizin kabul ettiği bir para biriminde ödeme yapmalıdır: Meksika — MXN veya USD, Kolombiya — COP veya USD, Peru — PEN veya USD. Diğer para birimleri için ödeme yöntemi ödeme sayfasında gösterilmez.

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

Kart, ödeme sayfanızda girilir; ancak kart bilgileri tarayıcıda openpay.js tarafından okunur ve tokenleştirilir. Kart alanlarının adı yoktur ve hiçbir zaman sunucunuza gönderilmez. Kart formu sayfanızda bulunduğu için PCI DSS kapsamınız SAQ A-EP'dir; bu konuda acquirer kuruluşunuza danışın.

Kurulum

İndirilen dosya, iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Arşivi bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_openpay_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_openpay_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_openpay_gateway-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 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 olarak Payments seçin. VibeFox OpenPay 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 iznine 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. Lisans anahtarı).

4. Account country seçeneğini belirleyin ve sandbox ile canlı anahtarlarını girin (bkz. Yapılandırma).

5. Önerilen: OpenPay panelinde webhook URL'sini ekleyin (bkz. Yapılandırma).

6. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. OpenPay sandbox test kartlarıyla bir ödeme deneyin, ardından gerçek ödeme almak için Sandbox mode seçeneğini kapatın. Sandbox siparişlerini hâlâ iade etmeniz gerekebileceği sürece sandbox anahtarlarını saklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_openpay_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ı 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 OpenPay Gateway eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, OpenPay anahtarlarını ve webhook'u OpenCart 3 için 3-6. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Webhook).

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 OpenPay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, geçerli modun anahtarları eksik olduğunda (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanızın varsayılan para birimi seçilen hesap ülkesi tarafından kabul edilmediğinde sizi uyarır; sandbox modu açıkken ise Sandbox mode is enabled — no real charges are made. mesajını gösterir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydetme sırasında anahtarlar kontrol edilir. Merchant ID yalnızca harf ve rakam içerebilir, özel anahtar sk_ ile, genel anahtar ise pk_ ile başlamalıdır. Geçersiz bir değer kaydedilmez: önceki değer korunur ve şuna benzer bir hata gösterilir: Sandbox: The private key must start with sk_. Tam sayı olmayan bir Sort Order (Sort Order must be a whole number — the previous value was kept.) ve 0 veya daha büyük bir sayı olmayan bir Total için de aynısı geçerlidir. Diğer alanlar kaydedilir. Ödeme yöntemi açık olduğu hâlde geçerli modun anahtarları eksikse, ağ geçidinin ödeme sayfasında gizli kalacağını bildiren bir mesaj da görürsünüz. Boş bir Title veya 128 karakterden uzun bir başlık Enter a title for the payment method (1 to 128 characters). mesajıyla reddedilir ve bu durumda hiçbir şey kaydedilmez.

OpenPay

Enable / Disable: Enable OpenPay card payments ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit or debit card (OpenPay). Zorunlu, en fazla 128 karakter.

Description: Confirm Order adımında kart formunun üstünde gösterilen metin. Varsayılan: Pay securely with your credit or debit card. Bankanız ödemeyi onaylamanızı isteyebilir (3D Secure).

Sort Order: OpenPay'in ödeme sayfasındaki ödeme yöntemleri arasındaki sırası. Boş bırakın veya bir tam sayı girin (negatif sayılar kabul edilir).

Geo Zone: OpenPay'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. OpenCart 4'te, mağaza ödeme adresi istemediğinde teslimat adresi kullanılır.

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

OpenPay hesabı

Merchant ID, özel anahtar (sk_) ve genel anahtar (pk_), OpenPay panelinizde Settings (Configuración) altında bulunur. Bu bölümde Meksika, Kolombiya ve Peru'nun sandbox ve canlı panellerine bağlantılar vardır.

Account country: OpenPay hesabınızın ülkesi. OpenPay API'sini, o ülkenin openpay.js kütüphanesini ve kabul edilen para birimlerini belirler. Varsayılan: Mexico.

Sandbox mode: OpenPay sandbox'ını kullanır (test anahtarları, gerçek tahsilat yok) ve hem anahtarları hem API'yi sandbox'a geçirir. Açık olduğu sürece ödeme sayfasında bir SANDBOX MODE rozeti gösterilir. Varsayılan: açık. Gerçek ödemeler almak için kapatın.

Sandbox Merchant ID: sandbox panelindeki Merchant ID, Settings (Configuración), API anahtarları.

Sandbox Private Key: sandbox özel anahtarı. sk_ ile başlar. Yalnızca sunucuda kullanılır; asla paylaşmayın.

Sandbox Public Key: sandbox genel anahtarı. pk_ ile başlar. openpay.js bunu kartı tokenleştirmek için tarayıcıda kullanır.

Live Merchant ID: canlı paneldeki Merchant ID, Settings (Configuración), API anahtarları.

Live Private Key: canlı özel anahtar (sk_...).

Live Public Key: canlı genel anahtar (pk_...).

Kayıtlı özel anahtarlar 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ı bir özel 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.

Webhook

Webhook zorunlu değildir, ancak önerilir. Müşteri 3D Secure sayfasından geri dönmediğinde, örneğin tarayıcıyı kapattıktan sonra, ödemeleri onaylar. OpenPay panelinde Settings > Webhooks bölümüne gidin ve bu bölümdeki Webhook URL alanında gösterilen URL'yi ekleyin. OpenCart 3'te URL şuna benzer: https://your-store/index.php?route=extension/payment/wcp_openpay_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_openpay_gateway/payment/wcp_openpay_gateway.webhook. Bu URL, OpenCart kurulumunuzun vitrin adresinden oluşturulur. Ayarların gösterdiği gibi, tam olarak kopyalayın. Kullandığınız her modun panelinde (sandbox ve canlı) webhook'u ekleyin.

Webhook'u eklediğinizde OpenPay bu URL'ye bir doğrulama kodu gönderir. Kod, geldiği tarihle birlikte bu bölümde görünür; böylece webhook'u OpenPay panelinde onaylayabilirsiniz. O zamana kadar bölüm No verification code received yet. ifadesini gösterir.

Eklenti şu olayları işler:

OpenPay webhook'ları imzalamaz; bu nedenle eklenti bildirimin kendisine asla güvenmez. Bildirimi yalnızca tahsilatı bulmak için kullanır, ardından tahsilatı, ödemenin yapıldığı modun ve hesap ülkesinin özel anahtarıyla OpenPay API'sinden okur. Bu mağazanın oluşturmadığı bir tahsilat için gelen bildirim yok sayılır. Webhook, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentisi isteklerine izin verir, OpenCart 4'te ise eklenti, webhook'un ve müşterinin 3D Secure'dan dönüşünün geçmesine izin veren bir başlangıç eylemi ekler.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, yalnızca OpenPay tahsilatı onayladıktan sonra bir durum alır. Reddedilen bir kart veya başarısız bir 3D Secure kontrolü siparişi durumsuz bırakır, bir not nedenini açıklar ve müşteri yeniden ödeme yapabilir. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler; kendi durumlarınızı System > Localisation > Order Statuses bölümünde oluşturabilirsiniz.

Order Status After Payment: OpenPay tahsilatı onayladı ve tutarı ile para birimi siparişle eşleşiyor. Varsayılan: Processing.

Awaiting OpenPay Payment: tahsilat devam ediyor (henüz tahsil edilmedi); webhook bunu daha sonra tamamlar veya başarısız olarak işaretler. Varsayılan: Pending.

OpenPay Payment On Hold: OpenPay, siparişten farklı bir tutar veya para birimi tahsil etti ya da sipariş iptal edildikten sonra bir tahsilat tamamlandı. Varsayılan: Pending.

Payment Error Status: OpenPay'i bekleyen veya beklemede olan bir siparişin tahsilatı başarısız oldu, iptal edildi ya da süresi doldu. Varsayılan: Failed.

Refunded Status: tahsilat sipariş sayfasından tamamen iade edilir. Kısmi iadeler yalnızca bir not ekler. Varsayılan: Refunded.

Gelişmiş

Debug log: ödeme adımlarını OpenCart günlükleri klasöründeki (storage/logs) wc_opy_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında wc_opy_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar kapalı olsa bile kaydedilir. Anahtarlar, kart verileri ve müşteri bilgileri asla kaydedilmez. Varsayılan: kapalı.

Log: günlüğün 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, ağ geçidi ayarlarını, kayıtlı webhook doğrulama kodunu ve günlüğü siler. Siparişlerin OpenPay tahsilat kayıtları ödeme geçmişinin parçasıdır ve her zaman saklanır; böylece yeniden kurulumdan sonra da siparişler iade edilebilir. Varsayılan: kapalı.

İçe / dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Özel anahtarlar 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ı özel anahtarlar korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit or debit card (OpenPay)). Confirm Order adımında müşteri sizin açıklamanızı ve kart formunu görür: Cardholder name, Card number, Expiry (MM/YY) ve Card code (CVV). Sandbox modunda form SANDBOX MODE — Test environment. No real charges will be made. ifadesini gösterir. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer; kart formu, ödeme sayfasının altındaki onay bölümünde, Confirm Order düğmesinin üstünde yer alır. Müşteri Confirm Order düğmesine tıkladığında openpay.js kartı tarayıcıda tek kullanımlık bir jetona dönüştürür ve antifraud kütüphanesi bir cihaz oturum kimliği ekler. Mağazanıza yalnızca bu iki değer gönderilir. Eksik doldurulmuş bir form, formun altında Please fill in all card fields. mesajını gösterir.

Eklenti ardından, sipariş tutarı için sipariş para biriminde 3D Secure ile tahsilatı oluşturur ve müşteriyi, OpenPay tarafından sunulan bankasının 3D Secure sayfasına yönlendirir. Her deneme kendi OpenPay sipariş referansını alır. Tahsilat açıklaması Order #, sipariş numarası ve mağaza adınızdır. Ödeme adresindeki müşterinin adı, e-posta adresi ve telefon numarası OpenPay'e iletilir; OpenPay'de bir müşteri hesabı oluşturulmaz.

Müşteri geri döndüğünde eklenti tahsilatı OpenPay API'sinden okur. Sipariş, yalnızca OpenPay onayladıktan sonra ödenmiş olarak işaretlenir: tahsilat bu siparişe ait olmalı, tamamlanmış olmalı ve sipariş tutarı ile para birimiyle tam olarak eşleşmelidir. Ardından sipariş, OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle birlikte bir durum alır ve müşteri Your card payment has been received. ifadesiyle OpenCart sipariş başarı sayfasını görür. OpenPay tahsilatın devam ettiğini bildirirse sipariş Awaiting OpenPay Payment durumunu alır ve sayfa We are confirming your card payment with OpenPay. The order will be updated automatically — please do not pay again. mesajını gösterir. Sonuç henüz bilinmiyorsa, Payment confirmation sayfası aynı metni, bir Check again düğmesi ve bir Back to checkout düğmesiyle gösterir; webhook geldiği anda sipariş durumunu ayarlar. Devam eden bir tahsilat daha sonra başarısız olursa başarı sayfası Your OpenPay card payment was not completed. Please contact us about this order. mesajını gösterir.

Kart reddedilir veya 3D Secure başarısız olursa, sipariş durumsuz kalır, bir not eklenir ve müşteri The card payment was not completed (declined or 3-D Secure failed). Please try again or use another card. mesajıyla ödeme sayfasına döner. Sepet korunur. OpenCart 4'te bu mesaj ö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 sürecindeki siparişi tutar ve günceller, böylece müşteri aynı siparişi yeni bir denemeyle yeniden öder. Yeni bir denemeden önce eklenti sepetin önceki tahsilatını kontrol eder: gerçekten ödenmişse, o sipariş ikinci bir tahsilat yapılmadan durumunu alır; hâlâ devam ediyorsa müşteri A previous payment for this order is still being processed. Please do not pay again — the order will be updated automatically. mesajını görür; durumu kontrol edilemiyorsa yeni tahsilat yapılmaz ve müşteri We could not confirm the status of your previous payment attempt. Please try again in a few minutes. mesajını görür. Zaten ödenmiş bir sepetten asla yeniden tahsilat yapılmaz.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Bu sipariş bu arada kapatılmışsa (örneğin, tahsilatı ödeme beklerken başarısız olduysa veya siz siparişi iptal ettiyseniz ya da iade ettiyseniz), müşteri This order can no longer be paid. Please reload the checkout page and confirm the order again. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişin ödemesini başlatır. Sipariş zaten bir duruma sahipse ve sepette artık başka ürünler veya adetler varsa, müşteri yine ödeme sayfasına geri gönderilir ve yeni sepet yeni bir sipariş alır.

Reddedilen kartlar açık bir mesaj alır; örneğin The card has insufficient funds. Please use another card., The card has expired. Please use another card. veya The security code (CVV) is not valid. Please check it and try again. OpenPay'in teknik hataları müşterilere asla gösterilmez; günlüğe ve sipariş notlarına gider.

Ödeme yöntemi kapalıysa, geçerli modun anahtarları eksikse veya müşteri hesap ülkesinin kabul etmediği bir para biriminde ödeme yapıyorsa, ödeme yöntemi ödeme sayfasında gizlenir.

Eklenti yalnızca kart ödemelerini kabul eder ve tahsilatları anında yapılır. Kayıtlı kartlar, abonelikler, faizsiz taksitler (MSI) veya taksitli ödemeler, kart puanlarıyla ödeme, nakit, SPEI, PSE veya CoDi ödemeleri yoktur; ayrı yetkilendirme ve tahsilat da yoktur.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri 3D Secure sayfasındadır, ödemeyi tamamlamamıştır veya kart reddedilmiştir. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

OpenCart 4'te, ödenmemiş bir sipariş Voided durumunu alabilir; bu durumu OpenCart 4, müşteri Confirm Order adımına döndüğünde ayarlar. Eklenti böyle bir siparişi durumsuz sipariş gibi değerlendirir ve sonraki bir ödeme yine de onu onaylar.

Order Status After Payment (default Processing): ödeme onaylandı. Bir not, OpenPay tahsilat kimliğini ve modu (canlı veya sandbox) gösterir.

Awaiting OpenPay Payment (default Pending): OpenPay tahsilatın devam ettiğini bildirir (henüz tahsil edilmedi). Tahsilat tamamlandığında sipariş Order Status After Payment durumuna, başarısız olursa Payment Error Status durumuna geçer.

OpenPay Payment On Hold (default Pending): OpenPay, siparişten farklı bir tutar veya para birimiyle tamamlanmış bir tahsilat bildirir (sipariş ödenmiş olarak işaretlenmez, not farkı gösterir) ya da zaten iptal edilmiş veya iade edilmiş bir sipariş için ödeme gelmiştir. Siparişi kontrol edin ve yerine getirin veya ödemeyi iade edin.

Payment Error Status (default Failed): devam eden bir tahsilat başarısız oldu, iptal edildi veya süresi doldu.

Refunded Status (default Refunded): tahsilat eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş bir sipariş veya sepet için ikinci bir tamamlanmış tahsilat gelirse, sipariş değiştirilmez. Ödenmiş siparişteki OpenPay WARNING ile başlayan bir not, mükerrer tahsilatı OpenPay panelinden iade etmenizi ister.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox OpenPay Gateway sekmesi

Sales > Orders bölümünde OpenPay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox OpenPay Gateway sekmesi; tahsilat kimliğini, tahsilat durumunu, ortamı ve hesap ülkesini (sandbox ödemeleri için Sandbox etiketiyle), Charged / order tutarlarını, iade edilen tutarı, iade formunu, iade geçmişini ve siparişin OpenPay notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Meksika ve Peru hesapları için: sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via OpenPay düğmesine tıklayın. Refund this amount through OpenPay? This cannot be undone. sorusunu onaylayın. OpenPay'in tahsil ettiği tutara kadar tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme izniniz olmalıdır (System > Users > User Groups bölümünde ayarlanır). İade, tahsilatın yapıldığı modun ve hesap ülkesinin anahtarlarıyla gönderilir; bu nedenle o modun anahtarları ayarlanmış olmalıdır. OpenPay iadeyi kabul etmezse sekme hatayı gösterir, örneğin OpenPay refund failed: ..., ve hiçbir iade kaydedilmez. Başarılı bir iade, OpenPay iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoğa geri eklemeden Refunded Status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, OpenPay ödemeyi onayladıktan sonra kullanılabilir; tutar uyuşmazlığı nedeniyle beklemede olan bir sipariş eklenti üzerinden iade edilmez.

OpenPay Kolombiya, resmi OpenPay entegrasyonlarında olduğu gibi, API üzerinden kart iadelerini desteklemez. Kolombiya tahsilatları için sekme iade formu göstermez ve nedenini açıklar; tahsilatı OpenPay panelinden iade edin.

Sales > Returns bölümündeki ürün iadeleri OpenPay üzerinden para göndermez.

OpenPay panelinde yapılan iadeler ve itirazlar webhook ile gelir ve notlara bir kez eklenir. Sipariş durumu otomatik olarak değişmez. Gerekirse durumu elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox OpenPay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox OpenPay Gateway > Edit sayfasında ayarların üstünde yer alan 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 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-openpay satırı ve hesabınızdaki vibefox.net hesabını açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify iznine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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ı boşalttı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 yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan OpenPay, ö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ı, bir anahtar satın almadan önce eklentiyi kurup test edebilmeniz için ödeme yöntemini mağazada hâlâ görür ve (unlicensed — visible to admins only) ibaresiyle işaretlenir. OpenCart 4'te bu önizleme kullanılamaz: mağaza, yönetici girişini görmez; bu nedenle etkin bir anahtar yoksa ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici paneli Dashboard sayfasında bir hatırlatma belirir. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Bir lisans sona erdiğinde 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, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

OpenPay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve geçerli modda üç anahtarın da bulunduğunu kontrol edin: sandbox modundaysa sandbox anahtarları, canlı modundaysa canlı anahtarlar. Müşterinin Account country tarafından kabul edilen bir para biriminde ödeme yaptığını kontrol edin (Meksika: MXN, USD; Kolombiya: COP, USD; Peru: PEN, USD). Ayarlar sayfası bu durumların her biri için bir uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda tanımlanan Total değerine ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kaldı: müşteri 3D Secure sayfasından geri dönmedi ve webhook çalışmıyor. Webhook URL'sinin, kullandığınız modun OpenPay panelinde, ayarların gösterdiği gibi tam olarak ve yukarıda listelenen olaylarla eklendiğini kontrol edin. Ödemenin yapıldığı modun anahtarlarının doldurulduğunu kontrol edin: anahtarlar olmadan webhook not configured yanıtı verir ve OpenPay daha sonra yeniden dener. Müşteri mağazaya döndüğünde veya aynı sepeti yeniden ödemeye çalıştığında da sipariş durumunu alır.

Webhook ignored (unknown order) yanıtı veriyor: tahsilat bu mağaza tarafından oluşturulmamış; örneğin aynı OpenPay hesabındaki başka bir mağazanın tahsilatı. Hiçbir şey değiştirilmez.

Webhook verification failed yanıtı veriyor: tahsilatı okumak için OpenPay API'sine ulaşılamadı. OpenPay webhook'u yeniden dener.

Webhook busy yanıtı veriyor: sepet aynı anda başka bir istek tarafından güncelleniyordu veya sipariş durumu ayarlanamadı. OpenPay webhook'u yeniden dener. Nedeni görmek için Debug log seçeneğini açın.

Webhook URL'si tarayıcıda invalid body gösteriyor: bu normaldir. URL yalnızca OpenPay'den gelen bildirimleri kabul eder.

Müşteri The secure card form could not be loaded mesajını görüyor: OpenPay'in openpay.js veya antifraud kütüphanesi tarayıcıda yüklenemedi ya da cihaz oturum kimliği oluşturulamadı. Müşteriden sayfayı yenilemesini ve yeniden denemesini isteyin.

Müşteri The payment could not be processed right now mesajını görüyor: OpenPay isteği reddetti veya yanıt vermedi. Neden günlükte ve sipariş notlarında yer alır. Yanlış bir Merchant ID veya özel anahtar tipik bir nedendir. OpenPay yanıt vermediyse, müşteri yeniden ödeme yapmadan önce tahsilatı OpenPay panelinden kontrol edin.

Müşteri This test card cannot be used for real payments mesajını görüyor: sandbox modu kapalıyken bir sandbox test kartı kullanıldı.

Müşteri Billing email is required for OpenPay mesajını görüyor: siparişin geçerli bir e-posta adresi yok.

Sipariş ödemeden sonra OpenPay Payment On Hold durumunda: sekmedeki OpenPay notes bölümünü okuyun (bkz. Sipariş durumları), ardından siparişi yerine getirin veya ödemeyi iade edin.

İade, mod ile ilgili bir mesajla başarısız oluyor: sipariş sandbox veya canlı modda ödenmiş ve o modun anahtarları ayarlanmamış. Anahtarları girin ve yeniden deneyin.

İade, The order is being updated right now mesajıyla başarısız oluyor: bir webhook veya başka bir istek aynı anda siparişi güncelliyordu. Biraz sonra yeniden deneyin.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox OpenPay 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ılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları ve bakım modunda webhook ile 3D Secure dönüşüne izin veren başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa, diğer ağ geçidi ayarları (başlık, açıklama, hesap ülkesi, sandbox modu, anahtarlar, günlük kaydı), kayıtlı webhook doğrulama kodu ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. OpenPay tahsilat ve iade kayıtları her zaman saklanır; böylece 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 sayfasına gidin, kurulu eklentiler listesinde VibeFox OpenPay 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.

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