VibeFox Iugu 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: Brezilya reali (BRL). Iugu yalnızca BRL ile tahsilat yapar, bu nedenle mağazanın System > Localisation > Currencies bölümünde BRL para birimi bulunmalıdır. Müşterinin ödeme yaptığı para birimi başka bir para birimiyse veya toplam tutar R$ 1,00'ın altındaysa (Iugu'nun asgari tutarı) ödeme yöntemi gizlenir.

Iugu hesabı: Iugu panelinden biri "Test", diğeri "Live" türünde olmak üzere iki API jetonu gerekir (bkz. Configuration). Iugu her ikisi için tek bir API adresi kullanır: faturanın test mi yoksa gerçek mi olacağına jeton karar verir. Iugu'da webhook kurmanız gerekmez.

CPF/CNPJ (isteğe bağlı): OpenCart'ın kendi CPF alanı yoktur. Adında CPF veya CNPJ geçen bir müşteri ya da adres özel alanı eklerseniz (Customers > Custom Fields), bu alanın değeri Iugu'ya iletilir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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_iugu_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_iugu_gateway.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_iugu_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentide OCMOD değişikliği bulunmadığı için 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 Iugu Gateway öğesini 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. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. License key).

4. Test ve canlı API jetonlarını girin (bkz. Configuration), Test mode seçeneğini açık bırakın, Enable / Disable seçeneğini etkinleştirin ve Save düğmesine tıklayın.

5. BRL para biriminde bir test siparişi verin ve Iugu test ödemesiyle Iugu sayfasında ödeyin. Her şey hazır olduğunda 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_iugu_gateway.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 ve tür olarak Payments seçin. VibeFox Iugu Gateway öğesini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve API jetonlarını 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 bildirim URL'si farklıdır (bkz. Ödeme bildirimleri).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Iugu Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa, TEST MODE (faturalar test API jetonuyla oluşturulur, gerçek tahsilat yapılmaz) ya da LIVE bilgisini gösterir. Etkin modun jetonu eksikse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi BRL değilse uyarır (bu durumda Iugu diğer para birimleri için sunulmaz). Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydetme sırasında Title boş olamaz veya 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır, Total 0 veya daha büyük bir sayı olmalıdır ve seçilen coğrafi bölge ile sipariş durumları mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez ve hata alanı belirtir.

Iugu

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

Title: müşterinin ödeme sırasında gördüğü ödeme yöntemi adı. Siparişte de ödeme yöntemi adı olarak kaydedilir. Varsayılan: Iugu. Zorunlu, en fazla 128 karakter.

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: Iugu ile güvenli ödeme yapın. Ödemenizi tamamlamak için yönlendirileceksiniz.

Sort Order: Iugu'nun ödeme sırasında ödeme yöntemleri arasındaki konumu. Boş bırakın veya tam sayı girin.

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

Total: Iugu'nun sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki ödeme tutarı. Iugu'yu her tutar için sunmak üzere boş bırakın. Iugu'nun kendisi en az R$ 1,00 ister.

API kimlik bilgileri

API jetonlarını Iugu Alia içinde oluşturun (bölüm oraya bağlantı verir): Settings > API integration > New. Bir "Test" türünde ve bir "Live" türünde jeton oluşturun.

Test mode: test API jetonunu kullanır, bu nedenle gerçek tahsilat yapılmaz. Varsayılan: açık. Test modu açıkken müşteriler, Confirm Order adımında açıklamanın üstünde SANDBOX — Test mode enabled. No real charges. ifadesini görür. Bir siparişin durum sorguları ve iadeleri her zaman faturasının oluşturulduğu modun jetonunu kullanır; bu nedenle modu değiştirmek eski siparişleri bozmaz.

Test API token: "Test" türündeki Iugu API jetonu. Test modu açıkken kullanılır.

Live API token: "Live" türündeki Iugu API jetonu (canlı ortam). Test modu kapalıyken kullanılır. Gizli tutun.

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

Ödeme bildirimleri

Notification URL: her fatura, Iugu'ya durum değişikliklerini mağazanızın bu URL'sine bildirmesini söyler. OpenCart 3'te şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_iugu_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_iugu_gateway/payment/wcp_iugu_gateway.webhook biçimindedir ve internetten erişilebilir olmalıdır. Iugu'da yapılandırılacak bir şey yoktur. Aynı URL'yi gösteren hesap genelindeki ek bir tetikleyici zararsızdır. Bildirimler, mağazanın güvendiği hiçbir ödeme verisi içermez: sipariş değişmeden önce fatura her zaman Iugu API'sinden yeniden okunur (durum, tutar, para birimi).

Eklenti, bu bölümde listelenen Iugu olaylarına yanıt verir: invoice.status_changed, invoice.refund, invoice.released, invoice.dunning_action ve invoices. Bunların her biri için faturayı okur ve durumunu uygular:

Henüz durumu olmayan bir siparişin süresi dolmuş veya iptal edilmiş faturası, siparişi durumsuz bırakır; böylece müşteri yeniden ödeme yapabilir. Diğer olaylar ve mağazanız tarafından oluşturulmamış faturalar HTTP 200 ile yanıtlanır ve Iugu'ya istek gönderilmeden yok sayılır. Bildirimler yoksa, bir fatura yalnızca müşteri Iugu sayfasından mağazaya döndüğünde kontrol edilir.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz oluşturur (eksik sipariş). Sipariş, Iugu faturayı bildirdikten sonra, bildirimle veya müşterinin dönüşünde bir durum alır; fatura her zaman Iugu'dan okunur. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: doğrulanmış bir Iugu ödemesinden sonra ayarlanır. Varsayılan: İşleniyor.

Awaiting Iugu Payment Status: müşteri, düzenlenmiş bir boleto veya PIX ile Iugu sayfasından döndü; Iugu parayı daha sonra onaylayacak. Varsayılan: Beklemede.

Iugu Payment On Hold Status: kart ödemesi yetkilendirildi ama tahsil edilmedi, ödeme inceleniyor, kısmen ödendi, chargeback, Iugu siparişten farklı bir tutar ya da para birimi bildirdi, veya ödeme sipariş iptal edildikten sonra geldi. Bir not nedenini açıklar; bunu elle kontrol edin. Varsayılan: Beklemede, çünkü OpenCart'ta "On hold" durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Invoice Expired Status: bekleyen bir siparişin faturası ödenmeden süresi doldu. Iugu daha sonra ödendi bildirirse sipariş, ödeme sonrası durumu alır. Varsayılan: Başarısız.

Invoice Canceled Status: bekleyen bir siparişin faturası Iugu'da iptal edildi. Varsayılan: İptal edildi.

Refunded Status: ödeme sipariş sayfasından veya Iugu panelinden tamamen iade edildikten sonra ayarlanır. Varsayılan: İade edildi.

Gelişmiş

Debug log: API isteklerini ve bildirimleri OpenCart log klasöründe (storage/logs) bulunan wc_igu_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Jetonlar ve müşteri verileri (e-posta, telefon, CPF) hiçbir zaman günlüğe yazılmaz. Hatalar ve uyarılar, anahtar kapalı olsa bile 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ırmak ağ geçidi ayarlarını ve günlüğü siler. Siparişler, Iugu fatura referansları ve iadeler her zaman korunur; böylece yeniden kurulumdan sonra eski siparişler çalışmaya devam eder. Varsayılan: kapalı.

İçe / dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. API jetonları 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ı API jetonları korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Iugu). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to the Iugu invoice page to pay by credit card, boleto or PIX. 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ş tutarı için BRL cinsinden, 3 gün vadeli bir Iugu faturası oluşturur ve müşteriyi Iugu fatura sayfasına yönlendirir. Geçerli bir e-posta adresi gereklidir. Fatura Order # ve sipariş numarasını gösterir. Müşteri orada, Iugu hesabınızda etkin olan yöntemlerle kredi kartı, boleto veya PIX ile öder. Müşterinin adı ve e-postası Iugu'ya gönderilir; ayrıca adı CPF veya CNPJ olan özel bir alandaki CPF/CNPJ, 11 veya 14 haneliyse gönderilir. Telefon ve adres yalnızca Iugu'nun kabul ettiği biçimde gönderilir (Brezilya telefon numaraları, 8 haneli CEP içeren Brezilya adresleri; bina numarası s/n olarak gönderilir).

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 adresinin adresini ve CPF/CNPJ özel alanını alır.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş yalnızca Iugu onayladığında ödenmiş olarak işaretlenir: fatura, müşteri döndüğünde ve Iugu bir bildirim gönderdiğinde Iugu API'sinden okunur. 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 bir boleto veya PIX kodu oluşturduysa ve ödemeden önce geri döndüyse, sipariş Awaiting Iugu Payment Status durumunu alır ve başarı sayfasında Your Iugu invoice is awaiting payment (boleto / PIX). The order will be confirmed as soon as Iugu reports the payment. yazısı görünür. Sipariş, Iugu parayı bildirdiğinde (bildirimle ya da müşteri dönüş bağlantısını yeniden açtığında) ödenmiş duruma geçer. Bekletilen bir sipariş için başarı sayfasında We are confirming your payment with Iugu. The order will be updated automatically — please do not pay again. görünür. Müşteri döndüğünde Iugu'ya ulaşılamadıysa ya da ödemeyi henüz bildirmediyse, aynı metni ve Check again ile Back to checkout düğmelerini gösteren bir Payment confirmation sayfası açılır.

Fatura iptal edilmişse veya süresi dolmuşsa müşteri, The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. mesajıyla ödeme sayfasına döner. Sipariş, Iugu faturası iptal edildiği için iptal edildiyse mesaj Your order was cancelled because its Iugu invoice was canceled. olur. Sepet zaten boşsa (boleto veya PIX siparişi, faturasının süresi dolmadan önce başarı sayfasına ulaşmışsa), müşteri bunun yerine Payment confirmation sayfasını görür; bu sayfada The Iugu invoice of order #... was not paid (it was canceled or has expired), so the order will not be shipped. To buy these items, please place a new order. (ya da iptal mesajı) ve bir Continue düğmesi bulunur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise siparişi günceller, bu nedenle süresi dolan veya iptal edilen bir faturadan sonra müşteri aynı siparişi yeni bir faturayla öder. Bir sepet yalnızca bir kez ödenir. Yeni bir faturadan önce eklenti, sepetin önceki faturalarını kontrol eder: biri ödenmişse o ödeme uygulanır ve müşteri başarı sayfasına gider; aynı siparişin aynı tutar ve moda sahip açık bir faturası varsa müşteri oraya geri gönderilir; diğer açık faturalar Iugu'da iptal edilir. Eski bir fatura yine de ödenirse ödeme yine de eşleştirilir ve zaten ödenmiş bir sepetin mükerrer ödemesi bir notla işaretlenir. 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 boleto süresi doldu veya siz iptal ettiniz), müşteri The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. mesajıyla ödeme sayfasına geri gönderilir; sipariş kapatılmadan önce ödenmişse This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. mesajıyla gönderilir. Sipariş zaten verilmişse ve sepette yeni bir alım varsa, Confirm Order ödeme sayfasını yeniden yükler. Her iki durumda da bir sonraki Confirm Order işlemi sepetin yeni bir siparişini öder.

Iugu faturayı oluşturamazsa müşteri Confirm Order adımında kalır ve kısa bir mesaj görür; örneğin Iugu could not create the invoice: ardından nedeni ve fatura bilgilerini kontrol etme isteği, ya da Could not connect to Iugu. Please try again in a moment. Teknik neden günlüğe yazılır.

Mağaza bakım modundayken de bildirim URL'si çalışır: OpenCart 3 ödeme eklentisi isteklerini geçirir, OpenCart 4'te ise eklenti, bildirimin ve müşterinin dönüşünün geçmesini sağlayan bir başlangıç eylemi ekler.

Eklenti yalnızca tek seferlik ödemeleri kabul eder. Sitede kart formu, kayıtlı kartlar, abonelikler veya yinelenen tahsilat, carnê, bölünmüş ödemeler ya da taksit ayarları yoktur; taksit için Iugu sayfasının ayarlarını kullanın. Iugu sayfasında sunulan ödeme yöntemleri eklenti ayarlarında seçilemez: Iugu hesabınızda etkin olan tüm yöntemler sunulur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Iugu'ya gönderildi ve ödeme yapmadı, fatura süresi doldu veya iptal edildi ya da Iugu ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.

Order Status After Payment (varsayılan İşleniyor): Iugu ödemeyi onayladı. Bir not, fatura kimliğini ve ödeme yöntemini (kredi kartı, boleto veya PIX) gösterir.

Awaiting Iugu Payment Status (varsayılan Beklemede): müşteri, düzenlenmiş bir boleto veya PIX ile geri döndü. Iugu ödemeyi bildirdiğinde sipariş ödenmiş duruma geçer.

Iugu Payment On Hold Status (varsayılan Beklemede): kart ödemesi yetkilendirildi ama henüz tahsil edilmedi (Iugu'da tahsil edin; Iugu faturayı ödenmiş bildirdiğinde sipariş tamamlanır), ödeme inceleniyor, fatura yalnızca kısmen ödendi, bir chargeback açıldı, Iugu siparişten farklı bir tutar ya da para birimi bildirdi, veya ödeme sipariş iptal edildikten sonra geldi. Notlar bunu açıklar. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Invoice Expired Status (varsayılan Başarısız): bekleyen bir siparişin faturası ödenmeden süresi doldu. Iugu faturayı daha sonra ödenmiş bildirirse sipariş ödenmiş duruma geçer.

Invoice Canceled Status (varsayılan İptal edildi): bekleyen bir siparişin faturası Iugu'da iptal edildi.

Refunded Status (varsayılan İade edildi): ödeme eklenti üzerinden veya Iugu panelinden tamamen iade edildi.

Aynı sipariş ya da sepetin başka bir faturası da ödenmişse sipariş değiştirilmez. Bir not, mükerrer ödemeyi Iugu'da iade etmenizi ister. Notlar, müşterinin görmediği sipariş History kayıtlarıdır. Bekleyen bir sipariş daha sonra ödenir, süresi dolar veya iptal edilirse OpenCart müşteriyi yeni durum hakkında bilgilendirir.

VibeFox Iugu Gateway sekmesi

Sales > Orders bölümünde Iugu ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Iugu Gateway sekmesi, Iugu invoice kimliğini (Iugu'daki faturaya bağlantılı) ve test faturaları için Test mode etiketini, Payment method bilgisini, Status bilgisini, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Iugu notes notlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Iugu Gateway 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 Iugu düğmesine tıklayın. Refund this amount through Iugu? This cannot be undone. sorusunu onaylayın. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İade, faturanın oluşturulduğu modun jetonuyla gönderilir; bu nedenle o jetonun ayarlanmış olması gerekir.

İadeler, Iugu'nun faturadan gerçekte tahsil ettiği tutar üzerinden hesaplanır; bu nedenle bir tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin ödediği tutara kadar iade yapabilirsiniz. Yalnızca ödenmiş faturalar iade edilebilir ve Iugu'da hâlâ iade edilebilir olan tutarı aşamaz. Bir iade, ancak Iugu onayladığında tamamlanmış sayılır. Iugu iadeyi reddeder veya onaylamazsa sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, fatura kimliği ve nedeniyle birlikte iade geçmişine ve notlara eklenir. Tam iade, müşteriye bildirim göndermeden ve ürünleri stoğa geri almadan siparişi Refunded Status durumuna getirir; tıpkı elle yapılan bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, Iugu faturayı ödenmiş olarak bildirdikten sonra kullanılabilir.

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

Iugu panelinden yapılan tam bir iade, siparişi bir notla Refunded Status durumuna getirir. Panelden yapılan kısmi iadeler içe aktarılmaz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Iugu Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Iugu Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: opencart-payment-iugu 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 yetkisi olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri 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 bir tarihle birlikte License expired on. Mağaza adresi değiştikten veya 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 tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresinde. 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 Iugu, ödeme sırası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ıdan 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 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 paneli Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. 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 her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Iugu ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve etkin modun jetonunun girildiğini kontrol edin: test modunda Test API token, canlı modda Live API token. Müşterinin ödeme para birimi BRL olmalı ve toplam en az R$ 1,00 olmalıdır. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlardaki Total tutarına ulaştığını kontrol edin. Jeton veya para birimi yanlışsa ayarlar sayfası bir uyarı gösterir.

Ödeme yapıldı, ancak sipariş durumsuz kaldı: Iugu bildirimi mağazanıza ulaşmadı veya kontrol edilemedi. Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. Mağazanızın Notification URL adresinden internete açık olduğunu ve faturanın oluşturulduğu modun jetonunun hâlâ girili olduğunu kontrol edin. Fatura, müşteri ödemeden sonra mağazaya döndüğünde de kontrol edilir.

Bildirim verification failed yanıtı veriyor: fatura o anda Iugu API'sinden okunamadı; örneğin bir ağ hatası, yanlış bir jeton veya faturanın modu için eksik bir jeton nedeniyle. Iugu bildirimi yeniden dener.

Bildirim busy yanıtı veriyor: sepet aynı anda başka bir istek tarafından işleniyordu ya da sipariş durumu ayarlanamadı. Iugu bildirimi yeniden dener. Günlükte neden yazar.

Bildirim invalid invoice id yanıtı veriyor: bildirimde geçerli bir fatura kimliği yoktu. Hiçbir şey değişmez.

Sipariş Iugu Payment On Hold Status durumunda: siparişin sekmesindeki Iugu notes notlarını okuyun. Kart ödemesi tahsilat bekliyor, ödeme inceleniyor, kısmen ödendi veya itiraz edildi, ödenen tutar siparişle eşleşmedi ya da ödeme sipariş iptal edildikten sonra geldi.

Müşteri "Iugu payments are not available right now" mesajını görüyor: API jetonu eksik veya yanlış. Etkin modun jetonunu kontrol edin.

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

Müşteri "This order already has an Iugu payment that the store has to review" mesajını görüyor: siparişin önceki bir faturası yetkilendirilmiş, incelemede veya kısmen ödenmiş. Iugu'daki faturayı ve günlüğü kontrol edin.

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

İade başarısız: sekmedeki mesajı okuyun. Boleto ödemeleri Iugu üzerinden iade edilemez, PIX ödemeleri yalnızca tam olarak iade edilebilir ve yalnızca ödenmiş faturalar iade edilebilir. Mesaj ödemenin test veya canlı modda yapıldığını ve o mod için jeton ayarlanmadığını söylüyorsa, o modun jetonunu girin. Iugu iadeyi onaylamadıysa, tekrar denemeden önce Iugu'daki faturayı kontrol edin.

Geliştiriciler için: fatura oluşturulmadan önce eklenti, fatura isteği ve sipariş ile birlikte OpenCart wc_igu_invoice_data olayını tetikler; örneğin ödeme yöntemlerini payable_with ile sınırlamak için.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Iugu 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 ayrıca olayları ve bakım modunda bildirimin 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, test modu, API jetonları, hata ayıklama günlüğü anahtarı) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. Iugu fatura referansları ve iadeler her zaman korunur; böylece daha önce ödenmiş siparişler iade edilebilir ve yeniden kurulumdan sonra geç gelen bildirimler yine eşleştirilir. 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 Iugu Gateway 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.

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