VibeFox Conekta for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: ödeme sayfasındaki para birimi MXN veya USD olmalıdır. Diğer para birimlerinde ödeme yöntemi gizlenir.

Conekta hesabı: Conekta hesabınızın özel API anahtarlarına (test ve canlı) ve Conekta panelinde bir webhook'a ihtiyacınız vardır (bkz. Configuration). Yalnızca özel anahtarlar kullanılır. Ödeme, Conekta'nın barındırdığı ödeme sayfasında gerçekleştiği için genel anahtara gerek yoktur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_conekta_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_conekta_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önetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_conekta_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, 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 Conekta 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 yetkisi olmalıdır.

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

4. Test ve canlı özel anahtarlarınızı girin, modu seçin ve Conekta panelinde webhook'u ekleyin (bkz. Configuration).

5. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Test modunda bir ödeme deneyin, ardından Test mode seçeneğini kapatın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_conekta_gateway.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: 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 bölümüne gidin ve tür olarak Payments seçin. VibeFox Conekta Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını, Conekta anahtarlarını ve webhook'u OpenCart 3 için 3 ila 5. adımlardaki 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 test modu açık olarak başlar.

Configuration

Tüm ayarlar eklentinin sayfasındadır: Extensions > Extensions > Payments > VibeFox Conekta Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, Conekta etkinken mevcut modun özel anahtarı boşsa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi MXN veya USD değilse sizi uyarır. Test modu açıkken sayfa Test mode is on: payments are simulated with the test private key. mesajını gösterir. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir, ancak kaydedemez.

Kaydederken Title boş olamaz, Sort Order tam sayı olmalıdır, Total negatif olmayan bir sayı olmalıdır ve seçilen coğrafi bölge ile sipariş durumları mevcut olmalıdır. Herhangi bir kontrol başarısız olursa hiçbir şey kaydedilmez ve sayfa hataları listeler. İki uyarı kaydetmeyi engellemez: hiçbir ödeme yöntemi seçilmediğinde (bu durumda kart ödemeleri sunulur) ve ağ geçidi, mevcut modun özel anahtarı olmadan etkinleştirildiğinde.

Conekta

Enable / Disable: Enable Conekta payments ödeme yöntemini açar veya kapatır. Default: off.

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

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Default: Pay securely with card, OXXO cash or SPEI transfer. Ödemenizi tamamlamak için Conekta'ya yönlendirileceksiniz.

Payment methods: Conekta ödeme sayfasında sunulan yöntemler. Default: card, cash and bank transfer. Nakit, SPEI ve BNPL yalnızca MXN siparişleri için kullanılabilir (USD siparişleri yalnızca kart alır) ve Conekta hesabınızda etkinleştirilmelidir. Hiçbir şey seçilmezse kart kullanılır.

Sort Order: ödeme sayfasında ödeme yöntemleri arasında Conekta'nın konumu. Boş bırakın veya tam sayı girin.

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

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

API anahtarları

Özel anahtarlarınızı Conekta panelinde Developers > API keys altından kopyalayın (sayfada panele bir bağlantı bulunur). Test ve canlı anahtarlar farklıdır.

Test mode: test özel anahtarını kullanır. Gerçek para tahsil edilmez ve müşteri Confirm Order adımında TEST MODE — No real charges will be made. mesajını görür. İadeler her zaman ödemenin yapıldığı modun anahtarını kullanır. Default: on.

Test private key: Conekta hesabınızın test modundaki özel API anahtarı.

Live private key: Conekta hesabınızın canlı modundaki özel API anahtarı. Gizli tutun.

Kaydedilmiş anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir anahtarı kaldırmak için alanın altındaki Clear the saved key on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Her Conekta siparişi kendi modunu hatırlar: bildirimler ve iadeler eşleşen anahtarı kullanır. Eski test siparişleri hâlâ açıksa her iki anahtarı da dolu tutun.

Webhook

Webhook, mağazanıza ödemeler hakkında bilgi verir; örneğin müşteri Conekta sayfasından ayrıldıktan sonra yapılan OXXO veya SPEI ödemeleri gibi. Conekta panelinde Developers > Webhooks bölümüne gidin ve bu bölümde Webhook URL altında gösterilen URL'yi hem test hem canlı mod için ekleyin. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_conekta_gateway/webhook, OpenCart 4'te ise şuna benzer: https://your-store/index.php?route=extension/wcp_conekta_gateway/payment/wcp_conekta_gateway.webhook. Bu adres OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın. İnternetten erişilebilir olmalıdır.

Bu olayları seçin (bu bölümde de listelenmişlerdir):

Webhook gövdesi yalnızca eklentiye hangi Conekta siparişinin değiştiğini bildirir. Her bildirim, siparişi modunun özel anahtarıyla Conekta API'sinden yeniden okuyarak doğrulanır; webhook'un Digest imza başlığı kullanılmaz. Bu mağaza tarafından o sipariş için oluşturulmamış Conekta siparişlerine ait bildirimler onaylanır ve yok sayılır. Webhook olmadan bir sipariş, müşteri ödemeden sonra mağazaya döndüğünde veya aynı sepet için bir sonraki ödeme denemesinde onaylanır.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, Conekta ödemeyi bildirdikten sonra, webhook ile veya müşteri geri döndüğünde bir durum alır; sipariş her zaman Conekta'dan yeniden okunur. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: doğrulanmış bir Conekta ödemesinden sonra ayarlanan durum. Default: Processing.

Awaiting Conekta Payment Status: müşteriye bir OXXO veya SPEI referansı verildi ve Conekta henüz parayı almadı. Default: Pending.

Conekta Payment On Hold Status: ödendi, ancak tutar veya para birimi siparişle eşleşmiyor, canlı modda bir TEST ödemesi geldi, sipariş zaten iptal edilmişti veya ödeme yalnızca ön provizyonludur. Bir not nedenini açıklar. Default: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumlarınızı oluşturabilir ve burada seçebilirsiniz.

Payment Expired / Canceled Status: Conekta referansının süresi dolmuş veya Conekta siparişi iptal edilmiş, ödeme bekleyen bir sipariş. Default: Canceled.

Refunded Status: ödeme, sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Default: Refunded.

Gelişmiş

Debug log: API çağrılarını ve bildirimleri OpenCart günlük klasöründeki (storage/logs) wc_ckt_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar, bu anahtar kapalı olsa bile her zaman kaydedilir. Günlükler hiçbir zaman API anahtarlarını veya müşteri iletişim bilgilerini içermez. Default: off.

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

Delete data on uninstall: açıksa eklentiyi kaldırmak ayarları ve günlüğü siler. Conekta işlemleri ve iadeleri ile siparişler her zaman korunur; böylece eski siparişler yeniden yüklemeden sonra da onaylanabilir ve iade edilebilir. Default: off.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak 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 sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Conekta). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to Conekta to complete your 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 sipariş tutarı için bir Conekta siparişi oluşturur; ürünler, ek ücretler, indirimler, vergiler ve kargo dahil edilir ve müşteriyi Conekta'nın barındırdığı ödeme sayfasına gönderir. Müşterinin adı, e-posta adresi, telefonu ve teslimat adresi Conekta'ya aktarılır ve ödeme Conekta sayfasında Order # ve sipariş numarası olarak görünür. Müşteri orada izin verilen yöntemlerden biriyle öder. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Mağaza bir ödeme adresi istemezse (OpenCart 4 varsayılanı), fatura bilgileri teslimat adresinden ve müşterinin adından alınır.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca Conekta ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, webhook geldiğinde ve müşteri geri döndüğünde siparişi Conekta API'sinden okur. Sipariş ardından OpenCart'ın standart yöntemiyle durumunu alır; olağan sipariş e-postaları ve stok güncellemesi yapılır ve müşteri OpenCart sipariş başarı sayfasını görür. Müşteri OXXO veya SPEI'yi seçip bir ödeme referansı aldığında sipariş Awaiting Conekta Payment Status durumunu alır ve başarı sayfasında Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received. mesajı gösterilir. Beklemede olan bir sipariş için sayfa We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again. mesajını gösterir.

Müşteri geri döndüğünde ödeme henüz onaylanamazsa, Payment confirmation sayfası aynı metni ve bir Check again düğmesini gösterir. Webhook, geldiği anda sipariş durumunu ayarlar. OpenCart 4'te Conekta müşteriyi geri gönderdiğinde tarayıcı mağazanın oturumunu iletmez; bu nedenle eklenti önce kısa bir sayfa gösterir ve aynı dönüş adresini mağazanızdan yeniden açar. Müşteri sepetini ve oturumunu korur.

Ödeme reddedilirse sipariş durumsuz kalır ve müşteri The Conekta payment was not completed. Please try again or choose another payment method. mesajıyla ödeme sayfasına geri döner. Ödeme sayfasının süresi dolmuşsa veya iptal edilmişse mesaj The Conekta payment has expired or was cancelled. Please try again. olur. Bu mesajlar OpenCart 4'te ödeme sayfasının üstünde gösterilir. Sepet korunur. Her yeni denemede (OpenCart 3, Confirm Order adımı gösterildiğinde her seferinde yeni bir sipariş oluşturur; OpenCart 4 ödeme sayfası için tek bir sipariş tutar ve onu günceller) önce sepetin önceki Conekta ödeme sayfaları okunur. Aynı siparişin, aynı tutarla açık bir ödeme sayfası yeniden kullanılır; aksi halde yenisi oluşturulmadan önce öncekisi Conekta'da iptal edilir, böylece eski bir bağlantı iki kez ödenemez. Önceki bir ödeme sayfası zaten ödenmişse, tekrar tahsilat yapmak yerine siparişi onaylanır. Bir sepet yalnızca bir kez ödenir: aynı sepetin başka bir siparişi zaten bir Conekta ödemesine veya verilmiş bir OXXO / SPEI referansına sahipse yeni bir ödeme başlatılmaz ve müşteri başarı sayfasına gider. Aynı sepet için ikinci bir ödeme yine de gelirse, o siparişte durum yoktur ve ödenmiş sipariş, mükerrer ödemeyi Conekta panelinden iade etmeniz için bir not alır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu sipariş bu arada kapatılmışsa (örneğin OXXO veya SPEI referansının süresi dolduysa ya da siz iptal ettiyseniz), Confirm Order müşteriyi The Conekta payment has expired or was cancelled. Please try again. mesajıyla ödeme sayfasına geri gönderir ve sonraki Confirm Order sepet için yeni bir sipariş öder. Sipariş zaten bir duruma sahipse ve sepet o zamandan beri değiştiyse (başka ürünler veya adetler), müşteri ödeme sayfasına geri gönderilir ve değişen sepet yeni bir sipariş ile kendi ödemesini alır.

Conekta ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde kısa bir mesaj görür; örneğin The payment could not be started. Please try again in a moment or choose another payment method. Conekta'dan gelen, asgari tutar gibi doğrulama mesajları, Conekta'nın gönderdiği biçimde gösterilir. Teknik neden günlüğe yazılır.

Webhook, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentilerinin isteklerine izin verir, OpenCart 4'te ise eklenti webhook için bir başlangıç eylemi ekler.

Eklenti ödemeleri yalnızca Conekta sayfasında alır. Ödeme sayfanızda kart formu yoktur; kayıtlı kart, abonelik, ön provizyon ve tahsilat ya da aylık taksit (MSI) desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

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

Order Status After Payment (default Processing): Conekta ödemeyi aynı tutar ve para birimiyle onayladı. Bir not, ödeme yöntemini (örneğin kart markası ve son dört hane, OXXO / nakit veya SPEI havalesi), Conekta siparişini ve tahsilatı gösterir.

Awaiting Conekta Payment Status (default Pending): müşteri bir OXXO veya SPEI ödeme referansı aldı. Conekta ödemeyi bildirdiğinde sipariş Order Status After Payment durumuna geçer.

Conekta Payment On Hold Status (default Pending): Conekta'dan alınan tutar veya para birimi siparişle eşleşmiyor, mağaza canlı modda iken test modunda bir ödeme geldi (gerçek para tahsil edilmedi) veya ödeme zaten iptal edilmiş bir sipariş için geldi. Not bunu açıklar. Siparişi kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin. Conekta'da yalnızca ön provizyonlu olan bir sipariş de bir notla beklemeye alınır; Conekta panelinde tahsil edilmesi veya iptal edilmesi istenir.

Payment Expired / Canceled Status (default Canceled): beklemedeki bir siparişin OXXO veya SPEI referansının süresi doldu veya Conekta siparişi iptal edildi.

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

Ödenmiş veya iade edilmiş bir sipariş hiçbir zaman düşürülmez veya yeniden açılmaz. Zaten ödenmiş bir sipariş için başka bir Conekta ödemesi gelirse, bir WARNING notu sizden bunu Conekta panelinde iade etmenizi ister.

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

VibeFox Conekta Gateway sekmesi

Sales > Orders bölümünde Conekta ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Conekta Gateway sekmesi; test ödemeleri için Test mode etiketiyle Conekta order'ı, Charge'ı, ödemenin Status'unu, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Conekta notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Conekta Gateway sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) girin ve Refund via Conekta düğmesine tıklayın. Refund this amount through Conekta? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İadeler, Conekta'nın gerçekten tahsil ettiği tutar ve para birimiyle sınırlıdır; bu nedenle bir tutar uyuşmazlığından sonra, sipariş toplamına değil müşterinin ödediği tutara kadar iade yapabilirsiniz. İade, ödemeyi içeren Conekta siparişine gider ve ödemenin yapıldığı modun anahtarını kullanır; bu nedenle o anahtarın girilmiş olması gerekir. Conekta iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara tutar, mod, Conekta siparişi, iade kimliği ve neden ile birlikte eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoğa geri koymadan, elle yapılan bir durum değişikliği gibi Refunded Status durumuna alır. Kısmi iade durumu değiştirmez. İadeler, Conekta ödemeyi bildirdikten sonra kullanılabilir.

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

Conekta panelinde yapılan iadeler webhook ile gelir ve hem Conekta'da hem OpenCart'ta iade edilen tutarla birlikte bir not olarak eklenir. Otomatik olarak kaydedilmezler. Refund via Conekta kullanmadan siparişi elle güncelleyin. Conekta'nın bildirdiği bir chargeback de not olarak eklenir.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Conekta Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Conekta 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-conekta satırı ve hesabınızda vibefox.net'i 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önetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini bildirir; ö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ı 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 yoksa Conekta, ö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 (unlicensed — visible to admins only) işaretiyle yine görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetici paneli Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışmaya devam eder.

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ını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Conekta ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, mevcut modun özel anahtarının doldurulduğunu (test modunda Test private key, canlı modda Live private key) ve ödeme sayfası para biriminin MXN veya USD olduğunu kontrol edin. Anahtar eksikse veya mağaza para birimi desteklenmiyorsa ayarlar sayfası bir uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme başarılı oldu, ancak sipariş durumsuz kaldı: webhook çalışmıyor. Conekta panelinde, kullandığınız mod (test veya canlı) için webhook'un var olduğunu, URL'sinin Webhook URL altında gösterilenle birebir aynı olduğunu ve olayların seçili olduğunu kontrol edin. Her bildirim bu anahtarla doğrulandığı için o modun özel anahtarının ayarlandığını kontrol edin. Müşteri mağazaya döndüğünde veya aynı sepeti yeniden ödemeyi denediğinde sipariş de durumunu alır.

Webhook Temporarily unavailable yanıtı veriyor: Conekta API'sine ulaşılamadı, siparişin modunun özel anahtarı eksik, sipariş başka bir istek tarafından işleniyordu veya sipariş durumu ayarlanamadı. Conekta webhook'u yeniden dener. Nedeni görmek için Log alanına bakın.

Webhook Verification failed, Invalid payload veya Invalid order id yanıtı veriyor: Conekta API siparişi onaylamadı veya bildirim geçerli bir Conekta sipariş olayı değildi.

Webhook Ignored yanıtı veriyor: bildirim, bu mağaza tarafından o sipariş için oluşturulmamış bir Conekta siparişine (örneğin başka bir mağaza veya aynı hesaptaki bir ödeme bağlantısı) ya da siparişten başka bir nesneye aittir.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Conekta'dan gelen istekleri kabul eder.

Müşteri We could not check the status of your previous payment attempt mesajını görüyor: sepetin önceki Conekta ödeme sayfası okunamadı, bu nedenle çift ödemeyi önlemek için yenisi oluşturulmadı. Birazdan tekrar deneyin.

Müşteri Payment gateway is not configured mesajını görüyor: mevcut modun özel anahtarı eksik.

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

Müşteri Payment verification failed mesajını görüyor: Conekta'dan gelen dönüş bağlantısı siparişle eşleşmedi. Siparişi Conekta panelinde kontrol edin; webhook yine de gerçek bir ödemeyi onaylar.

Sipariş beklemede veya beklemeye alınmış durumda: siparişin sekmesindeki Conekta notes kayıtlarını okuyun. Müşteri henüz OXXO veya SPEI referansını ödemedi, tutar veya para birimi eşleşmedi, mağaza canlı modda iken test modunda bir ödeme geldi veya ödeme yalnızca ön provizyonludur.

Sekmede iade formu yok: sekme nedenini bildirir: Conekta ödemeyi henüz bildirmedi, tamamen iade edildi, kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok veya ödemenin modunun özel anahtarı girilmemiş.

İade test veya canlı moduyla ilgili bir mesajla başarısız oluyor: ödeme o modda yapıldı ve özel anahtarı girilmemiş. Anahtarı girin ve yeniden deneyin.

Geliştiriciler için: OpenCart olayları wc_ckt_supported_currencies, wc_ckt_order_request, wc_ckt_allowed_payment_methods ve wc_ckt_refund_reason, diğer eklentilerin desteklenen para birimlerini, Conekta sipariş isteğini, ödeme yöntemlerini ve iade nedenini değiştirmesine olanak tanır.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Conekta 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 webhook'un bakım modundan geçmesini sağlayan 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, ödeme yöntemleri, test modu, özel anahtarlar, günlük kaydı) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Conekta işlemleri ve iadeleri her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te yüklenen dosyaları da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Conekta 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.

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