VibeFox CCAvenue for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri, OpenSSL eklentisi ile (isteği şifrelemek ve yanıtı çözmek için kullanılır). Modül, eski PHP sürümlerinde veya OpenSSL olmadan kurulmayı reddeder.

CCAvenue hesabı: Merchant ID, Access Code ve Working Key içeren bir CCAvenue satıcı hesabına ihtiyacınız vardır. Access Code ve Working Key bir web sitesi alan adı için verilir; bu nedenle bunları bu mağazanın alan adı için üretin. CCAvenue test ortamında da aynı kimlik bilgilerini kullanır; test erişiminin hesabınız için CCAvenue tarafından etkinleştirilmesi gerekir. Modül CCAvenue Hindistan uç noktalarını kullanır.

Para birimi: sepetin para birimi CCAvenue'ya olduğu gibi gönderilir. CCAvenue hesapları varsayılan olarak INR kabul eder; diğer para birimleri için CCAvenue hesabınızda çoklu para birimi işlemi gerekir.

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

Kurulum

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

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox CCAvenue Payment modülünü bulup Configure düğmesine 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. CCAvenue panelinizdeki Merchant ID, Access Code ve Working Key değerlerini girin ve Enable/Disable seçeneğini etkinleştirin.

5. Test yaparken Test mode seçeneğini açık tutun, gerçek ödemeleri kabul etmek için sonra kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting CCAvenue payment ve CCAvenue payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeleri ve müşteri gruplarında etkinleştirir. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox CCAvenue Payment > 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, CCAvenue etkinken Merchant ID, Access Code veya Working Key eksikse sizi uyarır (bu durumda üçü de girilene kadar ödeme yöntemi ödeme sayfasında gizlenir), test modu açıkken CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. mesajını gösterir ve mağazanın varsayılan para birimi INR değilse çoklu para birimi işlemini hatırlatır.

CCAvenue

Enable/Disable: Enable CCAvenue Payment Gateway ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kayıtlı ödeme yöntemi adı da budur. Varsayılan: CCAvenue.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

API kimlik bilgileri

CCAvenue satıcı panelinize (M.A.R.S.) giriş yapın ve Settings > API Keys bölümünü açın. Bu mağazanın alan adı için Access Code ve Working Key üretin. Kimlik bilgilerindeki boşluklar kaydedilirken silinir.

Merchant ID: sayısal CCAvenue Merchant ID'niz. Rakamlardan başka bir şey içeriyorsa kaydederken CCAvenue: the Merchant ID must contain digits only — the previous value was kept. mesajı görünür, daha önce kaydedilmiş değer korunur ve diğer ayarlar kaydedilir.

Access Code: bu web sitesinin Access Code'u (Settings > API Keys).

Working Key: bu web sitesinin Working Key'i (şifreleme anahtarı). Ödeme isteğini şifreler ve CCAvenue yanıtını doğrulamanın tek yoludur; bu nedenle gizli tutun. Kayıtlı bir Working Key bir daha asla 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 Working Key: kutuyu işaretleyip Save düğmesine tıklayarak kayıtlı Working Key'i kaldırın. Boş alan kayıtlı değeri korur.

Test mode: müşterileri CCAvenue test ortamına (test.ccavenue.com) yönlendirir. CCAvenue test ve canlı için aynı Merchant ID, Access Code ve Working Key'i kullanır; test erişiminin hesabınız için CCAvenue tarafından etkinleştirilmesi gerekir. Test modunda ödeme sayfası, ödeme yönteminin altında TEST MODE: no real transactions will be processed. mesajını gösterir. Varsayılan: açık. Gerçek ödemeler için kapatın.

Return URL

CCAvenue, müşteriyi bu bölümde gösterilen adrese geri gönderir. Dostu URL'lerle şu biçimde görünür: https://your-shop/module/wcp_ccavenue_payment/return; isteğe bağlı olarak /en/ gibi bir dil kodu da içerebilir. Modül bu URL'yi her ödemeyle birlikte gönderir (yönlendirme ve iptal URL'si olarak); bu nedenle CCAvenue'da yapılandırılacak bir şey yoktur. CCAvenue'ya kayıtlı alan adına ait olmalıdır.

Gelişmiş

Debug log: CCAvenue olaylarını modül klasöründeki logs/ccavenue_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Yalnızca sipariş referansları, takip kimlikleri ve durumlar günlüğe yazılır; anahtarlar, kart verileri, e-postalar ve adresler yazılmaz. Varsayılan: kapalı. Kapalıyken hatalar dahil hiçbir şey yazılmaz.

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

Delete data on uninstall: açıkken modülü kaldırmak modül ayarlarını, günlüğü ve CCAvenue sipariş referanslarını siler. Siparişler ve modülün sipariş durumları kalır. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak CCAvenue) ve onaylar. Bir sayfa Thank you for your order. You are being redirected to CCAvenue to complete the payment. mesajını gösterir ve müşteriyi CCAvenue ödeme sayfasına gönderir. JavaScript olmadan müşteri Pay via CCAvenue veya Back to checkout düğmesine tıklar. Bu noktada henüz bir sipariş yoktur.

Her deneme, sepet numarası ve saatten oluşan yeni bir CCAvenue sipariş referansı alır. Sepetin toplamı ve para birimi, fatura bilgileri, teslimat adresi (fatura adresinden farklıysa) ve denemenin gizli belirteci şifreli istekte gönderilir. Adlar ve adresler CCAvenue'nun kabul ettiği karakterlere ve uzunluklara göre temizlenir; ülke ve eyalet ad olarak, telefon ise yalnızca rakam olarak gönderilir. Müşteri kartı, Net Banking, UPI, cüzdanı veya EMI'yi CCAvenue sayfasında seçer.

Ödemeden sonra CCAvenue müşteriyi şifreli bir yanıtla geri gönderir. Sipariş, yalnızca CCAvenue onayladıktan sonra ödenmiş olarak işaretlenir: yanıt Working Key'iniz ile çözülebilmeli, bu mağazanın bir denemesine ait olmalı ve gönderilen ile sepet toplamıyla aynı tutara ve para birimine sahip olmalıdır. Ardından sipariş oluşturulur ve müşteri Your CCAvenue payment has been received. mesajıyla standart sipariş onay sayfasını görür. Awaited bir ödeme için sayfa Your CCAvenue payment is awaiting confirmation from your bank. The order will be processed as soon as the payment is confirmed. mesajını gösterir. Tutar veya para birimi uyuşmazlığından sonra Your payment was received and is being reviewed by the shop. mesajını gösterir. Bekleyen bir sipariş daha sonra ödeme olmadan iptal edilir veya başarısız olursa onay sayfası Your CCAvenue payment was not completed. Please contact us about this order. mesajını gösterir.

Ödeme başarısız olursa müşteri ödeme sayfasına Payment was not completed. Please try again or choose a different payment method. mesajıyla döner. Müşteri CCAvenue sayfasında iptal ederse mesaj Payment was cancelled. You may try again. olur. Yanıt doğrulanamazsa mesaj We could not confirm the payment result. If your account was charged, please contact us before paying again. olur. Bu durumlarda sipariş oluşturulmaz ve sepet korunur, böylece müşteri yeniden ödeme yapabilir. Sepetin zaten bir siparişi varsa yeni bir deneme, ikinci bir ödeme yerine doğrudan o siparişin onay sayfasına gider.

Sonuç yalnızca müşterinin CCAvenue'dan dönüşünden alınır: sunucudan sunucuya bildirim veya durum sorgusu yoktur. Müşteri geri dönmeden tarayıcıyı kapatırsa sipariş oluşturulmaz; ödemeyi CCAvenue panelinden kontrol edin. Modülde PrestaShop'tan iade, kayıtlı kart, abonelik veya yinelenen ödeme, sitede kart formu yoktur ve CCAvenue UAE veya diğer bölgesel platformlar desteklenmez.

Siparişler

Sipariş durumları

No order yet: müşteri CCAvenue'ya gönderildi ve geri dönmedi, ya da ödeme başarısız oldu veya iptal edildi. Yalnızca sepet vardır. Müşteri geri dönmezse ödemeyi CCAvenue panelinden kontrol edin.

Payment accepted: ödeme onaylandı. Ödeme, işlem kimliği olarak CCAvenue takip kimliğiyle kaydedilir ve bir notta banka referansı, takip kimliği ve ödeme modu gösterilir.

Awaiting CCAvenue payment: CCAvenue ödemeyi Awaited (banka henüz onaylamadı) olarak bildirdi. Tahsilat hâlâ yapılmış olabileceğinden sipariş asla başarısız olarak işaretlenmez. Siparişi yerine getirmeden önce CCAvenue panelinde doğrulayın. Aynı takip kimliğiyle sonra gelen bir yanıt yine de uygulanır: Success Payment accepted yapar, Failure Payment error yapar ve Aborted Canceled yapar.

CCAvenue payment on hold: CCAvenue, tutarı veya para birimi sepetten ya da gönderilenlerden farklı olan bir ödemeyi onayladı (örneğin ödeme başladıktan sonra sepet başka bir sekmede değiştirildi) veya müşteri sipariş iptal edildikten sonra ödeme yaptı. Notta alınan ve beklenen tutar gösterilir. Para birimi eşleşirse CCAvenue'nun bildirdiği tutar siparişte ödeme olarak kaydedilir. CCAvenue panelinden ödemeyi kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

Geç gelen bir başarısızlık, ödenmiş bir siparişi asla değiştirmez. Zaten ödenmiş bir sipariş için başka bir başarılı ödeme gelirse (örneğin iki tarayıcı sekmesinden), sipariş değiştirilmez. Bir not, mükerrer ödemeyi CCAvenue panelinden iade etmenizi ister.

CCAvenue ödeme bloğu

Sipariş sayfasında CCAvenue sipariş kimliği, takip kimliği, durum, banka referansı, ödeme modu ve kart adı, gönderilen ve alınan tutar, tarih ve CCAvenue mesajı ile test ödemeleri için bir Test mode rozeti içeren bir CCAvenue payment bloğu gösterilir. CCAvenue notları siparişin özel mesajlarıdır ve yalnızca yönetim panelinde görünür.

İadeler

PrestaShop'tan iadeler desteklenmez. Ödemeyi CCAvenue panelinden iade edin, ardından iadeyi PrestaShop'a elle kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox CCAvenue Payment lisans bloğu, Modules > Module Manager > VibeFox CCAvenue Payment > Configure 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ı gizlenmiş olarak, durumu (örneğin lisansın geçerli olduğu son 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: presta-payment-ccavenue satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar tek 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ızda serbest bırakın.

Etkin bir anahtar olmadan CCAvenue, ö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 ön yüzü, yönetim paneline giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ö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, müşteri CCAvenue'dan döndüğünde yine onaylanır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

CCAvenue ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve üç kimlik bilgisinin de girildiğini kontrol edin: Merchant ID, Access Code ve Working Key. Ayarlar sayfası, biri eksik olduğunda uyarı gösterir. Payment > Preferences bölümünde modülün sepetin para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme gerçekleşti, ancak sipariş oluşturulmadı: müşteri, örneğin tarayıcıyı kapattığı için CCAvenue'dan mağazanıza dönmedi. Modülde sunucudan sunucuya bildirim yoktur. Ödemeyi CCAvenue panelinde kontrol edin ve siparişi elle oluşturun veya güncelleyin.

Her ödeme We could not confirm the payment result ile sonuçlanıyor: yanıt çözülemiyor. Working Key yanlış, başka bir alan adına ait veya fazla karakterlerle kopyalanmış. Bu mağazanın alan adı için anahtarları yeniden üretin ve yeniden yapıştırın. Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın.

CCAvenue ödeme sayfasından önce bir hata gösteriyor: Access Code ve Working Key'in bu alan adı için üretildiğini, Return URL'nin CCAvenue'ya kayıtlı alan adına ait olduğunu ve test modunda CCAvenue'nun hesabınız için test erişimini etkinleştirdiğini kontrol edin. INR dışındaki bir para birimi için CCAvenue hesabınızda çoklu para birimi işlemi etkin olmalıdır.

Müşteri This payment method is temporarily unavailable mesajını görüyor: kimlik bilgilerinden biri eksik veya sepet toplamı sıfır. Debug log nedeni gösterir.

Müşteri This payment method is not available mesajını görüyor: modül kapalı veya Payment > Preferences bölümünde sepetin para birimi, ülke ya da müşteri grubu için izinli değil.

Müşteri Payment gateway error: encryption failed mesajını görüyor: istek şifrelenemedi. PHP OpenSSL eklentisinin kurulu olduğunu kontrol edin.

Kaydederken Merchant ID değişmiyor: değer rakamlardan başka bir şey içeriyor. Yalnızca Merchant ID'nizin rakamlarını girin.

Sipariş CCAvenue payment on hold veya Awaiting CCAvenue payment durumunda: sipariş notunu okuyun (bkz. Sipariş durumları). Ödemeyi CCAvenue panelinde doğrulayın, ardından siparişi yerine getirin veya ödemeyi iade edin.

Geliştiriciler için modül actionCcavenueRequestParams kancasını sunar (şifrelemeden önce CCAvenue'ya gönderilen verileri değiştirir; örneğin merchant_param2 ila merchant_param5; değerler & içermemelidir; amount, currency, order_id ve merchant_param1 değiştirilmemelidir).

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox CCAvenue Payment 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. Onay ekranı, Delete data on uninstall açık değilse ayarların ve CCAvenue referanslarının korunacağını hatırlatır. Açıksa modül ayarları, günlük ve CCAvenue sipariş referansları silinir. Kapalıysa her şey sonraki bir yeniden kurulum için korunur. Awaiting CCAvenue payment ve CCAvenue payment on hold sipariş durumları her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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