VibeFox Vindi for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 ile test edildi) veya 4.0.2 ve üzeri (4.1.0.3 ile test edildi).

PHP: 8.0 veya üzeri.

Para birimi: Brezilya reali (BRL), System > Localisation > Currencies altında kurulmuş olmalıdır. Vindi yalnızca BRL ile tahsilat yapar; bu nedenle ödeme yöntemi yalnızca müşteri BRL ile ödediğinde gösterilir.

Vindi hesabı: Vindi hesabınızın API anahtarına ihtiyacınız vardır. Vindi sandbox, kendi anahtarına sahip ayrı bir Vindi test hesabıdır. Boleto, PIX ve BolePix'i sunmak istiyorsanız, bunların Vindi hesabınızda da etkin olması gerekir.

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_vindi_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_vindi_gateway.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_vindi_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications sayfası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 sayfasına gidin ve türü Payments olarak seçin. VibeFox Vindi 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 kısmındaki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Sandbox API key değerini yapıştırın ve hazır olduğunuzda Live API key değerini de girin. Offered methods seçeneklerini belirleyin.

5. Ayarlardaki webhook URL'sini Vindi'ye kopyalayın (bkz. Yapılandırma).

6. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Sandbox mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_vindi_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış paket çalışmaz.

2. Paket, aynı sayfada kurulu eklentilerin listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox Vindi 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ı, API anahtarlarını, yöntemleri ve webhook'u OpenCart 3 için 3 ila 6. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Ödeme bildirimleri (webhook)).

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa modu, TEST MODE veya LIVE olarak gösterir ve geçerli modun API anahtarı boşsa (bu durumda ödeme yöntemi ödeme sayfasında gösterilmez) veya mağazanın para birimi BRL değilse (bu durumda ödeme yöntemi yalnızca müşteri BRL ile ödediğinde gösterilir) sizi uyarır. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken anahtarlar yazıldığı gibi, baştaki ve sondaki boşluklar olmadan kaydedilir. Hiçbir ödeme yöntemi seçili değilse kredi kartı kaydedilir ve sayfa Choose at least one payment method — credit card was selected. mesajını gösterir. Boş bir Title veya 128 karakterden uzun bir başlık, tam sayı olmayan bir Sort Order (negatif değerlere izin verilir), 0 veya daha büyük bir sayı olmayan bir Total ya da var olmayan bir coğrafi bölge veya sipariş durumu kabul edilmez: hiçbir şey kaydedilmez ve sayfa mesajı gösterir, örneğin Enter a title for the payment method (1 to 128 characters).

Vindi

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

Title: ödeme sayfasında gösterilen ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Vindi. Zorunlu, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında ödeme alanlarının üstünde gördüğü metin. Varsayılan: Pay by credit card on the secure Vindi page, or by boleto / PIX.

Sort Order: Vindi'nin ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin (negatif değerlere izin verilir).

Geo Zone: Vindi'yi 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 altında ayarlanır.

Total: Vindi'nin sunulabilmesi için bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki ödeme sayfası toplamı. Herhangi bir toplam için Vindi'yi sunmak üzere boş bırakın.

API anahtarları

Anahtarları Vindi panelinde Settings > API keys altında oluşturun: canlı için app.vindi.com.br üzerinde ve sandbox için sandbox-app.vindi.com.br üzerinde. Canlı ve sandbox ayrı sunuculara ve anahtarlara sahiptir. Her ödeme, faturasının nerede oluşturulduğunu hatırlar; bu nedenle kontroller, iptaller ve iadeler her zaman o ortamı kullanır.

Sandbox mode: yeni ödemeleri Vindi sandbox'ında oluşturur; sandbox-app.vindi.com.br ve sandbox API anahtarını kullanır. Müşteriler ödeme sayfasında bir TEST MODE notu görür: Vindi sandbox: no real charges. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın.

Live API key: canlı Vindi hesabının özel anahtarı. Yalnızca Vindi API'sine gönderilir.

Sandbox API key: Vindi sandbox hesabının özel anahtarı.

Kayıtlı anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek için 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.

Ödeme yöntemleri

Offered methods: müşterilerin seçebileceği yöntemler. Varsayılan: kredi kartı. Yöntemlerin Vindi hesabınızda da etkin olması gerekir.

Boleto, PIX ve BolePix, ödeme adımında istenen müşterinin CPF veya CNPJ bilgisini gerektirir.

Ödeme bildirimleri (webhook)

Webhook, mağazanıza bir faturanın ödendiğini, iptal edildiğini, reddedildiğini veya iade edildiğini bildirir. Bu bölümdeki Webhook URL alanı URL'yi gösterir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_vindi_gateway/webhook&token=..., OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_vindi_gateway/payment/wcp_vindi_gateway.webhook&token=.... OpenCart kurulumunuzun mağaza adresinden oluşturulur ve eklenti tarafından oluşturulan gizli bir jeton içerir. Ayarların gösterdiği gibi, aynen kopyalayın. Vindi'de hem canlı hesapta hem de sandbox hesabında Settings > Webhooks sayfasına gidin, bu URL'yi ekleyin ve şu olayları seçin:

Vindi bildirimlerini imzalamaz; bu nedenle jetonu eksik veya yanlış olan istekler reddedilir ve her bildirim, bir sipariş değişmeden önce eklentinin faturayı Vindi API'si üzerinden yeniden okumasına neden olur. URL, mağaza bakım modundayken de çalışır (OpenCart 4'te eklentinin bir başlangıç eylemi webhook'u ve ödeme durumu sayfasını geçirir). Vindi faturalarının bir dönüş URL'si yoktur; bu nedenle webhook olmadan bir kart ödemesi yalnızca müşteri aynı sepetle siparişi yeniden onayladığında (ödenmiş fatura o zaman bulunur) ve bir boleto veya PIX ödemesi müşteri siparişi hesabında yeniden açtığında (My Account > Order History) algılanır.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, Vindi faturayı bildirene kadar bir duruma sahip olmaz; fatura her zaman Vindi'den yeniden okunur. Boleto, PIX ve BolePix siparişleri, fatura düzenlenir düzenlenmez beklemede durumunu alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler. OpenCart'ta Beklemede tutulan (On Hold) durumu yoktur; bu nedenle beklemede ve beklemede tutulan durumları varsayılan olarak Pending (Beklemede) kullanır; sipariş notları ikisini ayırt eder. Kendi durumlarınızı System > Localisation > Order Statuses altında oluşturabilir ve burada seçebilirsiniz.

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

Awaiting Vindi Payment Status: ödeme adımında boleto, PIX veya BolePix düzenlendi; Vindi parayı daha sonra onaylar. Ödeme verileri, müşterinin gördüğü geçmiş yorumuna eklenir. Varsayılan: Beklemede.

Vindi Payment On Hold Status: fatura Vindi'de incelemede, ödenen fatura siparişle eşleşmiyor (para birimi, tutar, fatura kodu veya Vindi müşterisi) ya da sipariş iptal edildikten sonra ödendi. Bir not nedenini açıklar. Varsayılan: Beklemede.

Payment Error Status: Vindi, beklemedeki bir siparişin ödeme denemesini reddetti. Müşteri aynı faturayı yine ödeyebilir; daha sonraki bir ödeme, durumu ödeme sonrası duruma taşır. Varsayılan: Başarısız.

Canceled Status: beklemedeki bir siparişin faturası Vindi'de iptal edildi. Bu eklentinin bir siparişini bu duruma getirdiğinizde, bekleyen Vindi faturası da iptal edilir. Varsayılan: İptal edildi.

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

Gelişmiş

Debug log: API çağrılarını ve bildirimleri OpenCart günlük klasöründeki (storage/logs, OpenCart 4'te system/storage/logs) wc_vdi_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar, bu seçenek kapalı olsa bile her zaman kaydedilir. Anahtarlar, webhook jetonu ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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

Delete data on uninstall: açıkken eklentiyi kaldırmak, ayarları, webhook jetonunu, ürün önbelleğini ve günlüğü siler. Siparişler ve siparişlerin Vindi fatura referansları korunur. Varsayılan: kapalı.

İçe / Dışa aktarma

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

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Vindi). Confirm Order adımında müşteri açıklamanızı görür. Birden fazla yöntem sunulduğunda ödeme kutusu Pay with ve kredi kartı, boleto, PIX veya BolePix arasında bir seçim gösterir. Boleto, PIX veya BolePix sunulduğunda kutuda ayrıca bir CPF or CNPJ alanı bulunur. Kredi kartı sunulmuyorsa bu alan zorunludur; aksi halde Required for boleto and PIX. gösterilir. Alan, geçerli bir numara içeriyorsa müşterinin özel alanından veya CPF ya da CNPJ adlı adresten doldurulur. Numara kontrol basamaklarıyla doğrulanır. Eksik bir şey varsa müşteri Please choose how you want to pay with Vindi., Please enter a valid CPF or CNPJ. veya Please enter your CPF or CNPJ — it is required for boleto and PIX. mesajlarından birini görür. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer; bu alanların bulunduğu ödeme kutusu ve Confirm Order düğmesi ödeme sayfasının altındadır.

Müşteri Confirm Order düğmesine tıkladığında eklenti, bu sepet için ödeme adresinden bir Vindi müşterisi ve sipariş toplamı için tek taksitlik bir Vindi faturası oluşturur. Vindi'de fatura, Order # ve OpenCart sipariş numarasıyla adlandırılır.

Kredi kartı: müşteri Vindi fatura sayfasına gönderilir ve orada öder. Sipariş durumsuz kalır. Vindi'nin faturalar için bir dönüş URL'si yoktur; bu nedenle müşteri otomatik olarak mağazaya geri gönderilmez. Sipariş, Vindi ödemeyi webhook ile onayladığında durumunu alır. Müşteri siparişi aynı sepetle yeniden onaylarsa ve fatura zaten ödenmişse, ödenmiş sipariş onaylanır ve müşteri başarı sayfasını görür.

Boleto, PIX ve BolePix: fatura hemen düzenlenir, sipariş beklemede durumunu alır ve müşteri OpenCart sipariş başarı sayfasına gelir. Orada ve müşteri hesabındaki sipariş ayrıntılarında bir Payment bölümü, PIX QR kodunu, Copy code düğmeli PIX kopyala-yapıştır kodunu ve son kullanma tarihini, ayrıca bir Open boleto düğmesini gösterir. Sipariş e-postası ve müşterinin sipariş geçmişi PIX kodunu ve boleto bağlantısını içerir. Vindi boleto veya PIX verilerini döndürmezse fatura iptal edilir ve müşteri bir hata görür.

Sipariş, yalnızca Vindi onayladıktan sonra ödenmiş olarak işaretlenir: eklenti faturayı Vindi API'sinden okur ve para birimini, faturanın siparişe ait olduğunu (fatura kodu ve Vindi müşterisi) ve ödenen tutarın sipariş toplamına eşit olduğunu kontrol eder. Başarı sayfası ve müşteri hesabındaki sipariş sayfası, beklemedeki bir siparişi API üzerinden en fazla 15 saniyede bir yeniden kontrol eder. Ödeme alındığında başarı sayfası Your payment with Vindi has been received. gösterir. Ödeme henüz onaylanmamışsa We are confirming your payment with Vindi. The order will be updated automatically — please do not pay again. gösterir. İptal edilmiş bir sipariş için This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid. gösterir.

Ödeme onaylanmadığı sürece, başarı sayfası ve müşteri hesabındaki sipariş sayfası (beklemede veya beklemede tutulan bir sipariş için) ayrıca bir Check payment status düğmesi gösterir. Bu düğme siparişin en son Vindi faturasını kontrol eder. Onaylanmış veya beklemedeki bir sipariş, ödeme verileriyle birlikte başarı sayfasına döner. Fatura hâlâ ödenmemişse Payment bölümü Your payment has not been completed yet. If you have already paid, the order is confirmed as soon as Vindi reports the payment — please do not pay again. der ve Pay at Vindi, Check again ve Back to checkout düğmelerini içerir.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme sırasındaki siparişi günceller. Bu nedenle eklenti her sepeti yalnızca bir kez öder. Aynı sepetin başka bir siparişi zaten ödenmişse, boleto veya PIX bekliyorsa ya da beklemede tutuluyorsa, müşteri başarı sayfasına gider ve yeni bir fatura düzenlenmez. Aynı sipariş için yeni bir deneme, yöntem, tutar ve ortam aynıysa bekleyen Vindi faturasını yeniden kullanır. Aksi halde yeni bir fatura oluşturulmadan önce önceki fatura Vindi'de iptal edilir; böylece müşteri aynı sepeti iki kez ödeyemez. Sepetteki bir değişiklik, bu arada yeni adet de dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Reddedilen bir kart ödemesinden ya da iptal edilen bir faturadan sonra müşteri aynı siparişi yeniden öder. Bu arada sipariş ödeme yapılmadan kapatılmışsa müşteri ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişi öder: iptal edilmiş bir sipariş This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid. mesajını, başarısız olan bir sipariş ise Your Vindi payment attempt was rejected. You can try again below. mesajını gösterir. OpenCart 4'te ödeme sayfasına geri döndüren Payment durum sayfasının mesajları, ödeme sayfasının üstünde gösterilir.

Vindi ö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 CPF / CNPJ'yi, fatura adresini (boleto için sokak, posta kodu, şehir ve eyalet zorunludur), e-postayı veya telefon numarasını kontrol etmesi ya da Vindi'nin geçici olarak kullanılamadığı. Teknik neden günlüğe yazılır.

Eklenti tek taksitli, tek seferlik ödemeleri kabul eder. Abonelik veya tekrarlayan faturalandırma, kayıtlı kart, taksit ve sitenizde kart formu desteklenmez: kart her zaman Vindi sayfasında girilir. Bina numarası ve semt OpenCart adresinin parçası değildir; bu nedenle Vindi'ye gönderilmezler.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): bir kart ödemesi başlatıldı ve Vindi henüz onaylamadı. Sales > Orders altında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür. OpenCart 4.1'de bu tür bir siparişe, onay adımı yeniden gösterildiğinde OpenCart'ın atadığı Voided durumu da verilebilir; eklenti bunu durumsuz bir sipariş olarak değerlendirir.

Awaiting Vindi Payment Status (varsayılan Beklemede): boleto, PIX veya BolePix ödemesi bekleniyor. Vindi faturanın ödendiğini bildirdiğinde sipariş Order Status After Payment durumuna geçer.

Order Status After Payment (varsayılan İşleniyor): ödeme onaylandı. Sipariş, OpenCart'ın olağan yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle durumunu alır. Bir not, Vindi faturasını, tutarı ve ortamı gösterir.

Vindi Payment On Hold Status (varsayılan Beklemede): Vindi faturası incelemede, ödenen fatura siparişle eşleşmiyor (para birimi, tutar, fatura kodu veya Vindi müşterisi) ya da fatura, sipariş iptal edildikten sonra ödendi. Not durumu açıklar. Siparişi ve stoku kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Payment Error Status (varsayılan Başarısız): Vindi, beklemedeki bir siparişin ödeme denemesini reddetti. Varsa not, edinenin verdiği nedeni gösterir. Müşteri aynı faturayı yine ödeyebilir ve sonraki bir ödeme siparişi Order Status After Payment durumuna taşır.

Canceled Status (varsayılan İptal edildi): beklemedeki bir siparişin faturası Vindi'de iptal edildi. OpenCart'ta bir siparişi bu duruma getirdiğinizde, bekleyen Vindi faturası da iptal edilir ve artık ödenemez. Bu mümkün değilse bir not, faturayı Vindi panelinden iptal etmenizi ister.

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

Zaten ödenmiş bir sipariş için veya zaten ödenmiş siparişi olan bir sepetin başka bir siparişi için ikinci bir fatura ödenirse, sipariş değiştirilmez. Ödenmiş siparişteki bir not, Vindi'de bir ödemeyi iade etmenizi ister. Notlar, müşterinin görmediği siparişin History kayıtlarıdır.

VibeFox Vindi Gateway sekmesi

Sales > Orders altında Vindi ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Vindi Gateway sekmesi Vindi bill, Charge, ortamı (sandbox ödemeleri için Sandbox rozetiyle birlikte), Payment method, Status, Paid / refunded tutarlarını, iade formunu, iade geçmişini, Bills of this cart altındaki tüm faturaları ve siparişin Vindi notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Vindi 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 Vindi düğmesine tıklayın. Refund this amount through Vindi? This cannot be undone. sorusunu onaylayın. Kart ve PIX ödemelerinde tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme iznine sahip olmanız gerekir (System > Users > User Groups altında ayarlanır). İadeler, Vindi'nin gerçekten tahsil ettiği tutarla sınırlıdır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin ortamında (canlı veya sandbox) gönderilir; bu nedenle o ortamın API anahtarı ayarlanmış olmalıdır.

Tam iade ayrıca Vindi'de faturayı iptal eder ve siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan Refunded Status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. Başarılı bir iade, Vindi tahsilatı ve durumuyla birlikte iade geçmişine ve notlara eklenir. Vindi veya edinen kuruluş iadeyi reddederse sekme hatayı gösterir ve hiçbir iade kaydedilmez. İadeler, Vindi faturanın ödendiğini bildirdikten sonra kullanılabilir.

Vindi boleto ödemelerini iade edemez. Sekme Vindi cannot refund boleto payments. Return the money to the customer by bank transfer and record the refund manually. mesajını gösterir.

Sales > Returns altındaki ürün iadeleri Vindi üzerinden para geri göndermez. Vindi panelinde yapılan iadeler charge_refunded webhook'u ile gelir ve notlara eklenir. Sipariş durumu otomatik olarak değişmez. Gerekirse manuel olarak güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Vindi Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin 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 şu düğmeleri gösterir: 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. Bunların altında Product: opencart-payment-vindi satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify izni olan 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 gösterir, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihle birlikte License expired on. Mağaza adresi değiştikten 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şı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 Vindi, ödeme sayfasında müşterilere gösterilmez. Bir ödeme yine de başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu ön izleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten oluşturulmuş faturalar Vindi webhook'u ile yine onaylanır ve iadeler çalışır.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard sayfasını 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, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Vindi ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, müşterinin BRL ile ödediğini, Offered methods altında en az bir yöntemin seçili olduğunu ve geçerli modun bir API anahtarına sahip olduğunu kontrol edin: sandbox modunda Sandbox API key, canlı modda Live API key. Anahtar eksikse veya mağaza para birimi BRL değilse ayarlar sayfası 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 gerçekleşti ama sipariş durumsuz veya beklemede kaldı: webhook çalışmıyor. Vindi'de kullandığınız hesapta (canlı veya sandbox) webhook'un var olduğunu, URL'sinin ayarlarda gösterilenle tam olarak aynı olduğunu (jeton dahil) ve dört olayın da seçili olduğunu kontrol edin.

Webhook Forbidden yanıtı veriyor: URL'deki jeton eksik veya yanlış. URL'yi ayarlardan yeniden kopyalayın.

Webhook Verification failed, retry later yanıtı veriyor: fatura Vindi API'sinden okunamadı (örneğin o ortamın API anahtarı kaldırıldı), sepet aynı anda başka bir istek tarafından güncelleniyordu veya sipariş durumu ayarlanamadı. Vindi bildirimi yeniden gönderir. Günlük nedeni gösterir.

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

Müşteri This payment method is temporarily unavailable mesajını görüyor: Vindi API anahtarını reddetti. Geçerli modun anahtarını kontrol edin.

Müşteri Confirm Order sonrasında bir hata görüyor: eklenti sayfasındaki Log alanına bakın. Debug log kapalıyken bile hatalar kaydedilir. Boleto için fatura adresinde sokak, posta kodu, şehir ve eyalet bulunmalıdır.

Sipariş beklemede tutulan durumda: VibeFox Vindi Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın veya ödemeyi iade edin.

Canlıya geçtikten sonra eski sandbox siparişleri: her ödeme, faturasının ortamını korur. Sandbox siparişlerinin kontrolleri, iptalleri ve iadeleri, anahtar ayarlarda kaldığı sürece sandbox anahtarını kullanmaya devam eder.

İade başarısız oluyor: mesajı okuyun. Boleto ödemeleri Vindi üzerinden iade edilemez ve ödemenin ortamının API anahtarı ayarlanmış olmalıdır. Eklentiyi değiştirme izniniz yoksa sekme You do not have permission to refund orders (modify this extension). mesajını gösterir.

Geliştiriciler için: Vindi müşterisi ve faturası oluşturulmadan önce eklenti, istek verileri ve sipariş ile birlikte wc_vdi_customer_request ve wc_vdi_bill_request OpenCart olaylarını tetikler.

Kaldırma

Extensions > Extensions sayfasına gidin, türü Payments olarak seçin ve VibeFox Vindi Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman eklentinin kendi ayarlarını 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 olayları da kaldırılır (OpenCart 4'te ayrıca, bakım modunda webhook'u ve ödeme durumu sayfasını geçiren başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa diğer ayarlar (başlık, açıklama, sandbox modu, API anahtarları, ödeme yöntemleri, günlük kaydı), webhook jetonu, ürün önbelleği ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Siparişlerin Vindi faturaları ve iadeleri her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Vindi 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.

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