VibeFox Adyen for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Adyen hesabı: kullandığınız her ortam (test ve canlı) için Adyen satıcı hesabınızın adına, bir API anahtarına ve bir HMAC anahtarına ihtiyacınız var; canlı ödemeler için ise canlı URL önekine de gerekir. API anahtarı, Checkout webservice ve Merchant PAL webservice rollerine sahip bir API kimlik bilgisine aittir. HMAC anahtarı Standard webhook için oluşturulur (bkz. Configuration). Test Customer Area adresi ca-test.adyen.com, canlı Customer Area adresi ca-live.adyen.com'dur. Test ve canlı anahtarlar ayrıdır. Ödeme sayfası Adyen tarafından barındırıldığı için bir istemci anahtarı gerekmez.

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_adyen_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_adyen_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önetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_adyen_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişiklikleri yoktur; bu nedenle 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 Adyen 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 yetkisi olmalıdır.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) 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. Satıcı hesabınızı, test API anahtarını ve test HMAC anahtarını girin; ardından canlı API anahtarını, canlı HMAC anahtarını ve canlı URL önekini girin.

5. Adyen Customer Area'da (test ve canlı) ayarlar bölümündeki Webhook kısmında gösterilen URL ile bir Standard webhook ekleyin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini etkinleştirin ve Save düğmesine tıklayın. Test mode açıkken bir ödeme deneyin, ardından kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_adyen_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ş paket çalışmaz.

2. Paket, aynı sayfada 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 eklenti türü olarak Payments seçin. VibeFox Adyen Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 3-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. Webhook).

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 Adyen Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Geçerli modun ayarları eksik olduğu sürece sayfa Adyen is hidden at checkout until the test settings are complete (ya da canlı ayarlar) uyarısını gösterir ve eksik olanları listeler: Merchant account, API anahtarı, HMAC anahtarı ve canlı modda Live URL prefix. Test modu açık olduğunda sayfa Test mode is on: payment links and refunds go to the Adyen test environment, no real money. uyarısını gösterir. Eklentiyi değiştirme yetkisi olmadan sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title 1 ila 128 karakter olmalıdır, Sort Order tam sayı olmalıdır ve Total 0 veya daha büyük bir sayı olmalıdır; ayrıca coğrafi bölge ve sipariş durumları mevcut olmalıdır. Aksi takdirde hiçbir şey kaydedilmez ve sayfa alanı belirtir. Onaltılık olmayan bir HMAC anahtarı veya harf, rakam ve tire dışında karakterler içeren bir canlı URL öneki kaydedilmez: bir uyarı alanı belirtir, önceki değer korunur ve diğer ayarlar kaydedilir.

Adyen

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Bu ad siparişte de kaydedilir. Varsayılan: Adyen. Zorunlu, en fazla 128 karakter.

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: Pay securely via Adyen.

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

Geo Zone: Adyen'i 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: Adyen'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Herhangi bir tutar için Adyen sunmak üzere boş bırakın.

Adyen hesabı

API anahtarları, Adyen Customer Area'da Developers > API credentials altında oluşturulur (bu bölümde test ve canlı Customer Area bağlantıları bulunur). Her iki anahtar setini de doldurun; Test mode anahtarı hangisinin kullanılacağını seçer.

Test mode: Adyen test ortamını kullanır (gerçek para alınmaz). Açıkken ödeme bağlantıları ve iadeler test API anahtarıyla checkout-test.adyen.com adresine gönderilir. Varsayılan: açık. Gerçek ödeme almak için kapatın. Açıkken müşteriler Confirm Order adımında Test mode: no real payment is taken. ifadesini görür.

Merchant account: Adyen satıcı hesabınızın adı (şirket hesabı değil), örneğin MyShopECOM. Genellikle test ve canlı Customer Area'da aynıdır.

Test kimlik bilgileri

Test mode etkinken kullanılır.

Test API key: test Customer Area'dan: Developers > API credentials > kimlik bilginiz > API key.

Test HMAC key: test Customer Area'dan: Developers > Webhooks > Standard webhook'unuz > HMAC key (onaltılık). Zorunlu: geçerli imzası olmayan webhook'lar reddedilir.

Canlı kimlik bilgileri

Test mode kapalıyken kullanılır.

Live API key: canlı Customer Area'dan: Developers > API credentials > kimlik bilginiz > API key.

Live HMAC key: canlı Customer Area'dan: Developers > Webhooks > Standard webhook'unuz > HMAC key (onaltılık).

Live URL prefix: canlı Customer Area'dan: Developers > API URLs, örneğin https://1797a841fbb37ca7-AdyenDemo-checkout-live.adyenpayments.com adresinden 1797a841fbb37ca7-AdyenDemo. Tüm URL'yi yapıştırabilirsiniz; önek kaydedilirken bundan alınır.

Kaydedilmiş API ve HMAC anahtarları 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. 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.

Webhook

Siparişler yalnızca Adyen webhook'larıyla ödenmiş olarak işaretlenir. Customer Area'da (test ve canlı) Developers > Webhooks bölümüne gidin ve bu bölümde Webhook URL altında gösterilen URL ile bir Standard webhook ekleyin. OpenCart 3'te URL şuna benzer: https://your-store/index.php?route=extension/payment/wcp_adyen_gateway/webhook, OpenCart 4'te ise şuna benzer: https://your-store/index.php?route=extension/wcp_adyen_gateway/payment/wcp_adyen_gateway.webhook. URL, OpenCart kurulumunuzun mağaza adresinden oluşturulur. Adyen yönlendirmeleri takip etmediği için URL'yi ayarların gösterdiği gibi birebir kopyalayın. JSON yöntemini seçin, Generate HMAC key seçeneğini etkinleştirin ve anahtarı Test HMAC key ya da Live HMAC key alanına kopyalayın.

Her bildirimin ortamı HMAC anahtarını belirler ve bir bildirim yalnızca aynı ortamda ve aynı satıcı hesabıyla oluşturulmuş bir ödeme bağlantısına uygulanır. Test bildirimi asla gerçek bir ödemeyi onaylamaz. Geçerli imzası olmayan webhook'lar HTTP 401 ile reddedilir ve Adyen bunları daha sonra yeniden dener. Webhook olmadan hiçbir sipariş durum almaz.

Eklenti şu olayları işler (bunlar da bu bölümde listelenmiştir):

Diğer olaylar sipariş notlarına eklenir. Durumu olmayan bir sipariş için gelen, AUTHORISATION dışındaki bildirimler yok sayılır. Customer Area'daki test düğmesi gibi bu mağazanın siparişine ait olmayan bildirimler kabul edilir ve yok sayılır. Webhook, OpenCart ödeme eklentisi isteklerine izin verdiği için mağaza bakım modundayken de çalışır. OpenCart 4'te eklenti bunun için bir startup action ekler.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Adyen, ödemeyi imzalı AUTHORISATION webhook'uyla onayladığında ve tutar ile para birimi siparişle eşleştiğinde sipariş bir durum alır. Müşterinin geri dönüşü siparişi asla değiştirmez. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order status after payment: başarılı, imzalı bir AUTHORISATION webhook'unun ayarladığı durum. Varsayılan: İşleniyor.

On hold (review) status: tutar veya para birimi uyuşmazlığı, ödenmiş bir siparişin başarısız tahsilatı ya da sipariş durumu zaten değiştirildikten sonra alınan bir ödeme (örneğin iptal edildikten sonra). Bir not nedenini açıklar. Varsayılan: Ödeme bekleniyor, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Cancelled status: Adyen siparişin ödemesini iptal ettiğinde ayarlanır (CANCELLATION). Varsayılan: İptal edildi.

Refunded status: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Adyen daha sonra bu iadenin başarısız olduğunu bildirirse sipariş bir notla birlikte inceleme durumuna geçer. Varsayılan: İade edildi.

Gelişmiş

Debug log: API çağrılarını ve webhook olaylarını OpenCart günlükler klasöründeki (storage/logs) adyg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında adyg_debug.old.log.php dosyasına taşınır. Anahtar kapalıyken bile hatalar her zaman kaydedilir. Günlükler hiçbir zaman API veya HMAC anahtarlarını ya da alıcıların kişisel verilerini içermez. Varsayılan: kapalı.

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. Adyen ödeme kayıtları (PSP referansları, webhook olayları, iadeler) her zaman korunur; böylece eski siparişler, yeniden kurulumdan sonra da iade edilebilir. Varsayılan: kapalı.

İçe / Dışa aktarma

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

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Adyen). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to Adyen to complete the payment securely. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş toplamı ve sipariş para biriminde bir Adyen ödeme bağlantısı oluşturur ve müşteriyi Adyen ödeme sayfasına yönlendirir. Orada müşteri, Adyen hesabınızda etkin olan herhangi bir yöntemle ödeme yapabilir. Müşterinin e-postası, adı ve fatura ülkesi (ya da mağaza ülkesi) ile mağaza dili Adyen'e iletilir ve ödeme Order # ve sipariş numarası olarak görünür.

Ödemeden sonra müşteri mağazanıza geri döner. Geri dönüş tek başına siparişi ödemez: sipariş, ancak Adyen imzalı AUTHORISATION webhook'uyla onayladığında ve tutar ile para birimi siparişle eşleştiğinde ödenmiş olarak işaretlenir. Sipariş daha sonra OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır. Webhook zaten gelmişse müşteri, Your payment with Adyen has been received. ifadesinin yer aldığı OpenCart sipariş başarı sayfasını görür (incelemedeki bir sipariş için Your payment with Adyen has been received and is being reviewed by the store.). Adyen bundan önce ödemeyi iptal ettiyse sayfa Your Adyen payment was not completed. Please contact us about this order. gösterir. Webhook henüz gelmediyse, ödemeyi tamamlamamış bir müşteri için Payment confirmation sayfası, Your payment is being confirmed by Adyen. Your order will be confirmed as soon as Adyen confirms the payment, and you will receive an e-mail. mesajını ve Check again ile Back to checkout düğmelerini gösterir.

Ödeme reddedilirse sipariş durumsuz kalır ve müşteri aynı bağlantıdan tekrar ödeme yapabilir ya da ödeme sayfasına geri dönebilir. Her yeni deneme (OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur, OpenCart 4 ise ödeme sürecinin siparişini günceller) siparişin ve sepetin önceki ödeme bağlantılarını geçersiz kılar; böylece bunlarla da ödeme yapılamaz. Siparişin zaten bir durumu varsa, müşteri yeni bir ödeme başlatmak yerine başarı sayfasına yönlendirilir.

OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. OpenCart 4'te ödeme adresi isteğe bağlıdır: bu adres olmadan müşterinin adı ödeyen adı olarak, teslimat adresinin ülkesi (ya da mağaza ülkesi) ise ülke olarak iletilir. OpenCart 4, ödeme sürecine tek bir sipariş tutar ve onu günceller: Back to checkout ve yeni bir Confirm Order, aynı sipariş için yeni bir ödeme bağlantısı oluşturur ve öncekini geçersiz kılar. Bu sipariş bu arada ödeme yapılmadan kapatıldıysa (örneğin Adyen ödemeyi iptal ettiyse ya da siz siparişi iptal ettiyseniz), müşteri ödeme sayfasına Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla geri gönderilir ve bir sonraki Confirm Order yeni bir sipariş için ödeme alır. Sipariş ödeme sürecinde zaten farklı bir sepet için ödendiyse müşteri ödeme sayfasına geri gönderilir ve yeni bir sipariş öder. Miktar değişikliği dahil sepetteki her değişiklik, kendi ödemesi gereken yeni bir sepet sayılır.

Ödeme bağlantısı oluşturulamazsa müşteri Confirm Order adımında kalır ve Payment could not be initiated. Please try again or choose another payment method. mesajını görür. Neden günlüğe yazılır. Ayarlar eksikse mesaj Payment gateway is not configured properly. Please contact the store administrator. olur.

Eklentinin abonelik veya yinelenen ödemesi, kayıtlı kartı, mağazanın kendi üzerindeki kart alanları (Drop-in veya Components), OpenCart'ta tahsilat ya da iptal düğmeleri ve webhook'lar için temel kimlik doğrulaması yoktur.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri Adyen'e yönlendirildi ve ödeme yapmadı, ödeme reddedildi ya da Adyen ödemeyi henüz onaylamadı. 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): ödeme onaylandı. Bir not tutarı, PSP referansını ve ödeme yöntemini gösterir.

On hold (review) status (default Pending): Adyen, sipariş toplamından farklı bir tutar ya da para birimi onayladı, bir tahsilat başarısız oldu, tam iade başarısız oldu ya da sipariş durumu zaten değiştirildikten sonra (örneğin iptal edildikten sonra) ödeme geldi. Not bunu açıklar. Ödemeyi Customer Area'da kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin. Uyuşmazlıktan sonra inceleme durumundaki bir sipariş için doğru bir ödeme, siparişi ödenmiş olarak işaretler.

Cancelled status (default Canceled): bu siparişin ödemesi Adyen'de iptal edildi.

Refunded status (default Refunded): ödeme eklenti üzerinden tamamen iade edildi. İade gönderildiğinde ayarlanır; Adyen daha sonra bu iadenin başarısız olduğunu bildirirse sipariş inceleme durumuna geçer.

Zaten ödenmiş bir sipariş için, örneğin eski bir ödeme bağlantısından, ikinci bir başarılı ödeme gelirse sipariş değiştirilmez. Bir not, Customer Area'da mükerrer bir tahsilat olup olmadığını kontrol etmenizi ve gerekirse orada iade etmenizi ister. Sepet için de aynı geçerlidir: sepetin siparişlerinden biri ödendikten sonra, aynı sepetin başka bir siparişi için yeni bir ödeme bağlantısı oluşturulmaz ve böyle bir sipariş için hâlâ gelen bir ödeme ona durum vermez; ödenen sipariş nota alır.

OpenCart 4'te ödeme sürecinin ödenmemiş bir siparişi, müşteri Confirm Order adımına geri döndüğünde OpenCart 4'ün ayarladığı Voided durumunu alabilir. Eklenti böyle bir siparişi durumsuz bir sipariş olarak ele alır ve daha sonraki bir ödeme yine de onu onaylar.

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

VibeFox Adyen Gateway sekmesi

Sales > Orders bölümünde Adyen ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Adyen Gateway sekmesi; test ödemeleri için Test mode etiketiyle birlikte PSP reference değerini, Payment link bağlantısını, Merchant account bilgisini, ödemenin Status durumunu, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Adyen notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Adyen Gateway sekmesinde Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Adyen düğmesine tıklayın. Refund this amount through Adyen? This cannot be undone. sorusunu onaylayın. 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). İadeler, Adyen'in onayladığı tutar ve para biriminde yapılır; bu nedenle bir tutar veya para birimi uyuşmazlığından sonra, sipariş toplamına değil müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortama ve satıcı hesabına gönderilir; bu nedenle o ortamın API anahtarı tanımlı olmalıdır. Bir siparişte aynı anda yalnızca bir iade çalışır. Adyen isteği kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. İadeler, Adyen ödemeyi onayladıktan sonra kullanılabilir.

Adyen iadeleri eş zamansız işler: istek, received durumuyla iade geçmişine ve notlara eklenir, nihai sonuç ise REFUND veya REFUND_FAILED webhook'uyla gelir. Başarısız bir iade artık iade edilmiş sayılmaz. Gönderilen iadeler ödenen tutara ulaştığında sipariş, müşteriye bildirilmeden ve ürünler stoğa geri eklenmeden, elle yapılan bir durum değişikliği gibi Refunded status durumuna geçer. Kısmi bir iade durumu değiştirmez. Adyen'de manuel tahsilat kullanılıyorsa yalnızca tahsil edilmiş ödemeler iade edilebilir.

Sales > Returns bölümündeki ürün iadeleri Adyen üzerinden para göndermez. Adyen Customer Area'da yapılan iadeler webhook ile gelir ve notlara eklenir. Sipariş durumu otomatik olarak değişmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Adyen Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Adyen Gateway > Edit sayfasında, ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın 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 Check now düğmesini (durumu yeniden kontrol eder), Change key düğmesini (başka bir anahtar girer) ve Remove key düğmesini (anahtarı bu mağazadan kaldırır) gösterir. Bunların altında Product: opencart-payment-adyen 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 yetkisine sahip 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 belirtir; ö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 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 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ızda serbest bırakın.

Etkin bir anahtar olmadan Adyen, ö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. aynı tarayıcıda yönetim paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir 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 olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim panelinin 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 yine onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinin Dashboard veya Edit sayfası açıldığında durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Adyen ö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 ayarlarının eksiksiz olduğunu kontrol edin: Merchant account, o modun API anahtarı ve HMAC anahtarı; canlı modda ise Live URL prefix. Ayarlar sayfası eksik olanları listeler. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme yapıldı ama sipariş durumsuz kaldı: webhook çalışmıyor. Kullandığınız ortamın (test veya canlı) Customer Area'sında Standard webhook'un var olduğunu, URL'sinin Webhook URL altında gösterilenle birebir aynı olduğunu ve yönteminin JSON olduğunu kontrol edin. Bu webhook'un HMAC anahtarının ilgili alanda olduğunu (Test HMAC key veya Live HMAC key) doğrulayın. Geçersiz veya eksik bir HMAC anahtarında eklenti HTTP 401 yanıtı verir ve Adyen teslimatı daha sonra yeniden dener; böylece anahtar düzeltildiğinde sipariş durumunu otomatik olarak alır. Günlük, HMAC imzasının geçersiz olduğunu ya da HMAC anahtarının yapılandırılmadığını gösterir.

Webhook [rejected] HMAC key not configured yanıtı veriyor: bildirimin ortamına ait HMAC anahtarı boş. Ayarlara yapıştırın.

Webhook [rejected] invalid HMAC signature yanıtı veriyor: HMAC anahtarı başka bir webhook'a veya başka bir ortama ait. Bir toplu işlemdeki bir öğenin imzası yanlışsa tüm toplu işlem reddedilir.

Webhook [rejected] busy, retry later yanıtı veriyor: sipariş aynı anda başka bir teslimat tarafından işleniyordu ya da işlem başarısız oldu. Adyen webhook'u otomatik olarak yeniden dener. Nedeni günlükte bulunur.

Webhook URL'si tarayıcıda [rejected] POST required gösteriyor: bu normaldir. URL yalnızca Adyen'den gelen bildirimleri kabul eder.

Kaydederken HMAC anahtarı uyarısı: alan, Customer Area'daki onaltılık HMAC anahtarını içermelidir. Önceki değer korundu.

Müşteri Payment could not be initiated mesajını görüyor: eklenti sayfasındaki Log alanına bakın (hatalar her zaman kaydedilir). API anahtarını, satıcı hesabını ve canlı modda canlı URL önekini kontrol edin.

Müşteri This payment method is not available. Please reload the checkout page. mesajını görüyor: ödeme oturumu artık siparişle eşleşmiyor veya bu arada ödeme yöntemi kapatıldı. Müşteri ödeme sayfasını yeniden yüklemelidir.

Ödemeden sonra sipariş inceleme durumunda: VibeFox Adyen Gateway sekmesindeki notları okuyun. Adyen'in onayladığı tutar veya para birimi siparişle eşleşmedi, bir tahsilat başarısız oldu veya ödeme, sipariş durumu zaten değiştirildikten sonra geldi.

Sekmede iade formu yok: sekme nedenini belirtir: Adyen ödemeyi henüz onaylamadı, tamamen iade edilmiş, kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok veya ödemenin yapıldığı ortamın kimlik bilgileri yapılandırılmamış.

İade başarısız oluyor: sekme Adyen'den gelen mesajı gösterir. Manuel tahsilat kullanılıyorsa yalnızca tahsil edilmiş ödemeler iade edilebilir. Siparişin başka bir iadesi çalışıyorsa bir süre bekleyip yeniden deneyin.

Geliştiriciler için: ödeme bağlantısı oluşturulmadan önce eklenti, istek verileri ve sipariş ile birlikte OpenCart olayı adyg_payment_link_request'i tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Adyen 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ılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda webhook'un geçmesine izin veren startup action'ı da). Delete data on uninstall açıksa diğer geçit ayarları (başlık, açıklama, test modu, satıcı hesabı, anahtarlar, canlı URL öneki, günlükleme) ve günlük silinir. Kapalıysa, daha sonraki bir yeniden kurulum için saklanırlar. Adyen ödeme kayıtları (PSP referansları, webhook olayları, iadeler) her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da 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 sayfasına gidin, kurulu eklentiler listesinde VibeFox Adyen Gateway yanındaki Uninstall düğmesine (turuncu −) 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.

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