VibeFox Authorize.Net for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

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 değerlerine, webhook kullanıyorsanız bir Signature Key değerine ihtiyacınız vardır. 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 açıktır.

Para birimi: sepet para birimi USD, CAD, CHF, DKK, EUR, GBP, NOK, PLN, SEK, AUD veya NZD olmalıdır ve Authorize.Net hesabınız bu para birimiyle işlem yapabilmelidir. 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

1. Arka ofiste Modules > Module Manager bölümüne gidin ve Upload a module düğmesini tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesini tıklayın; ya da daha sonra modül listesinde VibeFox Authorize.Net Gateway öğesini bulup Configure düğmesini tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Test 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 değerini seçin ve Save düğmesini tıklayın. Test ortamında 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.

Kurulumda modül iki sipariş durumu oluşturur: Authorize.Net payment authorized ve Authorize.Net payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için kullanıma sunar. Bunları Payment > Preferences bölümünden sınırlandırabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Authorize.Net Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa; mağaza için SSL etkin değilse (Accept.js yalnızca HTTPS sayfalarında çalışır), mağazanın varsayılan para birimi Authorize.Net tarafından desteklenmiyorsa, geçerli modda API Login ID, Transaction Key veya Public Client Key yoksa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve geçerli modda Signature Key yoksa (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ı görüntülenir.

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ı. Siparişte de ödeme yöntemi adı olarak kaydedilir. Varsayılan: Credit Card. Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında 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 değerini kopyalayın ve bir Transaction Key ile bir Signature Key oluşturun. Manage Public Client Key altında Public Client Key değerini kopyalayın. Test ve canlı ortam farklı kimlik bilgileri kullanır. Sayfa her iki modun alanlarını gösterir; böylece iki kümeyi 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 kümesini değiştirir. Varsayılan: açık. Gerçek ödeme almak için kapatın. Açık olduğu sürece müşteriler, ödeme yönteminin altında 4111 1111 1111 1111 test kartıyla ilgili bir ipucu görür.

Sandbox API Login ID ve Live API Login ID: test ya da canlı hesabın API Login ID değeri.

Sandbox Transaction Key ve Live Transaction Key: o hesabın Transaction Key değeri.

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 değerleri 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.

Clear saved secrets: bir anahtarı işaretleyin ve kaldırmak için Save düğmesini tıklayın. Boş bir alan, kaydedilmiş değeri korur.

Ödeme

Transaction type: kartın nasıl tahsil edileceğini belirler. Bir ön provizyonun süresi 30 gündür.

Webhook'lar (önerilir)

Webhook'lar olmadan, Fraud Detection Suite tarafından tutulan siparişlerin ya da Authorize.Net panelinde tahsil edilen veya iptal edilen siparişlerin elle güncellenmesi gerekir. Merchant Interface'te Account > Settings > Business Settings > Webhooks bölümüne gidin ve hem test hem de canlı hesapta Add Endpoint düğmesini tıklayın. Bu bölümde Endpoint URL altında gösterilen URL'yi kullanın. Okunabilir URL'lerle şöyle görünür: https://your-shop/module/wcp_authorizenet_gateway/webhook; başında /en/ gibi bir dil kodu da olabilir. URL'yi ayarların gösterdiği gibi birebir kopyalayın. Şu olayları seçin (bunlar da bu bölümde listelenmiştir):

Her hesabın Signature Key değerini 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 bildirimi hiçbir şeyi değiştirmez. Modül, her bildirim için siparişi değiştirmeden önce Authorize.Net'ten işlemin güncel durumunu ve tutarını da sorgular; bu nedenle tekrarlanan bildirimler hiçbir şeyi değiştirmez.

Gelişmiş

Debug log: API isteklerini ve yanıtlarını modül klasöründeki logs/wc_ang_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. 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 seçenek kapalı olsa bile her zaman günlüğe yazılır.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesini tıklayın.

Delete data on uninstall: açıksa modülü kaldırmak ayarları ve günlüğü siler. Authorize.Net işlemleri, iadeler ve modülün sipariş durumları her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da tahsil edilebilir ve iade edilebilir. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card) ve kart numarasını, son kullanma tarihini (MM/YY) ve kart güvenlik kodunu (CVV) altındaki forma girer. Accept.js yalnızca ödeme sayfasında yüklenir. Müşteri siparişi verdiğinde Accept.js, kart verilerini tarayıcıda tek kullanımlık bir jetonla değiştirir. Kart alanlarının form adları yoktur; bu nedenle kart numarası ve CVV hiçbir zaman sunucunuza gönderilmez.

Modül, jetonu Authorize.Net API'si üzerinden sepet tutarı için sepet para biriminde 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. Ödemeden önce henüz bir sipariş bulunmadığından sepet numarası fatura numarası olarak gönderilir. Sipariş, yalnızca Authorize.Net ödemeyi onayladığında ödenmiş olarak işaretlenir: işlem onaylanırsa sipariş hemen oluşturulur ve müşteri Your card payment has been received. mesajını içeren standart sipariş onay sayfasını görür. Authorize only seçiliyse 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 sayfa Your payment is being reviewed. We will update your order as soon as the review is complete. mesajını gösterir.

Kart reddedilirse müşteri ödeme adımında kalır ve Payment failed: ile birlikte nedeni görür; örneğin kartın reddedilmesi, yanlış kart güvenlik kodu veya süresi dolmuş kart. Sipariş oluşturulmaz ve sepet korunur. Yapılandırma ve API hataları müşterilere gösterilmez: genel bir mesaj görürler, ayrıntılar ise 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. Kart alanları boşsa form Please enter the card number, expiry date and card code. ister.

Çift tıklama, ikinci sekme veya tekrarlanan gönderim, bir sepeti asla iki kez tahsil etmez. İ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ş oluşturulamamış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 ya da webhook aracılığıyla, onaylanmış ödemeden, kartı yeniden tahsil etmeden oluşturulur.

Ödeme sürerken sepet değişirse tahsil edilen tutar artık sepetle eşleşmez. Bu durumda sipariş bir notla birlikte Authorize.Net payment on hold durumuna geçer ve ödeme, gerçekte tahsil edilen tutar üzerinden kaydedilir.

Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modülde kayıtlı kart veya müşteri profili, abonelik veya düzenli ödeme, eCheck/ACH, Apple Pay, Google Pay, PayPal veya 3-D Secure, bir ön provizyonun kısmi tahsilatı ve otomatik para birimi dönüşümü bulunmaz.

Siparişler ve iadeler

Sipariş durumları

No order: kart reddedildi veya ödeme başarısız oldu. Yalnızca sepet vardır.

Payment accepted: kart tahsil edildi (Authorize and capture) ya da bir ön provizyon tahsil edildi. Ödeme, işlem kimliği olarak Authorize.Net Trans ID ile kaydedilir; bir notta tutar, Trans ID, onay kodu, kart türü ve son dört hane gösterilir.

Authorize.Net payment authorized: tutar yalnızca ayrılmıştır (Authorize only). Siparişi hazırlamadan önce tahsil edin.

Authorize.Net payment on hold: Fraud Detection Suite işlemi inceleme için tuttu, tahsil edilen tutar sipariş toplamıyla eşleşmiyor ya da webhook ile bildirilen bir tahsilat sipariş tutarıyla eşleşmiyor. Not durumu açıklar. Tutulan bir işlemi Authorize.Net panelinde onaylayın ya da reddedin; webhook'lar açıksa sipariş otomatik olarak güncellenir.

Canceled: bir webhook, sipariş ödenmeden önce işlemin reddedildiğini, iptal edildiğini 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 siparişin durumu değişmez ve bir uyarı notu eklenir.

Refunded: ödeme modül üzerinden tamamen iade edildi veya iptal edildi.

Zaten siparişi olan bir sepet için ikinci bir işlem onaylanırsa sipariş değişmez. Bir not, bu mükerrer işlemi kontrol etmenizi ve Authorize.Net panelinde iptal etmenizi ya da iade etmenizi ister.

Authorize.Net ödeme bloğu

Sipariş sayfasında Trans ID, işlem türü, işlem durumu, kart ve onay kodu, tahsil edilen tutar, sipariş toplamı ve iade edilen tutar; test ödemeleri için bir Sandbox rozeti, iade geçmişi ve siparişin Authorize.Net notes kayıtlarını içeren bir Authorize.Net payment bloğu görüntülenir. Tahsilat ve iadeler için Modules sayfalarına erişim değil, yalnızca sipariş düzenleme yetkisi gerekir.

Tahsilat

Authorize.Net payment authorized durumundaki bir sipariş için bloktaki Capture payment düğmesini tıklayın ve Capture the authorized amount through Authorize.Net? sorusunu onaylayın. Ön provizyon tutarı tahsil edilir, ödeme Trans ID ile kaydedilir ve sipariş Payment accepted durumuna geçer. Tahsilat başarısız olursa hata gösterilir ve notlara eklenir. Authorize.Net panelinde de tahsilat yapabilirsiniz; webhook'lar açıksa sipariş otomatik olarak güncellenir.

İadeler

Bloğa tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden yazın, Refund via Authorize.Net düğmesini tıklayın ve Refund this amount through Authorize.Net? This cannot be undone. sorusunu onaylayın. Tam tutar iadesi, işlem henüz uzlaştırılmamışsa önce işlemi iptal eder; tahsil edilmemiş bir ön provizyonsa onu iptal eder. Uzlaştırılmış işlemler, genellikle 24 saat sonra, tam veya kısmi olarak iade edilebilir. Uzlaştırmadan önce kısmi iade mümkün değildir: işlemi iptal etmek için tam tutarı iade edin ya da uzlaştırmadan sonra yeniden deneyin. İadeler, Authorize.Net'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. Authorize.Net iadeyi kabul etmezse blok hatayı gösterir ve iade kaydedilmez. Başarılı bir iade veya iptal, iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir (yalnızca bir ön provizyon iptal edildiyse Canceled). Kısmi iade durumu değiştirmez. Bir işlem inceleme için tutulduğu sürece iade önerilmez.

Bir siparişin tahsilat, iade 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 hâlâ tahsil edilebilir ve iade edilebilir. Bu siparişler tamamlanana kadar o modun kimlik bilgilerini ilgili alanlarda tutun.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki PrestaShop'un standart iade düğmeleri, Authorize.Net üzerinden para geri göndermez. Authorize.Net panelinde yapılan iadeler mağazaya bildirilmez: siparişi elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox Authorize.Net Gateway, Modules > Module Manager > VibeFox Authorize.Net Gateway > Configure sayfasının ilk bloğudur ve ayarların üstünde yer alır. 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 son tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-authorizenet satırı ile Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip personel değiştirebilir. Bloğun metinleri arka ofis 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 tarihli License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvası serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir lisans anahtarı olmadan Authorize.Net kartla ödeme yöntemi ö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. Mağaza arka ofise giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ama ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır, tahsilat ve iadeler çalışır.

Lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Durum, arka ofiste çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu kaldırır.

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 modda API Login ID, Transaction Key ve Public Client Key bulunduğunu kontrol edin. Ayarlar sayfası, eksik olan bir değer varsa uyarı gösterir. Sepet para biriminin desteklendiğini ve Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme gerçekleşti ama sipariş Authorize.Net payment on hold veya authorized durumunda kalıyor: işlem türü Authorize only (siparişin bloğundan tahsil edin) olabilir ya da Authorize.Net işlemi inceleme için tutmuş olabilir. Authorize.Net panelinde onaylayın ya da reddedin. Bu siparişlerin otomatik güncellenmesi için webhook'u ayarlayın: uç noktanın kullandığınız modun hesabında var olduğunu, URL'sinin Endpoint URL altında gösterilenle birebir aynı olduğunu, dört olayın seçili olduğunu ve o hesabın Signature Key değerinin girildiğini kontrol edin.

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

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

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

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

Webhook answers busy, retry later: sipariş aynı anda başka bir istek tarafından güncelleniyordu ya da sipariş oluşturulamadı. 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 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 girmeli ve tekrar denemelidir.

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

İşlem henüz uzlaştırılmadığı için kısmi iade başarısız oluyor: işlemi iptal etmek için tam tutarı iade edin ya da genellikle 24 saat içinde uzlaştırmadan sonra yeniden deneyin.

İade veya tahsilat, mod hakkında bir mesajla başarısız oluyor: ödeme canlı ya da test modunda yapılmış ve o modun API Login ID ile Transaction Key değerleri girilmemiş. Bunları girin ve yeniden deneyin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Authorize.Net Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa ayarlar ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Authorize.Net işlemleri ve iadeleri ile Authorize.Net payment authorized ve Authorize.Net payment on hold sipariş durumları her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da tahsil edilebilir ve iade edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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