VibeFox Viva Wallet for OpenCart — Yardım

Gereksinimler

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

PHP: 8.0 veya üzeri.

Viva hesabı: bir Viva satıcı hesabı. Testler için demo hesabı (demo.vivapayments.com), gerçek ödemeler için canlı hesap (www.vivapayments.com) kullanabilirsiniz. Her hesabın kendi kimlik bilgileri vardır. Ödemeler için Smart Checkout kimlik bilgilerine (Client ID ve Client Secret) ve bir ödeme kaynağının Source Code değerine ihtiyacınız vardır. Merchant ID ve API Key isteğe bağlıdır: yalnızca Viva'nın webhook URL doğrulamasını yanıtlamak için kullanılırlar.

Para birimi: EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK veya CHF. Müşterinin mağazada seçtiği para birimi bunlardan biri olmalıdır; diğer para birimlerinde ödeme yöntemi ödeme adımında 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. İçinde README.txt, OpenCart 3 paketi wcp_viva_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_viva_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_viva_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişiklikleri 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 sayfasına gidin ve Payments türünü seçin. VibeFox Viva Wallet Gateway 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 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 girin ve Activate düğmesine tıklayın (bkz. License key).

4. Viva'nın demo ve/veya canlı hesabının kimlik bilgilerini girin; ödeme kaynağını ve webhook'u Viva hesabınızda ayarlayın (bkz. Configuration).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test Mode açıkken bir Viva demo kartıyla demo ödemesi yapın, ardından canlıya geçmek için Test 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_viva_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 Payments türünü seçin. VibeFox Viva Wallet 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ı, Viva kimlik bilgilerini, ödeme kaynağını ve webhook'u OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca Viva hesabına ait adresler farklıdır (bkz. Yapılandırma).

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 Viva Wallet Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa, geçerli modda Client ID, Client Secret veya Source Code bulunmadığında uyarır (Viva Wallet is hidden at checkout until the Demo Client ID, Client Secret and Source Code are entered., canlı modda ise Live) ve mağazanın varsayılan para birimi desteklenmediğinde uyarır. Test modu açıkken Test mode is on: payments go to the Viva demo environment. ifadesini gösterir. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz ve en fazla 128 karakter olmalıdır (Enter a title for the payment method (at most 128 characters).), Sort Order tam sayı olmalıdır (Sort Order must be a whole number.), Total 0 veya daha büyük bir sayı olmalıdır (Total: enter a number, 0 or greater.), seçilen coğrafi bölge ve sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez ve sayfa hatayı gösterir. Ayarları kaydetmek, önbelleğe alınmış Viva erişim belirteçlerini siler; böylece yeni kimlik bilgileri hemen kullanılır.

Viva Wallet

Enable/Disable: Enable Viva Wallet payment gateway ödeme yöntemini açar veya kapatır. Varsayılan: off.

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

Description: Confirm Order adımında onay düğmesinin üzerinde müşteriye gösterilen metin. Varsayılan: Pay securely with Viva Wallet — cards, Apple Pay, Google Pay and more.

Test Mode: Viva demo ortamını (demo.vivapayments.com) kullanır. Yeni ödemeler ve API çağrıları demo hesabının kimlik bilgilerini kullanır. Gerçek para çekilmez; Confirm Order adımında müşteriler (Test mode: use Viva demo cards, no real money is charged.) ifadesini görür. Varsayılan: on. Canlı hesapla gerçek ödeme almak için kapatın. Daha önce yapılmış ödemeler, yapıldıkları ortamda doğrulanmaya ve iade edilmeye devam eder.

Sort Order: Viva Wallet'ın ödeme adımındaki ödeme yöntemleri arasındaki konumu. Boş bırakabilir veya tam sayı girebilirsiniz; negatif sayılara izin verilir.

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

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

Demo account (test mode) and Live account

Her iki bölümün de aynı alanları vardır: biri demo hesabı, diğeri canlı hesap içindir. Viva hesabınızda Settings > API Access bölümünü açın ve Smart Checkout kimlik bilgilerini (Client ID, Client Secret), Merchant ID ve API Key'i kopyalayın. Source Code, Sales > Online payments > Websites / apps bölümünde bulunur.

Client ID (Demo) / Client ID (Live): hesabın OAuth 2.0 Smart Checkout Client ID değeri. Ödemeler için gereklidir.

Client Secret (Demo) / Client Secret (Live): hesabın OAuth 2.0 Smart Checkout Client Secret değeri. Ödemeler için gereklidir.

Source Code (Demo) / Source Code (Live): hesabın ödeme kaynağının 4 haneli kodu. Başarı URL'si ve hata URL'si bu mağazaya işaret etmelidir (aşağıya bakın). Ödemeler için gereklidir.

Merchant ID (Demo) / Merchant ID (Live): isteğe bağlı. Yalnızca Viva'nın webhook URL doğrulamasını yanıtlamak için kullanılır.

API Key (Demo) / API Key (Live): isteğe bağlı. Yalnızca Viva'nın webhook URL doğrulamasını yanıtlamak için kullanılır.

Kaydedilmiş Client Secret ve API Key değerleri 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.

Clear saved secrets: Live account bölümünün sonunda. Kaydedilmiş bir gizli bilgiyi işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan, kaydedilmiş değeri korur.

Return URLs and webhook

Addresses for the Viva account: bu alan, Viva hesabına girmeniz gereken mağazanızın üç adresini gösterir. Bu adresler OpenCart kurulumunuzun vitrin adresinden oluşturulur ve OpenCart 3'te şöyle görünür: https://your-store/index.php?route=extension/payment/wcp_viva_gateway/success&, https://your-store/index.php?route=extension/payment/wcp_viva_gateway/fail& ve https://your-store/index.php?route=extension/payment/wcp_viva_gateway/webhook; OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.success&, https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.fail& ve https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.webhook şeklindedir. Ayarların gösterdiği gibi birebir kopyalayın. Başarı ve hata adreslerinin sonundaki & gereklidir: Viva işlemi adrese ekler ve bu olmadan OpenCart bir sayfa bulunamadı yanıtı verir.

Payment source: kullandığınız her hesapta, Sales > Online payments > Websites / apps bölümünden mağazanızın alan adı için bir ödeme kaynağı oluşturun. Success URL ve Failure URL olarak, başarı ve hata adreslerindeki alan adından sonraki yolları girin.

Webhook: Settings > API Access > Webhooks bölümünde, şu olaylar için webhook adresini ekleyin:

Viva, URL'yi kaydetmeden önce kontrol eder. Eklenti, hesabınızın doğrulama anahtarıyla yanıt verir: geçerli modun Merchant ID ve API Key değerleriyle anahtarı alır veya aşağıya girilen anahtarı kullanır. Webhook'lar, müşteri tarayıcıyı kapatsa bile ödemeleri onaylar. Viva webhook'ları imzalı değildir, bu nedenle eklenti webhook'a tek başına asla güvenmez: sipariş durumunu almadan önce her ödeme Viva API ile doğrulanır. Webhook olmadan bir sipariş, müşteri ödemeden sonra mağazaya döndüğünde durum alır.

Webhook Verification Key: isteğe bağlı. Geçerli modun Merchant ID ve API Key değerleriyle anahtarın otomatik alınması için boş bırakın veya Viva hesabınızın doğrulama anahtarını buraya yapıştırın.

Order statuses

OpenCart siparişi Confirm Order adımında durumsuz (eksik bir sipariş) olarak oluşturur. Sipariş, Viva ödemesi doğrulandıktan sonra bir durum alır. Durum alanları, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: ödenmiş bir siparişin alacağı durum. Tek bir durum değişikliğiyle hemen uygulanır.

Processing Status: Default ve Processing için ödenmiş bir siparişin durumu. Varsayılan: Processing.

Complete Status: Completed için ödenmiş bir siparişin durumu. Varsayılan: Complete.

On Hold Status: On Hold için ödenmiş bir siparişin durumu ve Viva ödemesi sipariş tutarıyla veya para birimiyle eşleşmeyen bir siparişin durumu (inceleme için bekletilir, ödenmiş değildir; not nedenini açıklar). Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Cancelled Order Status: bu durumdaki bir sipariş için alınan Viva ödemesi siparişi asla yeniden açmaz; bir not, siparişi geri yüklemenizi veya ödemeyi iade etmenizi ister. Eklenti bu durumu asla ayarlamaz. Varsayılan: Canceled.

Refunded Status: ödeme sipariş sekmesinden tamamen iade edildikten sonra ayarlanır. Sonraki bir ödeme de böyle bir siparişi yeniden açmaz. Varsayılan: Refunded.

Advanced Settings

Brand Color: Viva ödeme sayfası için 6 haneli bir HEX renk kodu, örneğin 0000ff. Baştaki # işareti kaldırılır. Varsayılan renk için boş bırakın. Başka bir değer kaydedilmez: ayarların geri kalanı kaydedilir ve sayfa Brand Color must be a 6-digit HEX code (e.g. 0000ff). The previous value was kept. ifadesini gösterir.

Debug Logging: API isteklerini OpenCart günlük klasöründeki (storage/logs, OpenCart 4'te system/storage/logs) viva_wp_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtarlar, belirteçler ve müşteri verileri günlüğe yazılmaz. Hatalar bu kapalı olsa bile her zaman günlüğe yazılır. Varsayılan: 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çıkken eklentiyi kaldırmak, geçit ayarlarını ve günlüğü siler. Siparişler ve ödeme verileri (Viva ödeme denemeleri, iadeler) asla silinmez. Varsayılan: off.

Import / Export

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

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Viva Wallet). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to the secure Viva Wallet payment page (cards, Apple Pay, Google Pay and more). notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve sayfanın altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı için sipariş para biriminde bir Viva ödeme siparişi oluşturur ve müşteriyi, bir Brand Color ayarlanmışsa onunla birlikte Viva Smart Checkout sayfasına gönderir. Orada müşteri, Viva hesabınızda etkin olan yöntemlerden biriyle öder. Müşterinin e-postası, adı, telefonu, ülkesi ve mağaza dili Viva'ya aktarılır. Ödeme Viva'da OpenCart # ve sipariş numarası olarak görünür; müşteriye Order, sipariş numarası, at ve mağaza adınız olarak açıklanır. Viva ödeme siparişi 30 dakika sonra sona erer.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Viva onayladıktan sonra ödenmiş olarak işaretlenir: eklenti işlemi, müşteri döndüğünde ve webhook geldiğinde Viva API'sinden yeniden okur. Sipariş daha sonra OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır; müşteri OpenCart sipariş başarı sayfasını görür. Ödeme henüz onaylanmamışsa Payment confirmation sayfası We are waiting for Viva Wallet to confirm your payment. You will receive an e-mail as soon as it is confirmed. mesajını, Check again ve Back to checkout düğmeleriyle birlikte gösterir. Sepet, ödeme onaylanana kadar saklanır; webhook, Viva onayladığı anda sipariş durumunu ayarlar. OpenCart 4'te müşteri Viva sayfasından döndüğünde, kısa bir ara sayfa dönüş adresini mağazanızdan yeniden açar; böylece sepet ve müşteri oturumu korunur.

Ödeme başarısız olur veya müşteri Viva sayfasında iptal ederse sipariş durumsuz kalır ve sepet saklanır. Müşteri, The Viva Wallet payment was not completed. Please try again or choose another payment method. veya The Viva Wallet payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme adımına döner ve yeniden ödeme yapabilir. Her yeni deneme yeni bir Viva ödeme siparişi başlatır. Bir sepet yalnızca bir kez ödenir: sepet aynı ödeme işleminin başka bir siparişi tarafından zaten ödenmişse müşteri doğrudan başarı sayfasına gider. 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 ödeme sürecindeki siparişi günceller. 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 sürecinde tutar. Başarısız veya iptal edilmiş bir ödemeden sonra müşteri aynı siparişi yeni bir Viva ödeme siparişiyle yeniden öder. Bu arada sipariş kapatılmışsa (örneğin siz iptal ettiyseniz) ya da sepet değiştikten sonra ödenmişse, müşteri This order can no longer be paid. Please confirm your order again. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişi öder.

Viva ödemeyi başlatamazsa müşteri, düğmenin üzerinde bir mesajla Confirm Order adımında kalır: Viva Wallet payments are not available at the moment. Please choose another payment method or contact us. (eksik veya hatalı kimlik bilgileri) veya We could not connect to Viva Wallet. Please try again in a moment or choose another payment method. Teknik neden günlüğe yazılır.

Dönüş sayfaları, sipariş başarı sayfasını yalnızca ödeme yapan müşteriye gösterir. Dönüş adresini açan diğer herkes, sipariş ayrıntısı olmadan sipariş geçmişine veya ödeme adımına yönlendirilir.

Webhook, mağaza bakım modundayken de çalışır, çünkü OpenCart ödeme eklentisi isteklerine izin verir. OpenCart 4'te eklentinin bir başlangıç eylemi webhook'u ve başarı ile hata adreslerini geçirir.

Eklenti yalnızca tek seferlik ödemeleri kabul eder; bunlar Viva sayfasında hemen tahsil edilir. Ön provizyon ve tahsilat, taksit, kayıtlı kartlar, abonelikler, Viva Native Checkout (kendi sayfanızdaki kart alanları) veya POS terminalleri yoktur. Müşteri yeni bir deneme başlattığında, eski ödenmemiş Viva ödeme siparişi iptal edilmez; Viva bunu 30 dakika sonra sona erdirir.

Siparişler ve iadeler

Order statuses

Durum yok (eksik sipariş): müşteri Viva'ya yönlendirildi ve ödeme yapmadı, ödeme başarısız oldu veya iptal edildi ya da Viva ödemeyi henüz tamamlamadı. Müşteri yeniden ödeyebilir. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir. 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.

Order Status After Payment (varsayılan Processing): ödeme onaylandı. Bir not, tutarı, işlemi, Viva sipariş kodunu, ortamı (demo veya canlı) ve onayın nasıl yapıldığını (webhook veya müşterinin dönüşü) gösterir.

Uyuşmazlıktan sonra On Hold Status (varsayılan Pending): Viva, sipariş tutarından veya para biriminden farklı bir tutar veya para birimi bildirdi. Sipariş ödenmiş olarak işaretlenmez ve Viva Wallet payment held for review notu nedeni açıklar. Viva panelindeki ödemeyi siparişle karşılaştırın ve siparişi manuel olarak tamamlayın veya iade edin. Aynı sipariş için eşleşen bir ödeme daha sonra gelirse sipariş ödenmiş duruma geçer.

Cancelled Order Status veya Refunded Status durumundaki bir sipariş için gelen ödeme, sipariş durumunu değiştirmez; bir not, siparişi geri yüklemenizi veya Viva panelinde ödemeyi iade etmenizi ister. Zaten ödenmiş bir sipariş veya zaten ödenmiş bir sepetin başka bir siparişi için ikinci bir ödeme gelirse sipariş değiştirilmez; ödenmiş siparişteki bir not, kopyayı Viva panelinde iade etmenizi ister.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır. Durum değişiklikleri müşteriyi kendiliğinden bilgilendirmez; OpenCart, ödenmiş bir sipariş ilk kez durum aldığında olağan sipariş e-postasını gönderir.

VibeFox Viva Wallet Gateway tab

Sales > Orders bölümünde, Viva Wallet ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Viva Wallet Gateway sekmesi Viva order code, demo ödemeleri için Demo etiketli Transaction ID, Environment / Source Code, Viva status, Paid / refunded tutarlarını, iade formunu, iade geçmişini, siparişin Viva payment attempts kayıtlarını (birden fazla varsa) ve siparişin Viva Wallet notes notlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

Refunds

VibeFox Viva Wallet Gateway sekmesinde Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Viva Wallet düğmesine tıklayın. Refund this amount via Viva Wallet? This cannot be undone. sorusunu onaylayın. Onaylanmış bir Viva ödemesi olan siparişler için 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). Sipariş sonradan düzenlenmiş olsa bile Viva'nın ödeme için tahsil ettiği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı hesaba (demo veya canlı), ödemenin para biriminde gönderilir; bu nedenle o hesabın Client ID ve Client Secret değerleri girilmiş olmalıdır. Viva iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara Viva iade işlemiyle birlikte eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan, manuel bir durum değişikliği gibi Refunded Status durumuna alır. Kısmi iade durumu değiştirmez. Uyuşmazlıktan sonra incelemeye alınan bir sipariş onaylanmış bir ödemeye sahip değildir ve sekmeden iade edilemez.

Sales > Returns bölümündeki ürün iadeleri Viva üzerinden para geri göndermez. Viva panelinde yapılan iadeler içe aktarılmaz. Gerekirse siparişi manuel olarak güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Viva Wallet Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Viva Wallet 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ı 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-viva satırı ile 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. Bloktaki metinler 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 tarihiyle 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 adresinde. 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 Viva Wallet ödeme adımı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 başlatılmış ödemeler Viva webhook'u ve mağaza dönüşü ile yine onaylanır, iadeler de çalışır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda 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 her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Viva Wallet ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun Client ID, Client Secret ve Source Code değerlerine sahip olduğunu kontrol edin (test modunda Demo alanları, canlı modda Live alanları). Mağazada seçili para birimi EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK veya CHF'den biri olmalıdır. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin. Kimlik bilgileri eksik olduğunda ayarlar sayfası uyarı gösterir.

Ödeme gerçekleşti ama sipariş durumsuz kalıyor: webhook çalışmıyor. Viva'da, kullandığınız hesapta (demo veya canlı) webhook'un var olduğunu, URL'sinin ayarlarda gösterilenle birebir aynı olduğunu ve Transaction Payment Created seçeneğinin işaretli olduğunu kontrol edin. O ödemenin hesabının Client ID ve Client Secret değerlerinin hâlâ girili olduğunu doğrulayın: eklenti ödemeyi doğrulamak için bunlara ihtiyaç duyar. Debug Logging seçeneğini açın ve Log alanına bakın. Müşteri ödemeden sonra mağazaya döndüğünde sipariş de durum alır.

Müşteri bir sayfa bulunamadı hatasıyla karşılaşıyor: ödeme kaynağının Success URL veya Failure URL'si & ile bitmiyor. Yolları ayarların gösterdiği gibi birebir kopyalayın.

Viva webhook URL'sini doğrulayamıyor: geçerli modun Merchant ID ve API Key değerlerini (veya doğrulama anahtarının kendisini Webhook Verification Key alanına) girin, kaydedin ve Viva'da yeniden doğrulayın. Diğer hesabın webhook'unu doğrulamak için önce Test Mode seçeneğini değiştirin veya o hesabın anahtarını girin.

Webhook bir hatayla yanıt veriyor: Viva, mağazanızın yanıtını gösterir ve başarısız webhook'ları yeniden dener. verification_failed (HTTP 500), ödemeyi doğrulamak için Viva API'sine ulaşılamadığı veya sipariş durumunun ayarlanamadığı anlamına gelir. busy (HTTP 503), siparişin aynı anda başka bir istek tarafından işlendiği anlamına gelir. transaction_not_found (HTTP 404), işlemin o ödemenin hesabında bulunmadığı anlamına gelir; örneğin kimlik bilgileri hatalı olabilir. Aynı Viva hesabındaki diğer mağazaların ödemelerine ilişkin olaylar ignored yanıtı alır.

Müşteri Confirm Order sonrasında bir hata görüyor: eklenti sayfasındaki Log alanına bakın. Hatalı bir Client ID veya Client Secret, Viva Wallet ödemelerinin kullanılamadığı mesajını verir. Viva'ya ulaşılamazsa veya ödeme siparişini reddederse (örneğin Source Code başka bir hesaba aitse), müşteri mağazanın Viva Wallet'a bağlanamadığı mesajını alır. This payment method is not available. ifadesi, ödeme oturumunun artık siparişle eşleşmediği anlamına gelir: müşteri ödeme sayfasını yeniler.

Müşteri döndüğünde We could not find your order. If you were charged, please contact us.: mesajını görüyor: dönüş adresindeki Viva sipariş kodu bu mağazaya ait bir ödeme değil; örneğin başka bir mağazanın ödeme kaynağı buraya yönlendiriyor olabilir. Ödeme kaynağının Success URL ve Failure URL değerlerini kontrol edin.

Ödemeden sonra sipariş inceleme durumunda: VibeFox Viva Wallet Gateway sekmesindeki notları okuyun (bkz. Order statuses), ardından siparişi tamamlayın veya ödemeyi iade edin.

Sekmede iade formu yok: sekme nedenini gösterir: siparişin onaylanmış bir Viva ödemesi yok (Transaction ID not found. Cannot process refund.), tamamen iade edilmiş, ödemenin hesabına ait kimlik bilgileri eksik veya kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok.

İade şu hatayla başarısız oluyor: This payment was made in the Viva demo (or live) environment: ödemenin yapıldığı hesabın Client ID ve Client Secret değerleri girilmemiş. Bunları girip yeniden deneyin. Diğer iade hataları Viva'nın mesajını gösterir.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Viva Wallet Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Order statuses bölümündeki durum alanları; bunlar yeniden kurulumda varsayılan değerlerine döner. Önbelleğe alınmış Viva erişim belirteçleri ve webhook anahtarları her zaman silinir. OpenCart 4'te eklentinin olayı ve bakım modunda webhook ile dönüş adreslerini geçiren başlangıç eylemi de her zaman silinir. Delete Data on Uninstall açıksa diğer geçit ayarları (başlık, açıklama, test modu, kimlik bilgileri, ödemeden sonraki sipariş durumu, marka rengi, günlüğe kaydetme) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Viva ödeme denemeleri ve iadeler 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 Viva Wallet 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.

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