VibeFox CCAvenue for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 6.0 veya üzeri, kurulu ve etkin olmalı. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri, OpenSSL eklentisiyle birlikte (isteği şifrelemek ve yanıtı çözmek için kullanılır).

CCAvenue hesabı: Merchant ID, Access Code ve Working Key bilgilerine sahip bir CCAvenue satıcı hesabına ihtiyacınız var. 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şimi hesabınız için CCAvenue tarafından etkinleştirilmelidir. Eklenti CCAvenue Hindistan uç noktalarını kullanır.

Para birimi: sipariş 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şlemesi gerekir.

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_ccavenue_payment 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 > CCAvenue > 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. CCAvenue panelinizdeki Merchant ID, Access Code ve Working Key bilgilerini girin ve Enable/Disable seçeneğini açın.

6. Test ederken Test mode seçeneğini açık tutun; gerçek ödemeleri kabul etmek için kapatın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > CCAvenue. Alanların üstünde sayfa, CCAvenue etkinken Merchant ID, Access Code veya Working Key eksikse uyarır (bu durumda ödeme yöntemi, üçü de girilene kadar ö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. ifadesini gösterir ve mağaza para birimi INR değilse çoklu para birimi işlemesi konusunda hatırlatma yapar.

Genel

Enable/Disable: Enable CCAvenue Payment Gateway ö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: 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. Access Code ve Working Key'i bu mağazanın alan adı için üretin. Kaydederken kimlik bilgilerindeki boşluklar kaldırılır.

Merchant ID: sayısal CCAvenue Merchant ID'niz. Rakamlardan başka bir şey içeriyorsa kaydederken hata gösterilir ve daha önce kaydedilen değer korunur.

Access Code: bu web sitesi için Access Code.

Working Key: bu web sitesi için Working Key (şifreleme anahtarı). Ödeme isteğini şifreler ve CCAvenue yanıtını doğrulamanın tek yoludur; bu nedenle gizli tutun.

Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com). CCAvenue, test ve canlı için aynı Merchant ID, Access Code ve Working Key'i kullanır; test erişimi hesabınız için CCAvenue tarafından etkinleştirilmelidir. Test modunda ödeme sayfasında TEST MODE: no real transactions will be processed. ifadesi gösterilir. Varsayılan: açık. Gerçek ödemeler için kapatın.

Dönüş URL'si

CCAvenue, müşteriyi bu bölümde gösterilen adrese geri yönlendirir. Adres şuna benzer: https://your-site/wc-api/ccavenue_p_callback/. Eklenti bu URL'yi her ödemede gönderir; CCAvenue tarafında bir ayar yapmanız gerekmez. CCAvenue'ya kayıtlı alan adına ait olmalıdır.

Gelişmiş

Debug log: Log CCAvenue events seçeneği, sipariş kimliklerini, CCAvenue referanslarını ve durumları WooCommerce > Status > Logs bölümüne, kaynak wcp_ccavenue_payment olarak yazar. Anahtarlar, kart verileri ve adresler günlüğe yazılmaz. Varsayılan: kapalı.

Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak CCAvenue) ve siparişi verir. Pay for order sayfası 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 Cancel order düğmesine tıklar. Her denemede yeni bir CCAvenue sipariş referansı oluşturulur. Sipariş toplamı ve para birimi, fatura ve teslimat bilgileri ile sipariş anahtarı şifreli istekte gönderilir. Ad ve adresler, CCAvenue'nun kabul ettiği karakterlere ve uzunluklara uygun hâle getirilir; ülke ve il isim olarak, telefon ise yalnızca rakamlar olarak gönderilir.

Ö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 anahtarınızla çözülebilmeli, bu siparişe ait olmalı ve siparişle aynı tutar ile para birimini taşımalıdır. Ardından müşteri sipariş alındı sayfasına gelir.

Ödeme başarısız olursa müşteri, Payment was not completed. Please try again or choose a different payment method. mesajıyla ödeme sayfasına 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. Müşteri ödenmemiş bir siparişi yeniden ödeyebilir; örneğin Pay for order sayfasından. Ödeme Pay for order sayfasından başlatıldıysa ve sepet boşsa, WooCommerce mesajı sepet sayfasında gösterir; başarısız bir sipariş My account > Orders bölümünden yeniden ödenebilir.

Ö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. Müşteriye gösterilen metinler Hintçeye çevrilmiştir.

Sonuç yalnızca müşterinin CCAvenue'dan dönüşünden alınır: sunucudan sunucuya bildirim ve durum sorgusu yoktur. Müşteri dönmeden tarayıcıyı kapatırsa sipariş Pending payment durumunda kalır. Eklentide WooCommerce'ten iade, kayıtlı kart, abonelik veya yinelenen ödeme yoktur, iframe veya sitede kart formu yoktur ve CCAvenue UAE veya diğer bölgesel platformlar desteklenmez.

Siparişler

Sipariş durumları

Pending payment: müşteri CCAvenue'ya yönlendirildi ve henüz geri dönmedi. Müşteri geri dönmezse ödemeyi CCAvenue panelinde kontrol edin.

Processing: ödeme onaylandı (yalnızca sanal ve indirilebilir ürünlerden oluşan siparişler, WooCommerce varsayılanı olarak Completed olur). Sipariş notunda banka referansı, CCAvenue izleme kimliği ve ödeme modu gösterilir. Siparişin işlem kimliği CCAvenue izleme kimliğidir.

On hold, amount/currency mismatch: CCAvenue, tutarı veya para birimi siparişten farklı olan bir ödemeyi onayladı; örneğin müşteri ödemeye başladıktan sonra sipariş düzenlendi ya da bir CCAvenue indirim teklifi uygulandı. Not, alınan ve beklenen tutarı gösterir. Ödemeyi CCAvenue panelinde kontrol edin, ardından siparişi tamamlayın veya iade edin.

On hold, awaiting bank confirmation: CCAvenue ödemeyi Awaited olarak bildirdi. Tahsilat hâlâ yapılmış olabileceğinden sipariş asla başarısız olarak işaretlenmez. Siparişi tamamlamadan önce CCAvenue panelinde doğrulayın ve durumu manuel olarak değiştirin. Aynı izleme kimliğiyle gelen sonraki bir yanıt yine de uygulanır.

On hold, payment for a cancelled order: müşteri, sipariş iptal edildikten sonra ödeme yaptı. Stoku kontrol edin ve siparişi tamamlayın veya iade edin.

Cancelled: müşteri CCAvenue sayfasında ödemeyi iptal etti.

Failed: ödeme başarısız oldu veya CCAvenue, Invalid, Timeout ya da başka bir başarısız durum döndürdü. Not, CCAvenue mesajını gösterir. Geç gelen bir başarısızlık ödenmiş bir siparişi hiçbir zaman değiştirmez.

Zaten ödenmiş bir siparişe başka bir başarılı ödeme gelirse (örneğin iki tarayıcı sekmesinden), sipariş yeniden değiştirilmez. Bir not, mükerrer ödemeyi CCAvenue panelinden iade etmenizi ister.

İadeler: WooCommerce'ten iadeler desteklenmez. Ödemeyi CCAvenue panelinde iade edin ve WooCommerce'te manuel olarak kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü, WooCommerce > Settings > Payments > CCAvenue 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 CCAvenue ö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: zaten başlatılmış ödemelerden dönen müşteriler yine işlenir.

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

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ı eksik olan bir alan olduğunda uyarı gösterir.

Ödeme yapıldı, ancak sipariş hâlâ Pending payment durumunda: müşteri, örneğin tarayıcıyı kapattığı için CCAvenue'dan mağazanıza dönmedi. Eklentinin sunucudan sunucuya bildirimi yoktur. Ödemeyi CCAvenue panelinde kontrol edin ve siparişi manuel olarak 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 karakterle kopyalanmış. Anahtarları bu mağazanın alan adı için yeniden üretin ve tekrar yapıştırın. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünde, kaynak wcp_ccavenue_payment kayıtları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, dönüş URL'sinin 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şlemesi etkin olmalıdır.

Müşteri, This payment method is temporarily unavailable görüyor: kimlik bilgilerinden biri eksik.

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

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı, ödeme banka onayını bekliyor ya da sipariş iptal edilmişti. Ödemeyi CCAvenue panelinde doğrulayın, ardından siparişi tamamlayın veya ödemeyi iade edin.

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.

Geliştiriciler için: readme dosyası, ccavenue_p_request_params filtresini listeler (CCAvenue'ya gönderilen verileri değiştirir, örneğin merchant_param2 ile merchant_param5 veya promo_code; amount, currency, order_id ya da merchant_param1 değerlerini değiştirmeyin) ve ödeme sayfası simgesi için ccavenue_p_icon filtresini listeler.

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ı, günlükler ve siparişlerde saklanan CCAvenue referansları 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.

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