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

KOMOJU hesabı: KOMOJU panelinde oluşturulmuş bir webhook'un gizli anahtarına (sk_live_... ve test modu için sk_test_...) ve gizli belirtecine (secret token) ihtiyacınız var (bkz. Yapılandırma). Herkese açık anahtar gerekli değildir. KOMOJU, mağazanızın webhook URL'sine ulaşabilmelidir.

Sipariş para birimi: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD veya VND. Diğer para birimlerindeki siparişler için ödeme yöntemi gizlenir.

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. Arşivde README.txt, OpenCart 3 paketi wcp_komoju_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_komoju_payment.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan 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_komoju_payment-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, tür olarak Payments seçin, VibeFox KOMOJU Payment eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin 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. Sayfanın üstündeki lisans bloğunda bulunan License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. KOMOJU panelinde, Webhook URL bölümünde gösterilen URL ve olaylarla bir webhook ekleyin ve gizli belirtecini kopyalayın (bkz. Yapılandırma).

5. Canlı gizli anahtarı ve canlı webhook gizli belirtecini, sandbox modu için de test anahtarlarını girin. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_komoju_payment.ocmod.zip dosyasını seçin. Dosyanın 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ı sayfada kurulu uzantıların 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, tür olarak Payments seçin, VibeFox KOMOJU Payment 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ı, webhook'u ve anahtarları 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 URL).

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, test modu açıkken KOMOJU Sandbox Mode is enabled. ifadesini gösterir. Geçerli modda gizli anahtar yoksa (bu durumda ödeme sayfasında ödeme yöntemi gizlenir) veya webhook gizli belirteci yoksa (KOMOJU bildirimleri reddedilir ve konbini ile banka havalesi ödemeleri hiçbir zaman onaylanmaz) sizi uyarır. Mağazanın varsayılan para birimini KOMOJU desteklemiyorsa da uyarır (bu durumda o para birimindeki siparişler için ödeme yöntemi gizlenir). Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title en fazla 128 karakter 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 sipariş durumları mevcut olmalıdır. Aksi takdirde hiçbir şey kaydedilmez ve sayfa alanı belirtir. Eksik anahtarlar kaydetmeyi engellemez.

KOMOJU ödemesi

Enable/Disable: Enable KOMOJU Payment Gateway ö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: KOMOJU Payment. Boş bırakırsanız varsayılan ad kullanılır. En fazla 128 karakter.

Description: Confirm Order adımında, onay düğmesinin üstünde müşteriye gösterilen metin. Varsayılan: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

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

Geo Zone: KOMOJU'yu 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 tanımlanır.

Total: KOMOJU'nun sunulabilmesi için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Herhangi bir tutar için KOMOJU sunmak istiyorsanız boş bırakın.

Canlı API anahtarları

Anahtarları KOMOJU panelinde bulabilirsiniz (orada bölümlerin bağlantıları vardır): gizli anahtar Settings > API keys altında, webhook gizli belirteci Settings > Webhooks altında (önce oraya Webhook URL bölümündeki webhook URL'sini ekleyin).

Live Secret Key: KOMOJU canlı gizli anahtarınız. sk_live_ ile başlar.

Live Webhook Secret Token: canlı webhook'un gizli belirteci. Her bildirimin imzasını doğrulamak için kullanılır.

Test modu

KOMOJU, test ve canlı ödemeler için aynı API adresini kullanır: anahtar belirler. Ödemeler yapıldıkları modu korur; bu nedenle bir siparişin iadeleri ve durum sorguları her zaman o modun anahtarını kullanır.

Sandbox Mode: Enable test mode (use the test keys below, no real payments). Varsayılan: kapalı. Açıkken Confirm Order adımı açıklamanın üstünde Test mode gösterir.

Sandbox Secret Key: KOMOJU test gizli anahtarınız. sk_test_ ile başlar.

Sandbox Webhook Secret Token: test modu webhook'unun gizli belirteci.

Kaydedilmiş anahtarlar ve belirteçler 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.

Webhook URL

Webhook, mağazanıza ödemeler hakkında bilgi verir; buna ertelenmiş konbini ve banka havalesi ödemeleri de dahildir. KOMOJU panelinde Settings > Webhooks altına, bu bölümde gösterilen URL'yi hem canlı hem test modu için ekleyin. OpenCart 3'te URL şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook biçimindedir. URL, OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi, aynen kopyalayın. Ardından her webhook'un gizli belirtecini Live Webhook Secret Token veya Sandbox Webhook Secret Token alanına kopyalayın.

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

Süresi dolan, iptal edilen ve başarısız olan olaylar siparişi yalnızca mevcut ödemesi açısından değiştirir; böylece önceki bir denemenin ödemesi, başka bir yolla ödenmekte olan bir siparişi iptal edemez. Geçerli imzası olmayan webhook'lar reddedilir. İki gizli belirteçten herhangi biriyle imzalanan webhook'lar kabul edilir, ancak yalnızca aynı moddaki ödemeler için. Webhook olmadan kart ödemeleri, müşteri mağazaya döndüğünde yine de onaylanır; ancak konbini ve banka havalesi ödemeleri hiçbir zaman onaylanmaz.

Siparişler

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

Order Status After Payment: ödeme tahsil edildi ve tutar ile para birimi doğrulandı. Varsayılan: Processing.

Awaiting KOMOJU Payment Status: ödeme yetkilendirildi: bir konbini belgesi veya banka havalesi düzenlendi ya da ödeme KOMOJU panelinde tahsil edilmeyi bekliyor. Varsayılan: Pending.

KOMOJU Payment On Hold Status: ödenen tutar veya para birimi siparişten farklı ya da ödeme, sipariş iptal edildikten sonra geldi. Bir not nedenini açıklar. Varsayılan: Pending, çünkü OpenCart'ın On hold durumu yoktur.

Cancelled Payment Status: bekleyen bir siparişin ödemesinin süresi doldu veya iptal edildi; örneğin konbini belgesi zamanında ödenmedi. Varsayılan: Canceled.

Failed Payment Status: bekleyen bir siparişin ödemesi başarısız oldu. Varsayılan: Failed.

Refunded Status: ödeme tamamen iade edildikten sonra, sipariş sayfasından veya KOMOJU panelinden ayarlanır. Varsayılan: Refunded.

Kendi durumlarınızı, örneğin Awaiting KOMOJU payment veya On hold, System > Localisation > Order Statuses bölümünde oluşturabilir ve buradan seçebilirsiniz.

Gelişmiş

Invoice Prefix: KOMOJU'ya gönderilen sipariş numaraları için önek. KOMOJU'daki numara; önek, OpenCart sipariş numarası ve kısa bir rastgele sonekten oluşur, örneğin OC-123-A1B2C3. Aynı KOMOJU hesabıyla birden fazla mağaza kullanıyorsanız, her mağaza için benzersiz yapın. Varsayılan: OC-.

Enable Logging: KOMOJU olaylarını ve API çağrılarını OpenCart günlük klasöründeki (storage/logs) komoju_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtarlar ve müşteri verileri kaydedilmez. Hatalar ve uyarılar her zaman yazılır. Varsayılan: kapalı.

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ırdığınızda ağ geçidi ayarları ve günlük silinir. Siparişler ile KOMOJU işlemleri ve iadeleri her zaman korunur; böylece eski siparişler yeniden kurulumdan sonra da onaylanabilir ve iade edilebilir. Varsayılan: kapalı.

İçe / dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Gizli anahtarlar ve webhook belirteçleri 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ş gizli anahtarlar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak KOMOJU Payment). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the KOMOJU payment page to complete the payment. notunu görür. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı ve sipariş para birimi için bir KOMOJU ödeme oturumu oluşturur ve müşteriyi KOMOJU ödeme sayfasına yönlendirir. E-posta adresi, ad, ödeme ve teslimat adresleri ile sipariş edilen ürünler KOMOJU'ya aktarılır. Sayfa, müşterinin diline göre Japonca, İngilizce veya Korece gösterilir (diğer diller için İngilizce). Orada müşteri bir ödeme yöntemi seçer. Sunulan yöntemler KOMOJU hesabınıza ve sipariş para birimine bağlıdı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 ödeme adresi sormaz; bu durumda eklenti, teslimat adresini ödeme adresi olarak iletir.

Ödemeyi yaptıktan sonra müşteri mağazanıza döner. Eklenti, ödemenin modunun anahtarıyla KOMOJU API'sinden ödeme oturumunu okur. Sipariş, yalnızca KOMOJU onayladıktan sonra ödenmiş olarak işaretlenir: imzalı webhook ile veya müşteri geri döndüğünde oturumun okunmasıyla. Sipariş daha sonra OpenCart'ın standart yoluyla durumunu alır; olağan sipariş e-postaları gönderilir ve stok güncellenir; müşteri Your payment with KOMOJU has been received. ifadesiyle OpenCart sipariş başarı sayfasını görür. Bu anda KOMOJU'ya ulaşılamazsa veya ödeme onaylanmış ama henüz uygulanmamışsa, Payment confirmation sayfası We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. mesajını ve Check again düğmesini gösterir.

Konbini ve banka havalesi ödemelerinde müşteri bir ödeme belgesi alır. Sipariş Awaiting KOMOJU Payment Status durumunu alır ve başarı sayfası, ödemenin yetkilendirildiğini ve KOMOJU'nun talimatlarına göre (örneğin bir market veya banka havalesiyle) tamamlanması gerektiğini müşteriye bildirir. Müşteri ödeme yaptığında ve KOMOJU webhook'u gönderdiğinde sipariş Order Status After Payment durumuna geçer. Belgenin süresi dolarsa sipariş Cancelled Payment Status durumuna geçer.

Ödeme tamamlanmadıysa müşteri, The payment was not completed. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Sipariş zaten iptal edilmişse mesaj The KOMOJU payment was not completed and the order has been cancelled. olur. Sepet korunur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Her yeni denemede (OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 siparişi günceller ve aynı siparişi yeniden öder) bu siparişin ve aynı sepetteki diğer siparişlerin açık KOMOJU oturumları kontrol edilir: bu siparişin, tutarı değişmemiş açık oturumu yeniden kullanılır, diğer açık oturumlar KOMOJU'da iptal edilir ve bu arada ödenmiş bir oturum, yeni bir ödeme yerine kendi siparişini onaylar. Sepetteki bir değişiklik, yeni adet dahil, kendi ödemesi gereken yeni bir sepet sayılır.

OpenCart 4'te sipariş, başarı sayfası gösterilene kadar ödeme sayfasında tutulur. Bu arada sipariş kapatıldıysa (örneğin konbini belgesi süresi doldu, ödeme başarısız oldu veya siz iptal ettiniz), müşteri Your previous order was cancelled or its payment failed. Please confirm the order again. mesajıyla ödeme sayfasına geri gönderilir. Sipariş zaten verilmişse ve sepette artık başka ürünler varsa mesaj Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. şeklindedir. Her iki durumda da bir sonraki Confirm Order işlemi sepetin yeni bir siparişini öder.

KOMOJU ödemeyi başlatamazsa müşteri, düğmenin üstünde kısa bir mesajla Confirm Order adımında kalır; örneğin KOMOJU could not accept this payment: ardından nedeni, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. veya Payment error: Could not connect to KOMOJU. Please try again in a moment. mesajı gösterilir. Teknik neden günlüğe yazılır.

Mağaza bakım modundayken de webhook çalışır: OpenCart 3 ödeme eklentisi isteklerine izin verir, OpenCart 4'te ise eklenti, webhook'un ve müşterinin dönüşünün geçmesine izin veren bir başlangıç eylemi ekler.

Eklentinin sitenizde kart formu, kayıtlı kart veya abonelik yoktur. Ödeme yöntemlerini kısıtlamaz: bunlar KOMOJU sayfasında seçilir. Manuel tahsilat eylemi yoktur: manuel tahsilat için yetkilendirilen ödemeler KOMOJU panelinde tahsil edilmelidir ve sipariş o zamana kadar Awaiting KOMOJU Payment Status durumunda kalır.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri KOMOJU'ya yönlendirildi ve ödeme yapmadı ya da KOMOJU ö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): KOMOJU ödemeyi onayladı. Bir not, KOMOJU ödeme kimliğini, ödeme yöntemini ve onayın nasıl yapıldığını (webhook veya dönüş) gösterir.

Awaiting KOMOJU Payment Status (default Pending): bir konbini belgesi veya banka havalesi düzenlendi ve ödeme bekliyor ya da bir ödeme KOMOJU panelinde tahsil edilmeyi bekliyor.

KOMOJU Payment On Hold Status (default Pending): KOMOJU, siparişin toplam tutarından farklı bir tutar veya para birimi bildirdi ya da sipariş iptal edildikten sonra ödeme tahsil edildi. Not bunu açıklar. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Cancelled Payment Status (default Canceled): ödeme belgesinin süresi doldu veya ödeme iptal edildi.

Failed Payment Status (default Failed): bekleyen bir siparişin ödemesi başarısız oldu.

Refunded Status (default Refunded): ödeme, sipariş sayfasından veya KOMOJU panelinden tamamen iade edildi.

Zaten ödenmiş bir sipariş için ya da zaten ödenmiş bir sepetin başka bir siparişi için ikinci bir ödeme tahsil edilirse, sipariş değiştirilmez. Bir not, bunun bir kopya olması durumunda KOMOJU panelinden iade etmenizi ister. İade edilen siparişler asla yeniden açılmaz.

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

VibeFox KOMOJU Payment sekmesi

Sales > Orders bölümünde KOMOJU ile ödenmiş bir sipariş açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox KOMOJU Payment sekmesi; KOMOJU ödeme kimliğini (KOMOJU panelindeki ödemeye bağlantılı), test ödemeleri için Test mode etiketini, ödeme yöntemini, oturumu, KOMOJU'daki sipariş numarasını, durumu, Paid / refunded tutarlarını, iade formunu, iade geçmişini (OpenCart'tan veya KOMOJU panelinden) ve siparişin KOMOJU notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox KOMOJU Payment sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via KOMOJU düğmesine tıklayın. Refund this amount through KOMOJU? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme iznine sahip olmanız gerekir (System > Users > User Groups bölümünde ayarlanır). İadeler, KOMOJU'nun gerçekte tahsil ettiği tutarla sınırlıdır; bu nedenle bir tutar uyuşmazlığından sonra sipariş toplamı değil, müşterinin ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı modun anahtarıyla gönderilir; bu nedenle o modun gizli anahtarı ayarlanmış olmalıdır. Eklenti önce ödemeyi KOMOJU'da kontrol eder ve hâlâ iade edilebilir tutarı aşan iadeleri reddeder. KOMOJU bir ödemeyi otomatik olarak iade edemezse (konbini gibi bazı yöntemler müşterinin banka bilgilerini gerektirir), KOMOJU'nun hata mesajı gösterilir ve hiçbir şey kaydedilmez: bu tür iadeleri KOMOJU panelinde yapın. Bir iade, ancak KOMOJU onayladığında tamamlanmış sayılır. Başarılı bir iade, iade geçmişine ve notlara eklenir. Tam iade, siparişi ürünleri stoka geri koymadan Refunded Status durumuna ayarlar; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, KOMOJU ödemeyi tahsil ettikten sonra kullanılabilir.

KOMOJU'nun başka bir para birimine çevirdiği ödemeler için (örneğin EUR siparişi için JPY cinsinden konbini), OpenCart üzerinden yalnızca tam iade mümkündür. Kısmi iadeleri KOMOJU panelinden yapın.

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

KOMOJU panelinde yapılan iadeler webhook ile gelir ve bir notla birlikte iade geçmişine eklenir. Ödemenin tamamı iade edildiğinde sipariş Refunded Status durumuna geçer. Başka bir para birimine çevrilmiş ödemeler için panelden yapılan kısmi iadeler yalnızca siparişe not düşülür: karşılık gelen tutarı OpenCart'a elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox KOMOJU Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox KOMOJU Payment > 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 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-komoju 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 izni olan yönetici kullanıcılar değiştirebilir. Bloktaki metinler yönetici paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresini değiştirdikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa 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ı serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan KOMOJU müşterilere ödeme sayfasında 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. aynı tarayıcıda yönetici paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin 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ırlatma görünür. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: zaten 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 Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

KOMOJU ö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 gizli anahtarının olduğunu kontrol edin: sandbox modunda Sandbox Secret Key, canlı modda Live Secret Key. Müşteri, KOMOJU'nun desteklediği bir para biriminde ödeme yapmalıdır. Eksik bir şey olduğunda ayarlar sayfası uyarı gösterir. Ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını da kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kaldı: webhook çalışmıyor. KOMOJU panelinde kullandığınız mod için webhook'un var olduğunu, URL'sinin Webhook URL bölümünde gösterilenle tam olarak aynı olduğunu ve olayların seçili olduğunu kontrol edin. Gizli belirtecinin doğru alanda (Live Webhook Secret Token veya Sandbox Webhook Secret Token) olduğunu doğrulayın ve eklenti sayfasındaki Log alanına bakın. Kart ödemeleri müşteri mağazaya döndüğünde de onaylanır; ancak konbini ve banka havalesi ödemeleri yalnızca webhook ile onaylanır.

Webhook Failed to verify KOMOJU webhook signature. yanıtı veriyor: gizli belirteç eksik veya başka bir webhook'a ait. KOMOJU bildirimi yeniden deneyecektir.

Webhook Mode mismatch, ignored. yanıtı veriyor: webhook, ödemenin yapıldığı moddan farklı modun gizli belirteciyle imzalanmış. Canlı ve test modları için ayrı webhook'lar ve belirteçler kullanın ve bunların karıştırılmadığını kontrol edin.

Webhook Order not found. yanıtı veriyor: ödeme bu mağazanın bir siparişine ait değil; örneğin aynı KOMOJU hesabını kullanan başka bir mağaza tarafından yapılmış. Olay yok sayılır.

Webhook Order is busy, retry later. veya Temporary error, retry later. yanıtı veriyor: sipariş başka bir istek tarafından güncelleniyordu veya ödeme o anda işlenemedi. KOMOJU bildirimi yeniden deneyecektir. Nedeni günlükte bulunur.

Webhook URL'si tarayıcıda hata gösteriyor: bu normaldir. URL yalnızca KOMOJU'dan gelen imzalı istekleri kabul eder.

Sipariş bekleyen veya beklemede durumda: sipariş sekmesindeki KOMOJU notes kayıtlarını okuyun. Bir belge ödeme için bekliyor, bir ödeme KOMOJU panelinde tahsil edilmeyi bekliyor, tutar veya para birimi eşleşmedi ya da ödeme sipariş iptal edildikten sonra geldi.

Sekmede iade formu yok: sekme nedenini belirtir: KOMOJU henüz ödemeyi tahsil etmedi, ödeme tamamen iade edildi, kullanıcı grubunuzun eklentiyi değiştirme izni yok veya ödeme modunun gizli anahtarı ayarlanmamış.

İade başarısız oluyor: mesajı okuyun. Ödemenin yapıldığı modun gizli anahtarı eksik olabilir, ödeme otomatik olarak iade edilemiyor olabilir (KOMOJU panelinden iade edin), KOMOJU ödemeyi yapılandırılmış anahtarla tanımıyor olabilir veya dönüştürülmüş bir ödeme için yalnızca tam iade mümkün olabilir.

Geliştiriciler için: eklenti, OpenCart olaylarını tetikler: komoju_p_supported_currencies (para birimi listesini değiştirmek için) ve komoju_p_session_params (ödeme oturumunu, örneğin ödeme yöntemlerini değiştirmek için).

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox KOMOJU Payment 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ılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları ve bakım modunda webhook'un ve müşteri dönüşünün geçmesini sağlayan başlangıç eylemi de). Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, anahtarlar, webhook belirteçleri, test modu, fatura öneki, günlük kaydı) ve günlük kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. KOMOJU işlemleri ve iadeleri her zaman korunur; böylece eski siparişler yeniden kurulumdan sonra da onaylanabilir ve iade edilebilir. Mevcut siparişler ödeme notlarını korur.

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

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