VibeFox Authorize.Net for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin olmalı. WooCommerce olmadan eklenti yönetici alanında bir uyarı gösterir ve ödeme yöntemi yüklenmez.

PHP: 8.0 veya üzeri.

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

Authorize.Net hesabı: Authorize.Net hesabınızın API Login ID, Transaction Key ve Public Client Key değerlerine, webhook kullanacaksanız bir Signature Key'e ihtiyacınız var. Canlı (account.authorize.net) ve test (sandbox.authorize.net) hesapların kimlik bilgileri farklıdır. Authorize.Net hesapları ABD, Kanada, Birleşik Krallık, Avrupa, Avustralya ve Yeni Zelanda'daki satıcılara sunulur.

Para birimi: mağaza para birimi USD, CAD, CHF, DKK, EUR, GBP, NOK, PLN, SEK, AUD veya NZD olmalı ve Authorize.Net hesabınız bu para biriminde uzlaştırma yapmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_authorizenet_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Authorize.Net > Manage yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Test ve canlı hesapların kimlik bilgilerini girin (bkz. Yapılandırma). İsteğe bağlı olarak webhook'u kurun.

6. Enable/Disable seçeneğini açın, Transaction type seçeneğini belirleyin ve kaydedin. Test ortamında 4111 1111 1111 1111 kart numarası, gelecekte bir son kullanma tarihi ve herhangi bir CVV ile bir ödeme deneyin, ardından Sandbox mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Authorize.Net. Alanların üstünde sayfa, site HTTPS kullanmıyorsa (Accept.js yalnızca HTTPS sayfalarında çalışır) ve mağaza para birimi desteklenmiyorsa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) sizi uyarır. Sayfa yalnızca seçili modun kimlik bilgisi alanlarını gösterir.

Genel

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ı. Varsayılan: Credit Card.

Description: ödeme sayfasında kart formunun üstünde gösterilen metin. Varsayılan: Pay securely with your credit card via Authorize.Net.

API kimlik bilgileri

Authorize.Net Merchant Interface'te Account > Settings > Security Settings bölümünü açın. API Credentials & Keys altında API Login ID'yi kopyalayın ve bir Transaction Key ile bir Signature Key oluşturun. Manage Public Client Key altında Public Client Key'i kopyalayın. Test ve canlı ortamlar farklı kimlik bilgileri kullanır.

Sandbox mode: Use the Authorize.Net sandbox (test transactions, no real charges). API uç noktasını, Accept.js'i ve aşağıdaki kimlik bilgisi grubunu değiştirir. Varsayılan: açık. Gerçek ödeme almak için işaretini kaldırın.

Live API Login ID ve Sandbox API Login ID: canlı veya test hesabının API Login ID'si.

Live Transaction Key ve Sandbox Transaction Key: o hesabın Transaction Key'i.

Live Public Client Key ve Sandbox Public Client Key: tarayıcıda Accept.js tarafından kullanılan genel anahtar.

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

Ödeme

Transaction type: kartın nasıl çekileceği. Bir ön provizyon 30 gün sonra sona erer.

Webhook'lar (önerilir)

Webhook'lar olmadan, Fraud Detection Suite tarafından beklemeye alınan veya Authorize.Net panelinde tahsil edilen ya da iptal edilen siparişlerin elle güncellenmesi gerekir. Merchant Interface'te Account > Settings > Business Settings > Webhooks yolunu izleyin ve Add Endpoint düğmesine tıklayın. Eklenti ayarlarının bu bölümünde gösterilen URL'yi kullanın. URL şuna benzer: https://your-site/wc-api/wc_authorizenet/. Şu olayları seçin:

Hesabın Signature Key'ini Live Signature Key veya Sandbox Signature Key alanına girin. Geçerli imzası olmayan webhook'lar reddedilir. Eklenti, her bildirim için sipariş değişmeden önce işlemin güncel durumunu ve tutarını Authorize.Net'ten de sorar; böylece tekrarlanan bildirimler hiçbir şeyi değiştirmez.

Gelişmiş

Debug log: Log API requests and responses seçeneği, WooCommerce > Status > Logs bölümüne, kaynak wcp_authorizenet_gateway olarak yazar. Anahtarlar, kart jetonları ve kişisel veriler maskelenir. Varsayılan: kapalı.

Delete data on uninstall: Remove the settings and the Authorize.Net order meta when the plugin is deleted. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card) ve ödeme sayfasında kart numarasını, son kullanma tarihini (AA/YY) ve kart güvenlik kodunu (CVV) girer. Test ortamında form, 4111 1111 1111 1111 test kartını gösteren bir ipucu içerir. Sipariş verildiğinde Accept.js, kart verilerini tarayıcıda tek kullanımlık bir jetonla değiştirir. Kart alanlarının form adı olmadığı için kart numarası ve CVV sunucunuza hiçbir zaman gönderilmez.

Eklenti, jetonu sipariş para biriminde sipariş toplamı için Authorize.Net API üzerinden çeker. Fatura adresi, e-posta ve IP adresi, adres doğrulaması ve dolandırıcılık filtreleri için işlemle birlikte gönderilir. Ödeme onaylanırsa müşteri sipariş alındı sayfasına gider ve sepet boşaltılır.

Kart reddedilirse müşteri ödeme sayfasında kalır ve Payment failed: ardından nedeni görür; örneğin kartın reddedilmesi, yanlış kart güvenlik kodu veya süresi dolmuş kart. Yapılandırma ve API hataları müşteriye gösterilmez: müşteri genel bir mesaj görür, ayrıntılar sipariş notuna ve günlüğe yazılır. 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.

Tekrarlanan gönderimler ve aynı siparişin tekrarlanan ödemesi, siparişi ikinci kez çekmez. Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklentide kayıtlı kart veya müşteri profili, WooCommerce Subscriptions veya Pre-Orders, 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

Sipariş durumları

Processing or Completed: kart çekildi (Authorize and capture) veya bir ön provizyon tahsil edildi. WooCommerce durumu İşleniyor olarak ayarlar; yalnızca sanal ve indirilebilir ürünlü siparişlerde Tamamlandı olarak ayarlar. Sipariş notunda tutar, işlem kimliği, onay kodu (auth code), kart tipi ve son dört hane gösterilir. İşlem kimliği, Authorize.Net Trans ID'dir.

On hold: tutar yalnızca bir ön provizyonla ayrılmıştır (Authorize only) veya Fraud Detection Suite işlemi incelemeye almıştır. Beklemedeki işlemi Authorize.Net panelinden onaylayın veya reddedin; webhook'lar varsa sipariş otomatik güncellenir. Webhook ile bildirilen bir tahsilat tutarı sipariş tutarıyla eşleşmezse sipariş de beklemeye alınır.

Cancelled: bir webhook, işlemin sipariş ödenmeden önce reddedildiğini, iptal edildiğini (void) veya süresinin dolduğunu bildirdi. Bu, ödenmiş bir siparişe olursa durumu değiştirilmez ve bir uyarı notu eklenir.

Tahsilat

Ön provizyonlu bir sipariş için siparişi açın, sipariş işlemleri arasından Capture payment (Authorize.Net) seçeneğini seçin ve güncelle düğmesine tıklayın. İadeler düşüldükten sonra kalan tüm sipariş tutarı tahsil edilir ve sipariş ödenmiş olarak işaretlenir. Tahsilat başarısız olursa hata gösterilir ve sipariş notlarına eklenir. Tahsilatı Authorize.Net panelinden de yapabilirsiniz; webhook'lar varsa sipariş otomatik güncellenir.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit Card düğmesine tıklayın (düğme, ödeme yönteminizin başlığını kullanır). Sipariş tutarının tamamının iadesi, işlem henüz uzlaştırılmamışsa veya tahsil edilmemiş bir ön provizyonsa, önce işlemi iptal eder (void). Uzlaştırılmış işlemler, genellikle 24 saat sonra, tam veya kısmi olarak iade edilebilir. Uzlaştırmadan önce kısmi iade yapılamaz: işlemi iptal etmek için tam tutarı iade edin ya da uzlaştırmadan sonra yeniden deneyin. Authorize.Net iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade veya iptal sipariş notlarına eklenir.

Bir siparişin iadeleri, tahsilatları ve webhook kontrolleri, siparişin ödendiği modun kimlik bilgilerini kullanır; bu nedenle Sandbox mode ayarını değiştirdikten sonra diğer moddaki siparişler yine tahsil edilebilir ve iade edilebilir. Bu siparişler tamamlanana kadar o modun kimlik bilgilerini alanlarında tutun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Authorize.Net sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz; bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Authorize.Net, ödeme sayfasında müşterilere gösterilmez. Ödeme yine de başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Oturum açmış mağaza yöneticileri ödeme yöntemini yine görür; yöntem (unlicensed — visible to admins only) etiketiyle işaretlenir. Böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: webhook'lar yine işlenir, tahsilat ve iadeler çalışır.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Authorize.Net ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun API Login ID, Transaction Key ve Public Client Key değerlerinin girildiğini kontrol edin. Mağaza para biriminin desteklendiğini kontrol edin; desteklenmiyorsa ayarlar sayfası uyarı gösterir.

Ödeme yapıldı, ancak sipariş hâlâ On hold durumunda: işlem türü Authorize only olabilir (siparişteki işlemle tahsil edin) ya da Authorize.Net işlemi incelemeye almış olabilir. Authorize.Net panelinden onaylayın veya reddedin. Bu tür siparişlerin otomatik güncellenmesi için webhook'u kurun: uç nokta URL'sinin ayarlarda gösterilenle tam olarak aynı olduğunu, dört olayın seçili olduğunu ve geçerli modun Signature Key'inin girildiğini kontrol edin.

Webhook answers webhooks are not configured: iki mod için de bir Signature Key girilmemiş.

Webhook answers invalid signature: Signature Key başka bir hesaba veya moda ait. Signature Key'i yeniden oluşturun veya kopyalayıp o modun alanına yapıştırın.

Webhook answers verification failed, retry later: mağaza işlemi Authorize.Net API'sinden okuyamadı. Authorize.Net teslimatı yeniden dener.

Kart formu yüklenmiyor veya 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 değerleri 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 genel bir hata görüyor: sipariş notlarını açın veya Debug log seçeneğini açıp WooCommerce > Status > Logs bölümünde kaynak wcp_authorizenet_gateway kayıtlarına bakın. Hesabın desteklemediği bir para birimi Authorize.Net tarafından reddedilir.

Uzlaştırılmamış işlem nedeniyle kısmi iade başarısız oluyor: işlemi iptal etmek için tam sipariş tutarını iade edin ya da genellikle 24 saat içinde uzlaştırmadan sonra yeniden deneyin.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir alan adı hakkını serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, siparişlerde saklanan Authorize.Net verileri ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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.