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

Quickpay hesabı: Quickpay yöneticisinden iki değere ihtiyacınız var: bir API kullanıcısının API anahtarı (ödeme oluşturmak, tahsil etmek ve iade yapmak için) ve hesabın özel anahtarı (Quickpay geri çağrılarının imzasını doğrulamak için). Quickpay'de başka bir şey kurmanız gerekmez. Quickpay geri çağrılarının ulaşabilmesi için mağazanızın internetten erişilebilir olması, parola korumalı olmaması gerekir.

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

Kurulum

İndirme dosyası, 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_quickpay_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_quickpay_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı her 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_quickpay_gateway-oc3-(version).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, arşivdeki 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 Quickpay 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ündeki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Quickpay yöneticisindeki API anahtarını ve özel anahtarı yapıştırın ve Test API key düğmesine tıklayın (bkz. Yapılandırma).

5. Tahsilat modunu ve ödeme sonrası sipariş durumunu seçin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Quickpay hesabınız test modundayken Test payments seçeneğini açın ve bir Quickpay test kartıyla ödeme yapın.

OpenCart 4

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

2. Paket, aynı sayfadaki kurulu uzantılar 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 Payments türünü seçin. VibeFox Quickpay Gateway öğesini bulun, Install düğmesine (yeşil + düğmesi) tıklayın, ardından Edit düğmesine (kalem simgeli düğme) tıklayın.

4. Lisans anahtarını, Quickpay anahtarlarını ve ayarları OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca geri çağrı URL'si farklıdır (bkz. Yapılandırma).

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Quickpay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. API anahtarı ve özel anahtar ikisi de kaydedilene kadar sayfa Quickpay needs setup: enter the API key and the private key. Until both are saved the payment method is hidden at checkout. mesajını gösterir. Test payments açıkken, Quickpay hesabınız canlıya geçtiğinde kapatmanız için sayfa size hatırlatma yapar. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title 1 ila 128 karakter uzunluğunda olmalıdır, Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve coğrafi bölge ile her sipariş durumu mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez ve sayfa alanı belirtir.

Quickpay

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Quickpay. Zorunlu, en fazla 128 karakter.

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: Pay securely by card or MobilePay on the Quickpay payment page.

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

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

Total: Quickpay'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde sepet toplamı: 0 veya daha büyük bir sayı. Herhangi bir tutar için Quickpay'i sunmak üzere boş bırakın.

Quickpay API kimlik bilgileri

Quickpay yöneticisinde (manage.quickpay.net, sayfa oraya bağlantılar içerir) Settings > Integration bölümünü açın. Bir API kullanıcısının API anahtarını (Settings > Users) ve hesabın özel anahtarını kopyalayın.

Callback URL: mağazanızın geri çağrı URL'sini gösterir. OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_quickpay_gateway/callback, OpenCart 4'te https://your-store/index.php?route=extension/wcp_quickpay_gateway/payment/wcp_quickpay_gateway.callback gibi görünür ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. Quickpay her ödeme işleminden sonra (yetkilendirme, tahsilat, iade, iptal) bunu çağırır. Her ödeme, tahsilat ve iadeyle birlikte otomatik olarak gönderilir, bu nedenle Quickpay'de bir şey yapılandırmanız gerekmez.

API key: bir Quickpay API kullanıcısının API anahtarı. Ödeme oluşturmak, tahsil etmek ve iade yapmak için kullanılır.

Private key: hesabın özel anahtarı. Quickpay geri çağrılarının imzasını (HMAC-SHA256) doğrulamak için kullanılır. Bu olmadan hiçbir ödeme onaylanamaz ve geri çağrılar reddedilir.

Kaydedilmiş 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. Kaydedilmiş 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.

Test API key: bu düğme, API key alanına girilen anahtarı (alan boşsa kaydedilmiş olanı) kaydetmeden Quickpay'e kimlik doğrulamalı bir istekle sınar. Connection successful — the API key is valid., Quickpay rejected the API key., API key is not configured. veya nedenle birlikte Connection failed: yanıtını verir.

Test payments: Quickpay test kartlarıyla yapılan ödemeleri kabul eder. Quickpay'in ayrı bir sandbox'ı yoktur: Quickpay hesabınız test modundayken ödemeler test kartlarıyla yapılır ve test olarak işaretlenir. Bunu yalnızca test yaparken açın. Kapalıyken bir test ödemesi hiçbir siparişi ödenmiş olarak işaretlemez. Açıkken müşteriler Confirm Order adımında Test mode: Quickpay test cards are accepted. mesajını görür. Varsayılan: off.

Ödeme

Capture: paranın karttan ne zaman tahsil edileceği.

Order status after payment: Quickpay tahsil edilen ödemeyi onayladıktan sonra ödenmiş bir siparişin hangi durumu alacağı.

Sipariş durumları

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, yalnızca imzalı Quickpay geri çağrısından sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

"Payment accepted" status: tahsil edilen ödeme onaylandı ve tutar ile para birimi eşleşiyor. Varsayılan: Processing.

"Delivered (completed)" status: Order status after payment değeri Delivered (completed) olduğunda bunun yerine kullanılır. Varsayılan: Complete.

"Quickpay payment on hold" status: ödeme yalnızca yetkilendirilmiş ve tahsilat bekliyor, tutar veya para birimi eşleşmiyor ya da tahsilat başarısız oldu. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur; siparişteki bir not nedenini açıklar. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Cancelled status: bekleyen bir siparişin ödemesi Quickpay'de iptal edildiğinde ayarlanır. Bu eklentinin bir siparişini bu duruma getirdiğinizde, ödenmemiş ödeme bağlantısı Quickpay'de silinir (bkz. Siparişler ve iadeler). Varsayılan: Canceled.

Refunded status: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug log: OpenCart günlükler klasöründeki (storage/logs) qpg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında qpg_debug.old.log.php dosyasına taşınır. Reddedilen geri çağrılar ve Quickpay API hataları gibi hatalar ve uyarılar her zaman kaydedilir. Her istek ve geri çağrının ayrıntılarını da kaydetmek için bunu açın. API anahtarları, kart verileri ve müşteri bilgileri asla kaydedilmez. Varsayılan: off.

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

Delete data: açıkken eklentiyi kaldırmak ağ geçidi ayarlarını ve günlüğü siler. Sipariş verileri (Quickpay ödemeleri, iadeler, notlar) her zaman korunur. Varsayılan: off.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. API anahtarı ve özel anahtar 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. Kaydedilmiş anahtarlar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Quickpay). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the Quickpay payment window to complete the payment. notunu 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, sipariş para biriminde bir Quickpay ödemesi ve sipariş toplamı için bir ödeme bağlantısı oluşturur ve müşteriyi Quickpay ödeme penceresine yönlendirir. Müşteri orada, Quickpay ödeme penceresinizde etkin olan yöntemlerden biriyle öder. Müşterinin e-posta adresi Quickpay'e iletilir. Ödeme penceresi Quickpay tarafından sunulduğunda müşterinin dilinde açılır (Danca, Almanca, İngilizce, İspanyolca, Fince, Fransızca, İtalyanca, Hollandaca, Norveççe, Lehçe, İsveççe); aksi halde İngilizce açılır. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle ve Payment method options penceresinde seçer; ardından ödeme sayfasının altındaki Confirm Order düğmesine tıklar.

Ödemeden sonra müşteri mağazanıza geri döner. Dönüşün kendisi hiçbir şeyi ödenmiş olarak işaretlemez. Sipariş, yalnızca Quickpay onayladıktan sonra ödenmiş olarak işaretlenir: imzalı geri çağrı, tahsil edilen tutar ve para birimi siparişle eşleştiğinde sipariş durumunu ayarlar. Sipariş ardından OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle kendi durumunu alır ve müşteri OpenCart sipariş başarı sayfasını görür. Authorize only ile sipariş bunun yerine "Quickpay payment on hold" status durumunu alır ve ödemeyi daha sonra tahsil edersiniz. Müşteri geri döndüğünde geri çağrı henüz gelmemişse, Payment confirmation sayfası Your payment is being confirmed by Quickpay. You will receive an e-mail as soon as the order is confirmed. mesajını, Check again ve Back to checkout düğmeleriyle birlikte gösterir. Quickpay geri çağrısı daha sonra bir siparişi "Quickpay payment on hold" status durumundan ödenmiş duruma veya Cancelled status durumuna taşıdığında müşteriye e-postayla bildirim gönderilir.

Müşteri ödeme penceresinde iptal ederse ödeme bağlantısı Quickpay'de silinir ve müşteri The payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Kart reddedilirse mesaj The payment was not completed. You can try again or choose another payment method. olur. Sepet korunur. Aynı siparişin yeni bir denemesi, aynı Quickpay ödemesine ait yeni bir bağlantı alır. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; aynı sepetin önceki siparişlerinin ödeme bağlantıları bu durumda silinir, böylece eski bir bağlantı asla paralel olarak ödenemez. Sepetin bir ödemesi yetkilendirilmiş ve tahsilat bekliyorken ikinci bir ödeme başlatılmaz; müşteri Payment confirmation sayfasını görür.

OpenCart 4'te iptal ve red mesajları ödeme sayfasının üstünde gösterilir. OpenCart 4, ödeme sayfasındaki siparişi tutar ve her Confirm Order adımında günceller; bu nedenle iptal veya red sonrasında aynı sipariş, aynı Quickpay ödemesine ait yeni bir bağlantıyla ödenir. Sipariş ödeme yapılmadan bu arada kapatıldıysa müşteri Önceki siparişiniz ödeme yapılmadan iptal edildi. Yeni bir siparişle ödemek için lütfen siparişi yeniden onaylayın. mesajıyla ödeme sayfasına geri döner ve bir sonraki Confirm Order yeni bir sipariş öder. Sipariş zaten bir durum almışsa ama sepet o zamandan beri değiştiyse (yeni miktar dahil), müşteri ödeme sayfasına geri döner ve yeni sepet yeni bir siparişle ödenir.

Ödeme başlatılamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde The Quickpay payment could not be started. Please try again or choose another payment method. mesajını görür. Teknik neden günlüğe yazılır. Anahtarlar eksikse mesaj Quickpay is not available at the moment. Please choose another payment method. olur.

Geri çağrı ve müşterinin dönüşü de mağaza bakım modundayken çalışır: OpenCart 3 ödeme eklentisi isteklerini geçirir, OpenCart 4'te ise eklenti bunlar için kendi başlangıç eylemini ekler.

Eklenti yalnızca tek seferlik ödemeleri kabul eder. Abonelik veya yinelenen ödeme, kayıtlı kart, kısmi tahsilat desteği yoktur; Quickpay'e sepet veya fatura satırları göndermez ve ayrı MobilePay, Apple Pay veya Klarna yöntemleri yoktur: müşteri Quickpay ödeme penceresinizin yöntemleri arasından seçim yapar.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Quickpay'e yönlendirildi ve ödeme yapmadı, kart reddedildi ya da ödeme yetkilendirildi ve otomatik tahsilat bekliyor. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

"Payment accepted" veya "Delivered (completed)" status: Quickpay, tahsil edilen ödemeyi doğru tutar ve para birimiyle onayladı. Durum Order status after payment değerini izler. Bir not Quickpay ödeme kimliğini gösterir (test ödemeleri için TEST olarak işaretlenir).

"Quickpay payment on hold" status (varsayılan Pending): ödeme yalnızca yetkilendirilmiş ve Capture Quickpay payment bekliyor; ya da Quickpay sipariş toplamından farklı bir tutar veya para birimi bildirdi (örneğin Quickpay yöneticisinde farklı bir tutar tahsil edildi); ya da tahsilat başarısız oldu ve tutar hâlâ yalnızca ayrılmış durumda. Not bunu açıklar. Farklı bir tutar tahsil edildiğinde eklenti Quickpay'in tahsil ettiği tutarı kaydeder ve iadeler bu tutara kadar yapılabilir.

Cancelled status: bekleyen bir siparişin ödemesi Quickpay yöneticisinde iptal edildi.

Refunded status: ödeme eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş, iptal edilmiş veya iade edilmiş bir sipariş için gelen bir ödeme siparişi değiştirmez. Bir not, örneğin çift ödemeyi iade etmek için ödemeyi Quickpay yöneticisinde kontrol etmenizi ister. Aynı sepetin başka bir siparişi zaten ödenmişse yeni sipariş durumsuz kalır ve ödenmiş sipariş nota alır.

Bu eklentinin ödenmemiş bir siparişini sipariş History bölümünde Cancelled status durumuna getirdiğinizde ödeme bağlantısı Quickpay'de silinir. Yetkilendirilmiş bir siparişi iptal etmek, ayrılmış tutarı otomatik olarak serbest bırakmaz: bir not, ödemeyi Quickpay yöneticisinde iptal etmenizi hatırlatır; aksi halde ayırma, yetkilendirmenin süresi dolduğunda sona erer.

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

VibeFox Quickpay Gateway sekmesi

Sales > Orders bölümünde Quickpay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Quickpay Gateway sekmesi, test ödemeleri için Test payment etiketiyle birlikte Payment ID bilgisini, ödemenin Status bilgisini, Amount / refunded tutarlarını, siparişin tüm Quickpay ödemelerinin listesini (birden fazla varsa), tahsilat düğmesini, iade formunu, iade geçmişini ve siparişin Quickpay notes notlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir. Tahsilat ve iadeler için eklentiyi değiştirme izni gerekir (System > Users > User Groups bölümünde ayarlanır).

Tahsilat

Authorize only ile sekmedeki Capture Quickpay payment düğmesine tıklayın ve Capture the order total through Quickpay? sorusunu onaylayın. Sipariş toplamı tahsil edilir; kısmi tahsilat kullanılamaz. Quickpay hemen onaylarsa sipariş, müşteriye bildirim gönderilmeden ve stok değiştirilmeden, elle yapılan bir durum değişikliği gibi Order status after payment ödenmiş durumuna alınır. Aksi halde bir not tahsilatın istendiğini belirtir ve Quickpay geri çağrısı onayladığında sipariş ödenmiş olarak işaretlenir. Reddedilen bir tahsilat sekmede gösterilir ve siparişe not olarak eklenir.

İadeler

Sekmede Amount bilgisini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) girin ve Refund via Quickpay düğmesine tıklayın. Refund this amount through Quickpay? This cannot be undone. sorusunu onaylayın. Tahsil edilmiş ödemeler için tam ve kısmi iadeler desteklenir. İadeler, sipariş toplamında değil, Quickpay'in tahsil ettiği tutar ve para biriminde yapılır. Quickpay iadeleri eşzamansız işler: iade geçmişinde requested görünür ve geri çağrı bunu confirmed veya failed olarak ayarlar ve sonucu notlara ekler. Başarısız bir iade iade edilmiş sayılmaz. Quickpay iadeyi hemen reddederse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Tam iade, siparişi müşteriye bildirim göndermeden ve ürünleri stoğa geri eklemeden Refunded status durumuna alır; kısmi iade durumu değiştirmez. Hiç tahsil edilmemiş yetkilendirilmiş bir ödeme iade edilemez; Quickpay yöneticisinde iptal edin.

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

Quickpay yöneticisinden doğrudan yapılan iadeler yalnızca notlara eklenir. Sipariş durumu otomatik olarak değişmez. Gerekirse elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Quickpay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Quickpay 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ı maskelenmiş 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-quickpay 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önetici panelinin diline uyar (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedeni belirtir; örneğin Key not found, This key belongs to another product, Domain limit reached veya bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Quickpay ö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ı, ödeme yöntemini mağazada hâlâ görür ve (unlicensed — visible to admins only) ibaresiyle işaretlenmiş olarak görür; böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu yüzden etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatıcı görünür. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: başlatılmış ödemeler onaylanmaya devam eder ve tahsilat ile 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önetici Dashboard veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Quickpay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve hem API key hem de Private key alanlarının kaydedildiğini kontrol edin. İki anahtar da yoksa ödeme yöntemi gizlenir ve ayarlar sayfasında bir uyarı görünür. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kalıyor: Quickpay geri çağrısı mağazanıza ulaşmadı ya da reddedildi. Mağazanızın internetten erişilebilir olduğunu (parola koruması olmadan) ve Private key alanının aynı Quickpay hesabının özel anahtarı olduğunu kontrol edin. Reddedilen geri çağrılar her zaman eklenti sayfasındaki günlüğe yazılır. Her geri çağrıyı görmek için Debug log seçeneğini açın.

Günlük Callback rejected: invalid checksum. gösteriyor: ayarlardaki özel anahtar, geri çağrıyı gönderen hesaba ait değil. Quickpay yöneticisinde Settings > Integration bölümünden yeniden kopyalayın.

Günlük Callback rejected: the private key is not configured. gösteriyor: özel anahtarı girin. Geri çağrılar o olmadan asla kabul edilmez.

Günlük Callback: no order found for payment … gösteriyor: geri çağrı, bu mağazanın oluşturmadığı bir Quickpay ödemesine aittir; örneğin OpenCart dışında yapılmış bir ödeme.

Günlük sepetin başka bir istek tarafından kilitlendiğini gösteriyor: aynı sepetin başka bir geri çağrısı o anda uygulanıyordu. Geri çağrı bir hata alır, bu nedenle Quickpay onu yeniden gönderir.

Bir test ödemesi siparişi ödenmiş olarak işaretlemedi: Test payments kapalı. Günlük ve siparişteki bir not, test ödemesinin kabul edilmediğini belirtir. Test sırasında ayarı açın, hesabınız canlıya geçtiğinde kapatın.

Ödemeden sonra sipariş bekleme durumunda: VibeFox Quickpay Gateway sekmesindeki notları okuyun. Ödeme yalnızca yetkilendirilmiş olabilir ve Capture Quickpay payment bekliyor olabilir, tahsil edilen tutar veya para birimi siparişle eşleşmiyor olabilir ya da tahsilat başarısız olmuş olabilir. Tahsil edin, siparişi işleyin veya ödemeyi iade edin.

Test API key, Quickpay rejected the API key. mesajı veriyor: anahtar yanlış ya da API erişimi olmayan bir kullanıcıya ait. Quickpay yöneticisinden bir API kullanıcısının API anahtarını kopyalayın.

Müşteri The Quickpay payment could not be started. mesajını görüyor: eklenti sayfasındaki Log alanına bakın. Quickpay hatasını gösterir; örneğin Quickpay hesabınızın kabul etmediği bir para birimi.

İade başarısız oluyor: siparişin tahsil edilmiş bir Quickpay ödemesi olmalıdır. The Quickpay payment of this order has not been captured — there is nothing to refund. mesajı ödemenin yalnızca yetkilendirildiği anlamına gelir; Quickpay yöneticisinde tahsil edin ya da iptal edin. Invalid refund amount: at most … tutarın tahsil edilmiş ödemenin kalanından fazla olduğu anlamına gelir.

Geliştiriciler için: ödeme bağlantısı oluşturulmadan önce eklenti, bağlantı parametreleri ve sipariş ile birlikte OpenCart olayı qpg_quickpay_link_data tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Quickpay 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 Order statuses bölümündeki 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 geri çağrının ve müşterinin dönüşünün geçmesine izin veren başlangıç eylemi de kaldırılır). Delete data açıksa diğer ağ geçidi ayarları (başlık, açıklama, anahtarlar, test ödemeleri, tahsilat, günlüğe kaydetme) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Quickpay ödemeleri ve iadeleri her zaman korunur; böylece önceden ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

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

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