VibeFox Authorize.Net 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.

HTTPS: ödeme sayfanız HTTPS kullanmalıdır. Accept.js, düz HTTP sayfalarında çalışmaz.

Authorize.Net hesabı: Authorize.Net hesabınızın API Login ID, Transaction Key ve Public Client Key bilgilerine ihtiyacınız vardır; webhook kullanıyorsanız bir Signature Key de gerekir. Canlı (account.authorize.net) ve sandbox (sandbox.authorize.net) hesaplarının kimlik bilgileri farklıdır. Authorize.Net hesapları ABD, Kanada, Birleşik Krallık, Avrupa, Avustralya ve Yeni Zelanda'daki satıcılar için kullanılabilir.

Para birimi: sipariş para birimi USD, CAD, CHF, DKK, EUR, GBP, NOK, PLN, SEK, AUD veya NZD olmalı ve Authorize.Net hesabınız bu para biriminde hesap kesmelidir. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

İndirilen dosya, iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Arşivi bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_authorizenet_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_authorizenet_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun 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_authorizenet_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, arşivdeki 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 Authorize.Net 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 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ündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Sandbox ve canlı hesapların kimlik bilgilerini girin (bkz. Yapılandırma). İsterseniz webhook'u da ayarlayın.

5. Enable/Disable seçeneğini açın, Transaction type seçeneğini belirleyin ve Save düğmesine tıklayın. Sandbox modunda 4111 1111 1111 1111 kartı, gelecekteki herhangi bir son kullanma tarihi ve herhangi bir CVV ile bir ödeme deneyin, ardından Sandbox 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_authorizenet_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

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

3. Extensions > Extensions bölümüne gidin ve tür olarak Payments seçin. VibeFox Authorize.Net 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ı, ayarları ve webhook'u OpenCart 3 için 3-5. 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. Webhooks (recommended)).

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 Authorize.Net Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, mağaza HTTPS kullanmadığında (Accept.js yalnızca HTTPS sayfalarında çalışır), mağazanın varsayılan para birimi Authorize.Net tarafından desteklenmediğinde, geçerli modda API Login ID, Transaction Key veya Public Client Key bulunmadığında (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve geçerli modda Signature Key bulunmadığında (bu durumda webhook'lar devre dışı kalır) sizi uyarır. Sandbox modu açıkken Sandbox mode is on: test transactions, no real charges. mesajını gösterir. Eklentiyi değiştirme izni olmadan sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title alanı 1 ila 128 karakter olmalı, Transaction type iki seçenekten biri olmalı, Sort Order tam sayı olmalı, Total 0 veya daha büyük bir sayı olmalı ve bölge (geo zone) ile sipariş durumları mevcut olmalıdır. Bir alan hatalıysa hiçbir şey kaydedilmez ve sayfa alanı belirtir.

Authorize.Net

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Aynı zamanda siparişte kaydedilen ödeme yöntemi adıdır. Varsayılan: Credit Card. Zorunlu, 128 karaktere kadar.

Description: müşterinin Confirm Order adımında, kart formunun üstünde gördüğü metin. Varsayılan: Pay securely with your credit card via Authorize.Net.

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

Geo Zone: kart formunu yalnızca seçilen bölgedeki ödeme adresleri için gösterin. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones altında ayarlanır.

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

API credentials

Authorize.Net Merchant Interface'te Account > Settings > Security Settings bölümünü açın. API Credentials & Keys altında API Login ID bilgisini kopyalayın ve bir Transaction Key ile bir Signature Key oluşturun. Manage Public Client Key altında Public Client Key bilgisini kopyalayın. Sandbox ve canlı mod farklı kimlik bilgileri kullanır. Bölüm her iki modun alanlarını gösterir, böylece iki kimlik bilgisi setini de saklayabilirsiniz.

Sandbox mode: Authorize.Net sandbox'ını kullanır (test işlemleri, gerçek tahsilat yok). API uç noktasını, Accept.js'i ve yeni ödemelerde kullanılan kimlik bilgisi setini değiştirir. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın. Açıkken müşteriler kart formunun üstünde Sandbox mode: ile birlikte 4111 1111 1111 1111 test kartını görür.

Sandbox API Login ID ve Live API Login ID: sandbox veya canlı hesabın API Login ID bilgisi.

Sandbox Transaction Key ve Live Transaction Key: o hesabın Transaction Key bilgisi.

Sandbox Public Client Key ve Live Public Client Key: Accept.js'in tarayıcıda kullandığı genel anahtar.

Sandbox Signature Key ve Live Signature Key: yalnızca webhook'lar için gereklidir. Her bildirimin X-ANET-Signature başlığını doğrular.

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

Payment

Transaction type: kartın nasıl tahsil edileceği. Bir ön provizyon (authorization) 30 gün sonra sona erer.

Webhooks (recommended)

Webhook'lar olmadan, Fraud Detection Suite tarafından tutulan veya Authorize.Net panelinde tahsil edilen ya da iptal edilen siparişlerin elle güncellenmesi gerekir. Merchant Interface'te Account > Settings > Business Settings > Webhooks bölümüne gidin ve hem sandbox hem de canlı hesapta Add Endpoint düğmesine tıklayın. Bu bölümde Endpoint URL altında gösterilen URL'yi kullanın. OpenCart 3'te URL şöyle görünür: https://your-store/index.php?route=extension/payment/wcp_authorizenet_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_authorizenet_gateway/payment/wcp_authorizenet_gateway.webhook şeklindedir ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. URL'yi ayarların gösterdiği şekliyle birebir kopyalayın. Şu olayları seçin (bu bölümde de listelenmiştir):

Her hesabın Signature Key bilgisini Sandbox Signature Key veya Live Signature Key alanına girin. Geçerli imzası olmayan webhook'lar reddedilir. Bir bildirim, ödemenin yapıldığı modun anahtarıyla imzalanmış olmalıdır; diğer modun bir bildirimi hiçbir şeyi değiştirmez. Her bildirim için eklenti, sipariş değişmeden önce Authorize.Net'ten işlemin güncel durumunu ve tutarını da sorgular, bu nedenle tekrarlanan bildirimler hiçbir şeyi değiştirmez. Webhook, mağaza bakım modundayken de çalışır, çünkü OpenCart ödeme eklentilerinin isteklerine izin verir.

Orders

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, Authorize.Net kart için yanıt verdikten sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: kart tahsil edildi (Authorize and capture veya daha sonra yapılan bir tahsilat). Varsayılan: Processing.

Authorized Status: Authorize only: tutarlar ayrıldı, henüz tahsil edilmedi. Sipariş sekmesindeki Capture payment yalnızca bu durumda sunulur. Varsayılan: Pending.

On Hold (Review) Status: Fraud Detection Suite tarafından incelemek üzere tutuldu veya tahsil edilen ya da çekilen tutar siparişten farklı. Bir not nedenini açıklar. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumlarınızı oluşturabilir ve burada seçebilirsiniz.

Canceled Status: Authorize.Net'te ödeme olmadan reddedildi, iptal (void) edildi veya süresi doldu (webhook), ya da ön provizyon sipariş sekmesinden iptal edildi. Varsayılan: Canceled.

Refunded Status: ödeme sipariş sekmesinden tamamen iade edildikten (veya ödenmiş bir işlem iptal edildikten) sonra ayarlanır. Varsayılan: Refunded.

Advanced

Debug log: API isteklerini ve yanıtlarını OpenCart log klasöründe (storage/logs) wc_ang_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz; 5 MB'a ulaştığında wc_ang_debug.old.log.php dosyasına taşınır. Anahtarlar, kart jetonları ve kişisel veriler maskelenir. Varsayılan: kapalı. Reddedilen veya başarısız ödemeler, API hataları ve başarısız iadeler gibi hatalar, bu kapalıyken bile her zaman kaydedilir.

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 ayarları ve günlüğü siler. Authorize.Net işlemleri ve iadeleri her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da tahsil edilebilir ve iade edilebilir. Varsayılan: kapalı.

Import / Export

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Transaction Key ve Signature Key bilgileri 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ı gizli anahtarlar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card). Confirm Order adımında müşteri açıklamanızı görür ve onay düğmesinin üstündeki formda kart numarasını, son kullanma tarihini (MM/YY) ve kart güvenlik kodunu (CVV) girer. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Accept.js, Authorize.Net'ten yalnızca bu form ile yüklenir. Müşteri Confirm Order düğmesine tıkladığında Accept.js, kart bilgilerini tarayıcıda tek kullanımlık bir jetonla değiştirir. Kart alanlarının form adı yoktur, bu nedenle kart numarası ve CVV hiçbir zaman sunucunuza gönderilmez.

Eklenti, jetonu sipariş para biriminde sipariş toplamı için Authorize.Net API'si üzerinden tahsil eder. Fatura adresi, e-posta ve IP adresi, adres doğrulaması ve dolandırıcılık filtreleri için işlemle birlikte gönderilir; sipariş numarası ise fatura numarası olarak iletilir. Sipariş, yalnızca Authorize.Net onaylarsa ödenmiş olarak işaretlenir: işlem onaylanırsa sipariş, OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle birlikte durumunu alır, sepet boşaltılır ve müşteri OpenCart sipariş başarı sayfasında Your card payment has been received. mesajını görür. Authorize only ile sayfa Your card payment has been authorized. The amount will be charged when your order is processed. mesajını gösterir. Fraud Detection Suite işlemi tutarsa Your payment is being reviewed. We will update your order as soon as the review is complete. mesajı gösterilir.

Kart reddedilirse müşteri Confirm Order adımında kalır ve formun altında Payment failed: ile birlikte nedeni görür; örneğin kartın reddedilmesi, yanlış kart güvenlik kodu veya süresi dolmuş kart. Sipariş durumsuz kalır, sepet korunur ve müşteri başka bir kart girebilir. Yapılandırma ve API hataları müşterilere gösterilmez: genel bir mesaj görürler, ayrıntılar ise günlüğe gider. Mağaza Authorize.Net'e ulaşamazsa müşteri Payment error: unable to connect to the payment gateway. Please try again. mesajını görür. Kart alanları boşsa form Please enter the card number, expiry date and card code. mesajını ister.

Çift tıklama, ikinci bir sekme veya tekrarlanan gönderim hiçbir siparişi iki kez tahsil etmez. OpenCart 3'te Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturulur; bu nedenle tek bir sepet birden fazla siparişe sahip olabilir (OpenCart 4'te önceki bir sipariş veya ikinci bir tarayıcı sekmesi de aynı sepeti tutabilir). Bunlardan biri ödendiğinde, aynı sepetteki başka bir sipariş tahsil edilmez. Müşteri This cart has already been paid with order #…. Please check your order history — do not pay again. mesajını görür. İlk deneme hâlâ sürerken yapılan ikinci deneme Your payment is already being processed. Please wait a moment and check your order history before trying again. mesajını gösterir. Bir ödeme onaylanmış ama sipariş durumu ayarlanamamışsa müşteri Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. mesajını görür. Sipariş, bir sonraki denemede veya webhook ile onaylanan ödemeden durumunu alır; kart yeniden tahsil edilmez.

OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer. Kart formu bu durumda sipariş onay bloğunda, sayfanın altında, Confirm Order düğmesinin üstünde görünür. Ödeme adresi OpenCart 4'te isteğe bağlıdır: ödeme adresi yoksa teslimat adresi fatura adresi olarak Authorize.Net'e gönderilir. OpenCart 4, ödeme sürecinde tek bir sipariş tutar ve günceller; bu nedenle reddedilen bir karttan sonra müşteri aynı siparişi öder. Bu sipariş bu arada kapatıldıysa (örneğin siz iptal ettiyseniz) veya zaten ödendiyse ve sepette artık yeni bir satın alma varsa, Confirm Order müşteriyi ödeme sayfasına geri götürür ve bir sonraki Confirm Order yeni bir siparişin ödemesini alır. Sipariş kapatılmışsa müşteri ödeme sayfasının üstünde Your previous order is closed (cancelled or refunded by the store). Please confirm the order again: the cart will be paid with a new order. mesajını, ödenmişse Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order. mesajını görür. Sepetteki bir değişiklik, yeni adet dahil, yeni bir sepet sayılır ve kendi ödemesini gerektirir.

Tahsil edilen tutar sipariş toplamıyla eşleşmezse sipariş bir notla birlikte On Hold (Review) Status durumuna geçer ve ödeme, gerçekte tahsil edilen tutar için kaydedilir.

Eklentide kayıtlı kartlar veya müşteri profilleri, abonelikler veya yinelenen ödemeler, eCheck/ACH, Apple Pay, Google Pay, PayPal veya 3-D Secure, bir ön provizyonun kısmi tahsilatı ve otomatik para birimi dönüşümü yoktur.

Siparişler ve iadeler

Order statuses

No status (missing order): kart reddedildi veya ödeme başarısız oldu. 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): kart tahsil edildi (Authorize and capture) veya bir ön provizyon tahsil edildi. Bir not tutarı, Trans ID'yi, onay kodunu, kart tipini ve son dört haneyi gösterir.

Authorized Status (default Pending): tutarlar yalnızca ön provizyonla ayrıldı (Authorize only). Teslimattan önce tahsil edin.

On Hold (Review) Status (default Pending): Fraud Detection Suite işlemi inceleme için tuttu, tahsil edilen tutar sipariş toplamıyla eşleşmiyor veya webhook ile bildirilen bir tahsilat sipariş tutarıyla eşleşmiyor. Not bunu açıklar. Tutulan işlemi Authorize.Net panelinde onaylayın veya reddedin; webhook'larla sipariş otomatik olarak güncellenir.

Canceled Status (default Canceled): bir webhook, sipariş ödenmeden önce işlemin reddedildiğini, iptal edildiğini (void) veya süresinin dolduğunu bildirdi ya da tahsil edilmemiş bir ön provizyonu iptal ettiniz. Ödenmiş bir siparişin işlemi Authorize.Net panelinde iptal edilirse, durumu değişmez ve bir uyarı notu eklenir.

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

OpenCart 4'te ödenmemiş bir sipariş, müşteri Confirm Order adımına geri döndüğünde OpenCart 4'ün ayarladığı Voided durumunu alabilir. Eklenti bu siparişi durumsuz bir sipariş gibi değerlendirir: sonraki bir ödeme veya webhook yine de durumunu ayarlar.

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

VibeFox Authorize.Net Gateway tab

Sales > Orders bölümünde Authorize.Net ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Authorize.Net Gateway sekmesi; sandbox ödemeleri için Sandbox etiketiyle birlikte Trans ID'yi, Transaction type'ı, işlemin Status bilgisini, Card ve onay kodunu, Charged / order / refunded tutarlarını, tahsilat düğmesini, iade formunu, iade geçmişini ve siparişin Authorize.Net notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir. Tahsilat ve iadeler, eklentiyi değiştirme iznini gerektirir (System > Users > User Groups bölümünde ayarlanır).

Capture

Authorized Status durumundaki bir sipariş için sekmede Capture payment düğmesine tıklayın ve Capture the authorized amount through Authorize.Net? sorusunu onaylayın. Ön provizyonla ayrılan tutar tahsil edilir ve sipariş Order Status After Payment durumunu alır. Tahsilat başarısız olursa hata gösterilir ve notlara eklenir. Authorize.Net panelinden de tahsilat yapabilirsiniz; webhook'larla sipariş otomatik olarak güncellenir.

Refunds

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın, Refund via Authorize.Net düğmesine tıklayın ve Refund this amount through Authorize.Net? This cannot be undone. sorusunu onaylayın. Tam tutarda iade, işlem henüz mutabakata girmemişse önce işlemi iptal eder; tahsil edilmemiş bir ön provizyon ise onu iptal eder. Mutabakata girmiş işlemler, genellikle 24 saat sonra, tamamen veya kısmen iade edilebilir. Mutabakattan önce kısmi iade mümkün değildir: işlemi iptal etmek için tam tutarı iade edin veya mutabakattan sonra tekrar deneyin. İadeler, Authorize.Net'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar uyuşmazlığından sonra en fazla müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz, sipariş toplamına kadar değil. Authorize.Net iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade veya iptal, iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirilmeden ve ürünleri stoğa geri eklemeden, elle yapılan bir durum değişikliği gibi Refunded Status durumuna alır (yalnızca bir ön provizyon iptal edildiyse Canceled Status). Kısmi iade durumu değiştirmez. Bir işlem incelemek üzere tutulurken iade sunulmaz.

Bir siparişin tahsilat, iade ve webhook kontrolleri, siparişin ödendiği modun kimlik bilgilerini kullanır; bu nedenle Sandbox mode seçeneğini değiştirdikten sonra da diğer moddaki siparişler tahsil edilip iade edilebilir. Bu siparişler tamamlanana kadar o modun kimlik bilgilerini ilgili alanlarında tutun.

Sales > Returns bölümündeki ürün iadeleri Authorize.Net üzerinden para geri göndermez. Authorize.Net panelinde yapılan iadeler mağazaya bildirilmez: siparişi elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Authorize.Net Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Authorize.Net Gateway > Edit sayfasındaki ilk bloktur ve ayarların üstündedir. 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 tarihi 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. Altında Product: opencart-payment-authorizenet 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 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 bildirir; ö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 veya hesabınızda bir alan adı yuvasını boşalttı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 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 Authorize.Net kart ödemesi ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcısı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar yoksa ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder, tahsilat ve iadeler ç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 veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, ardından her hafta bir kez. Cron işi gerekmez. Eklentinin kaldırılması her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Kart ödemesi ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modda API Login ID, Transaction Key ve Public Client Key bulunduğunu kontrol edin. Ayarlar sayfası eksik olan bir şey varsa uyarı gösterir. Müşterinin para biriminin desteklendiğini, ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme başarılı oldu ama sipariş ön provizyonlu veya inceleme durumunda kaldı: işlem tipi Authorize only (siparişin sekmesinde tahsil edin) ya da Authorize.Net işlemi inceleme için tutmuştur. Authorize.Net panelinde onaylayın veya reddedin. Bu siparişlerin otomatik güncellenmesi için webhook'u ayarlayın: uçnoktanın (endpoint) kullandığınız modun hesabında var olduğunu, URL'sinin Endpoint URL alanında gösterilenle birebir aynı olduğunu, dört olayın seçili olduğunu ve o hesabın Signature Key bilgisinin girildiğini kontrol edin.

Webhook yanıtı: webhooks are not configured: iki mod için de Signature Key girilmemiş.

Webhook yanıtı: invalid signature: Signature Key başka bir hesaba ait veya Authorize.Net'te bir anahtar değiştirilmiş. Signature Key'i yeniden oluşturun veya kopyalayın ve kendi modunun alanına yapıştırın.

Webhook yanıtı: mode mismatch: bildirim bir modun anahtarıyla imzalanmış, ancak ödeme diğer modda yapılmış. Sandbox ve canlı Signature Key bilgilerinin yer değiştirmediğini kontrol edin.

Webhook yanıtı: verification failed, retry later: mağaza işlemi Authorize.Net API'sinden okuyamadı veya ödemenin modunun kimlik bilgileri eksik. Authorize.Net teslimatı yeniden dener.

Webhook yanıtı: busy, retry later: sipariş aynı anda başka bir istek tarafından güncelleniyordu veya işlem başarısız oldu. Authorize.Net teslimatı yeniden dener. Nedeni görmek için Log alanına bakın.

Webhook URL'si tarayıcıda method not allowed gösteriyor: bu normaldir. URL yalnızca Authorize.Net'ten gelen istekleri kabul eder.

Kart formu The secure card form (Accept.js) could not be loaded mesajını gösteriyor: ödeme sayfası HTTPS kullanmalı ve geçerli modun Public Client Key ile API Login ID bilgileri doğru olmalıdır.

Payment error: the card could not be tokenized: Accept.js bir jeton döndürmedi. Müşteri kart bilgilerini yeniden girip tekrar denemelidir.

Müşteri This payment method is not available mesajını görüyor: ödeme oturumu artık siparişle eşleşmiyor, bu arada ödeme yöntemi kapatılmış, kimlik bilgileri eksik veya sipariş toplamı sıfır. Please reload the checkout page mesajıyla müşteri ödeme sayfasını yeniden yükler.

Müşteri genel bir hata görüyor: eklenti sayfasındaki Log alanına bakın; hatalar her zaman orada kaydedilir. Hesabın desteklemediği bir para birimi Authorize.Net tarafından reddedilir.

Kısmi iade, işlem henüz mutabakata girmediği için başarısız oluyor: işlemi iptal etmek için tam tutarı iade edin veya genellikle 24 saat içinde mutabakattan sonra tekrar deneyin.

İade veya tahsilat mod ile ilgili bir mesajla başarısız oluyor: ödeme sandbox veya canlı modda yapılmış ve o modun API Login ID ile Transaction Key bilgileri ayarlanmamış. Bunları girip tekrar deneyin.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Authorize.Net 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, ödeme sayfasının üstündeki mesajı gösteren olay dahil olayları ve bakım modunda webhook'a izin veren başlangıç eylemini de kaldırılır). Delete data on uninstall açıksa diğer ayarlar (başlık, açıklama, sandbox modu, kimlik bilgileri, işlem tipi, günlükleme) ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanır. Authorize.Net işlemleri ve iadeleri her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da tahsil edilebilir ve iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Authorize.Net 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) tıklayın.

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