VibeFox Cashfree for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

HTTPS: Cashfree webhook'ları yalnızca https:// adreslerine gönderir. HTTPS olmadan ödemeler, müşteri mağazaya döndüğünde yine de onaylanır, ancak canlıya almadan önce HTTPS'yi etkinleştirin.

Cashfree hesabı: Cashfree hesabınızın App ID ve Secret Key bilgilerine ihtiyacınız vardır; bunlar test (sandbox) ve canlı ortam için ayrı ayrıdır. Ayrıca Cashfree Merchant Dashboard'da bir webhook gerekir (bkz. Yapılandırma). Secret Key webhook'ları doğrulamak için de kullanıldığından ayrı bir webhook sırrı yoktur. Sipariş para biriminin Cashfree hesabınızda etkin olması gerekir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_cashfree_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_cashfree_payment.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önetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesini tıklayın ve wcp_cashfree_payment-oc3-(version).ocmod.zip dosyasını seçin. Uzantının OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine bu paketteki 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 Payments türünü seçin. VibeFox Cashfree Payments öğesini bulun ve Install düğmesini (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme uzantıları listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesini (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğunda License key alanına yapıştırın ve Activate düğmesini tıklayın (bkz. Lisans anahtarı).

4. Sandbox App ID ve Sandbox Secret Key bilgilerini girin, Cashfree Merchant Dashboard'a webhook ekleyin (bkz. Yapılandırma), Enable/Disable seçeneğini açın, Save düğmesini tıklayın ve bir ödeme deneyin.

5. Hazır olduğunuzda canlı App ID ve Secret Key bilgilerini girin, Sandbox Mode seçeneğini kapatın ve Save düğmesini tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesini tıklayın ve wcp_cashfree_payment.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfada kurulu uzantılar listesinde görünür. Yanındaki Install düğmesini (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve Payments türünü seçin. VibeFox Cashfree Payments öğesini bulun, Install düğmesini (yeşil + düğmesi) ve ardından Edit düğmesini (kalem düğmesi) tıklayın.

4. Lisans anahtarını, Cashfree anahtarlarını ve webhook'u OpenCart 3 için 3-5. 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 sandbox modu açık olarak başlar.

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Payments > VibeFox Cashfree Payments > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa, Cashfree ödemeyi onaylayana kadar siparişin bir durum almadığını açıklar. Ödeme yöntemi etkinleştirildiğinde, seçili modun API anahtarları eksikse sayfa uyarır (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve sandbox modu açıkken Sandbox mode is on: customers see a test checkout and no real money is charged. mesajını gösterir. Uzantıyı değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş olamaz (en fazla 128 karakter), API Version listelenen sürümlerden biri olmalı, Sort Order tam sayı olmalı, Total 0 veya daha büyük bir sayı olmalı ve coğrafi bölge ile sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Seçili modun anahtarları olmadan etkin bir ödeme yöntemi kaydettiğinizde, ayarlar bu anahtarlar girilene kadar ödeme sayfasında gizli kalacağı uyarısıyla kaydedilir.

Cashfree Payments

Enable/Disable: Enable Cashfree Payments ö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 kaydedilen ödeme yöntemi adı da budur. Varsayılan: Cashfree Payments. Zorunlu.

Description: müşterinin Confirm Order adımında, onay düğmesinin üstünde gördüğü metin. Varsayılan: Pay securely via Card, UPI, Net Banking, Wallet via Cashfree.

Sort Order: ödeme sayfasındaki ödeme yöntemleri arasında Cashfree'nin sırası. Boş bırakın veya bir tam sayı girin.

Geo Zone: Cashfree'yi yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Cashfree'nin sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası tutarı. Cashfree'yi her tutar için sunmak üzere boş bırakın. Para biriminin Cashfree asgari tutarının altındaki tutarlar (1 birim; üç ondalıklı para birimleri için 0,01 veya 0,1) hiçbir zaman sunulmaz.

Mod ve API anahtarları

App ID ve Secret Key bilgilerinizi Cashfree Merchant Dashboard'da Developers > API Keys altında bulabilirsiniz (sayfa oraya bağlantılar içerir). Test ve canlı anahtarlar farklıdır.

Sandbox Mode: test için Cashfree sandbox'ını kullanır. Gerçek para tahsil edilmez; Confirm Order adımı ve ödeme sayfası SANDBOX MODE - no real payments will be processed. ifadesini gösterir. Varsayılan: açık. Canlı ödemeler için kapatın.

Sandbox App ID: Cashfree test ortamınızın App ID değeri.

Sandbox Secret Key: Cashfree test ortamınızın Secret Key değeri.

App ID: Cashfree canlı ortamınızın App ID değeri.

Secret Key: Cashfree canlı ortamınızın Secret Key değeri.

Kayıtlı Secret Key'ler bir daha asla gösterilmez. Alan boş kalır ve Kayıtlı — korumak için boş bırakın. 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üğmesini tıklayın.

Ödemeler, oluşturuldukları ortamı korur. Webhook'ları doğrulanır, durumları kontrol edilir ve iadeleri o ortamın anahtarlarıyla gönderilir; bu nedenle canlıya geçtikten sonra sandbox ödemeleri tamamlanana kadar sandbox anahtarlarını dolu tutun.

Webhook

Webhook, mağazanıza bir ödemenin yapıldığını, başarısız olduğunu veya iade edildiğini bildirir. Cashfree Merchant Dashboard'da Developers > Webhooks bölümüne gidin ve bu bölümdeki Webhook URL alanında gösterilen URL'yi Payment ve Refund olaylarıyla birlikte ekleyin. OpenCart 3'te URL https://your-store/index.php?route=extension/payment/wcp_cashfree_payment/webhook biçimindedir, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_cashfree_payment/payment/wcp_cashfree_payment.webhook biçimindedir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği şekilde, birebir kopyalayın. HTTPS kullanan bir mağazada uzantı, bu URL'yi her ödemede Cashfree'ye de iletir. Mağazanız HTTPS kullanmıyorsa bu bölüm bir uyarı gösterir.

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

Cashfree her webhook'u Secret Key'iniz ile imzalar. Geçerli bir imzası olmayan webhook'lar reddedilir. Bir webhook, ödemenin yapıldığı ortamın Secret Key'i ile imzalanmalıdır; bu nedenle sandbox anahtarı hiçbir zaman canlı bir ödemeyi onaylamaz. Bu mağaza tarafından başlatılmamış ödemelere ait imzalı webhook'lar (örneğin aynı Cashfree hesabındaki başka bir mağaza) onaylanır ve yok sayılır. Webhook olmadan bir sipariş, yalnızca müşteri ödemeden sonra mağazaya döndüğünde onaylanır. Müşteri ödemeden sonra tarayıcıyı kapatırsa, siparişi yalnızca webhook (veya aynı sepet için bir sonraki ödeme denemesi) onaylayabilir.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik bir sipariş) olarak oluşturur. Sipariş, yalnızca Cashfree ödemeyi onayladıktan sonra bir durum alır. Başarısız veya terk edilmiş bir ödeme siparişi durumsuz bırakır ve sepet korunur. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: ödeme onaylandıktan ve tutar ile para birimi eşleştikten sonra ayarlanan durum. Varsayılan: İşleniyor.

On Hold (Review) Status: Cashfree, sipariş toplamından farklı bir ödenen tutar veya para birimi bildirdi. Bir not, beklenen ve alınan tutarı gösterir. Varsayılan: Beklemede, çünkü OpenCart'ta Askıda durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Refunded Status: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: İade Edildi.

Gelişmiş

API Version: kullanılacak Cashfree API sürümü.

Order ID prefix: Cashfree sipariş kimlikleri, önek + OpenCart sipariş kimliği olarak oluşturulur; aynı sipariş için yeni bir deneme sonuna bir numara alır (örneğin 123-2). Alan açıklamasında gösterilen bu mağazanın otomatik önekini kullanmak için boş bırakın (OC, mağaza adresinden türetilen dört harf ve bir tire). Aynı Cashfree hesabına bağlı her mağaza için farklı bir önek kullanın. Yalnızca harfler, rakamlar, "_" ve "-", en fazla 20 karakter. Diğer karakterler kaydetme sırasında bir uyarıyla kaldırılır.

Debug log: hatalar her zaman kaydedilir. Açık olduğunda, Cashfree API çağrıları ve webhook'lar ayrıca OpenCart günlükleri klasöründeki (storage/logs) cashfree_p_debug.log.php dosyasına yazılır. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında döndürülür. Anahtarlar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girişlerini gösterir. İçeriğini boşaltmak için Clear log düğmesini tıklayın.

Delete Data on Uninstall: açık olduğunda uzantının kaldırılması Cashfree ayarlarını ve uzantı günlüğünü siler. Siparişler ile bunların Cashfree işlemleri ve iadeleri her zaman korunur. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Secret Key'ler 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üğmesini tıklayın. Kayıtlı Secret Key'ler korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Cashfree Payments). Confirm Order adımında müşteri açıklamanızı ve Kartlar, UPI, internet bankacılığı ve cüzdanlarla güvenli ödeme yapmak için Cashfree ödeme sayfasına yönlendirileceksiniz. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesini tıkladığında uzantı, sipariş para biriminde sipariş tutarı için bir Cashfree siparişi oluşturur ve bir Cashfree payment sayfası açar; bu sayfa Ödeme için Cashfree'ye yönlendiriliyor... ifadesini gösterir ve Cashfree ödeme sayfasını yükler. Kendiliğinden açılmazsa müşteri Pay Now düğmesini tıklayabilir. Cashfree ödeme sayfasında müşteri, Cashfree hesabınızda etkin olan herhangi bir yöntemle, örneğin kartla, UPI, internet bankacılığı veya cüzdanla ödeme yapar. Müşterinin e-posta adresi ve telefon numarası Cashfree'ye iletilir. 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ında Confirm Order düğmesini tıklar. OpenCart 4 varsayılan olarak telefon numarası istemez: siparişte numara yoksa onay bloğunda isteğe bağlı bir Phone alanı gösterilir (İsteğe bağlı: Cashfree (UPI, OTP) için ödeyenin telefon numarası.). Hatalı biçim Lütfen geçerli bir telefon numarası girin (10 haneli veya + ve ülke kodu) ya da alanı boş bırakın. mesajını verir. Numara bir sonraki deneme için hatırlanır.

Ödemeyi yaptıktan sonra müşteri mağazanıza döner. Sipariş, yalnızca Cashfree ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: imzalı webhook ile veya müşteri döndüğünde Cashfree'ye yapılan sunucu tarafı bir istekle. Sipariş daha sonra OpenCart'ın standart yoluyla, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri OpenCart sipariş başarılı sayfasını görür. Dönüş, başka bir tarayıcıda da çalışır; örneğin müşteri bir UPI uygulamasından döndüğünde. Banka ödemeyi henüz onaylamadıysa, bir Payment confirmation sayfası Your payment is being processed by the bank. We will update the order as soon as Cashfree confirms it — please do not pay again. mesajını ve bir Check again düğmesini gösterir; banka ödemeyi onayladığı anda webhook sipariş durumunu ayarlar. OpenCart 4'te tarayıcı, Cashfree müşteriyi geri gönderdiğinde mağazanın oturumunu göndermez; bu nedenle uzantı önce mağazanızdan aynı dönüş adresini yeniden açan kısa bir sayfa gösterir: müşteri sepetini ve oturum açmasını korur.

Ödeme başarısız olursa veya müşteri Cashfree sayfasından ödeme yapmadan ayrılırsa, müşteri Cashfree ödemesi tamamlanamadı. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. mesajıyla ödeme sayfasına döner. OpenCart 4'te ödeme mesajları ödeme sayfasının üstünde gösterilir. Sipariş durumsuz kalır ve sepet korunur. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme için tek bir siparişi tutar ve bunu günceller, bu nedenle müşteri aynı siparişi yeniden öder. Aynı siparişin açık bir Cashfree ödemesi, tutar değişmemişse ve beş dakikadan fazla süre kalmışsa yeniden kullanılır; aksi halde eski Cashfree siparişi kapatılır ve yenisi oluşturulur. Aynı sepetin önceki siparişlerinin açık Cashfree ödemeleri de kapatılır; böylece sepet iki kez ödenemez. Sepet Cashfree'de zaten ödenmiş ama kaydedilmemişse, bir sonraki deneme yeniden tahsilat yapmak yerine bu ödemeyi onaylar. Başka bir siparişle zaten ödenmiş bir sepetten tekrar tahsilat yapılmaz: müşteri başarı sayfasına gider. Aynı sepet yine de iki kez ödenirse (örneğin iki tarayıcı sekmesinde aynı anda), ikinci sipariş durum almaz ve ödenmiş sipariş, müşterinin iki kez tahsil edilmiş olabileceğini belirten bir not alır; böylece Cashfree panelinden iade edebilirsiniz.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Bu sipariş bu arada kapatılmışsa (örneğin iptal edilmişse) ve Cashfree bu sipariş için para tutmuyorsa, müşteri Cashfree ödemesi tamamlanamadı. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order sepetin yeni bir siparişini öder. Siparişin zaten bir durumu varsa ve o zamandan beri sepet değiştiyse (başka ürünler veya miktarlar), müşteri Önceki siparişiniz zaten verildi. Lütfen siparişi yeniden onaylayın: mevcut sepet yeni bir siparişle ödenecektir. mesajıyla ödeme sayfasına döner.

Cashfree ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde Cashfree ödemesi başlatılamadı. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. mesajını görür. Teknik neden günlüğe yazılır. Cashfree asgari tutarının altındaki bir sipariş toplamı (para biriminin 1 birimi; KWD gibi üç ondalıklı para birimleri için 0,01 ve TND için 0,1) Cashfree ile ödenemez ve bu sipariş için ödeme yöntemi gösterilmez.

Webhook, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme uzantısı isteklerine izin verir, OpenCart 4'te ise uzantı webhook'a ve müşterinin dönüşüne izin veren bir başlangıç eylemi ekler.

Uzantı yalnızca Cashfree ödeme sayfasında tek seferlik ödemeleri kabul eder. Kayıtlı kart, abonelik veya yinelenen ödeme, ayrı yetkilendirme ve tahsilat, Cashfree teklif widget'ı, Cashfree üzerinden kapıda ödeme veya ödeme bağlantıları yoktur ve para birimi dönüşümü yapılmaz: sipariş, sipariş para biriminde tahsil edilir.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Cashfree'ye gönderildi ve ödeme yapmadı, ödeme başarısız oldu veya ödeme bankada hâlâ beklemede. Sales > Orders bölümünde bu tür siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan İşleniyor): ödeme onaylandı. Bir not, Cashfree işlem kimliğini ve ödeme yöntemi grubunu (örneğin upi veya credit_card) gösterir.

On Hold (Review) Status (varsayılan Beklemede): Cashfree, sipariş toplamından farklı bir ödenen tutar veya para birimi bildirdi. Not, beklenen ve alınan tutarı ve işlem kimliğini gösterir. Ödemeyi Cashfree panelinde kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Refunded Status (varsayılan İade Edildi): ödeme uzantı üzerinden tamamen iade edildi.

Bekleyen bir siparişe siz elle bir durum verdikten sonra (örneğin İptal Edildi) gelen bir ödeme yine de kaydedilir ve sipariş ödenmiş hâle gelir, çünkü para tahsil edilmiştir; OpenCart müşteriye bu değişikliği bildirir. Ödenmiş bir sipariş, sonradan gelen başarısız bir ödemeyle asla geri alınmaz ve zaten ödenmiş bir sipariş için gelen ikinci bir ödeme onu değiştirmez.

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

VibeFox Cashfree Payments sekmesi

Sales > Orders bölümünde Cashfree ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Cashfree Payments sekmesi; sandbox ödemeleri için Sandbox etiketiyle Transaction ID değerini, Cashfree order bilgisini, ödemenin Status değerini, Paid / refunded tutarlarını, iade formunu, her iadenin durumunu içeren iade geçmişini ve siparişin Cashfree notes kayıtlarını gösterir. Sekme, uzantıya erişimi olan kullanıcılara gösterilir.

İadeler

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) ekleyin ve Refund via Cashfree düğmesini tıklayın. Refund this amount through Cashfree? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Uzantıyı değiştirme iznine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İadeler Cashfree'nin 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çekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortama (sandbox veya canlı) gönderilir; bu nedenle o ortamın anahtarlarının girili olması gerekir. Cashfree iadeyi kabul etmezse veya iptal edilmiş ya da reddedilmiş olarak bildirirse, sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başlatılan bir iade, iade kimliği, tutarı ve durumuyla birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoğa geri eklemeden, elle yapılan bir durum değişikliği gibi Refunded Status durumuna alır. Kısmi bir iade durumu değiştirmez. İadeler, Cashfree ödemeyi onayladıktan sonra kullanılabilir.

Son iade durumu, iade webhook'u ile gelir ve notlara eklenir. Sales > Returns bölümündeki ürün iadeleri Cashfree üzerinden para geri göndermez.

Lisans anahtarı

Uzantı, vibefox.net adresinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Cashfree Payments lisans bloğu, Extensions > Extensions > Payments > VibeFox Cashfree Payments > Edit bölümündeki ilk bloktur ve ayarların üzerindedir. Anahtarı License key alanına yapıştırın ve Activate düğmesini tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın ne zamana kadar etkin olduğunu 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-cashfree satırı ve hesabınızda vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca uzantı için Modify izni olan 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 Anahtar bulunamadı, Bu anahtar başka bir ürüne ait, Alan adı sınırına ulaşıldı veya tarihiyle birlikte Lisansın son kullanma tarihi. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesini tıklayın. Lisans sunucusuna ulaşılamazsa uzantı son bilinen durumla çalışmaya devam eder.

Bir anahtar 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ızdan boşaltın.

Etkin bir anahtar olmadan Cashfree, müşterilere ödeme sayfasında gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka bir yöntem seçin. mesajını görür. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (lisanssız — yalnızca yöneticilere görünür) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce uzantıyı kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici oturumunu 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önetici Dashboard ekranında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici Dashboard veya Edit sayfasını açtığınızda 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. Uzantının kaldırılması her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Cashfree ö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 anahtarlarının bulunduğunu kontrol edin: sandbox modunda Sandbox App ID ve Sandbox Secret Key, canlı modda App ID ve Secret Key. Anahtarlar eksikse ayarlar sayfası bir uyarı gösterir. Sipariş toplamı Cashfree asgari tutarının altındaysa ödeme yöntemi de gizlenir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total tutarına ulaştığını kontrol edin.

Ödeme yapıldı ama sipariş durumsuz kaldı: webhook çalışmıyor. Mağazanızın HTTPS kullandığını, Developers > Webhooks altındaki URL'nin Webhook URL alanında gösterilenle birebir aynı olduğunu ve ödeme olaylarının seçili olduğunu kontrol edin. Ayarlardaki Secret Key'in ödemenin yapıldığı ortama ait olduğunu kontrol edin. Cashfree panelinde her webhook için mağazanızın yanıtı görünür. Sipariş ayrıca müşteri ödemeden sonra mağazaya döndüğünde ve aynı sepet için bir sonraki ödeme denemesinde de durum alır.

Webhook Missing signature veya Invalid signature yanıtı veriyor: çağrı geçerli bir Cashfree imzası taşımıyordu veya ayarlardaki Secret Key, ödemenin yapıldığı ortamla eşleşmiyor. Sandbox ve canlı anahtarların yer değiştirmediğini kontrol edin.

Webhook Ignored yanıtı veriyor: webhook doğru imzalanmış, ancak bu mağaza tarafından başlatılmamış bir ödemeye ait; örneğin aynı Cashfree hesabındaki başka bir mağaza. Her mağazaya kendi Order ID prefix değerini verin.

Webhook Busy, retry later yanıtı veriyor: sipariş aynı anda başka bir istek tarafından onaylanıyordu veya sipariş durumu ayarlanamadı. Cashfree webhook'u yeniden dener. Nedenini görmek için Debug log seçeneğini açın.

Müşteri «Cashfree ödeme sayfası yüklenemedi. Lütfen tekrar deneyin.» mesajını görüyor: Cashfree betiği, bir engelleyici nedeniyle tarayıcıda yüklenemedi. Müşteri Pay Now düğmesini yeniden tıklayabilir veya Choose another payment method seçebilir.

Müşteri «Cashfree ödemesi başlatılamadı» mesajını görüyor: uzantı sayfasındaki Log alanına bakın. Tipik nedenler, seçili mod için yanlış anahtarlar veya Cashfree hesabınızda etkin olmayan bir para birimidir.

Müşteri Confirm Order sonrasında «Bu ödeme yöntemi kullanılamıyor.» mesajını görüyor: ödeme oturumu artık siparişle eşleşmiyor ya da bu arada ödeme yöntemi kapatılmış. Müşteri ödeme sayfasını yeniden yükler.

Müşteri «Ödeme oturumu bulunamadı. Lütfen tekrar deneyin.» mesajını görüyor: ödeme sayfası bağlantısı bu mağazanın bir ödemesine ait değil veya Cashfree oturumu sona ermiş. Müşteri siparişi yeniden onaylar.

Müşteri «Ödeme doğrulanamadı» mesajını görüyor: dönüş bağlantısı ödemeyle eşleşmedi. Tahsilat yapıldıysa webhook yine de siparişi onaylar. Müşteri yeniden ödeme yapmadan önce Cashfree panelinde ödemeyi kontrol edin.

Sipariş ödemeden sonra inceleme durumunda: VibeFox Cashfree Payments sekmesindeki notları (bkz. Sipariş durumları) okuyun ve ardından siparişi tamamlayın veya ödemeyi iade edin.

Sekmede iade formu yok: sekme nedenini belirtir: ödeme henüz onaylanmamış, tamamen iade edilmiş, kullanıcı grubunuzun uzantıyı değiştirme izni yok veya ödemenin ortamının API anahtarları eksik.

İade, sandbox veya canlı mod ile ilgili bir mesajla başarısız oluyor: ödeme bu ortamda yapıldı ve bu ortamın API anahtarları girilmemiş. Anahtarları girin ve yeniden deneyin.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Cashfree Payments yanındaki Uninstall düğmesini (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, uzantının 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. OpenCart 4'te uzantının olayları ve bakım modunda webhook'a izin veren başlangıç eylemi de kaldırılır. Delete Data on Uninstall açıksa diğer Cashfree ayarları (başlık, açıklama, mod, anahtarlar, API sürümü, sipariş kimliği öneki, günlükleme) ve günlük kaldırılır. Kapalıysa bunlar sonraki bir yeniden kurulum için saklanır. Cashfree işlemleri ve iadeleri her zaman korunur, bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te, uzantının dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu uzantılar listesinde VibeFox Cashfree Payments yanındaki Uninstall düğmesini (turuncu − düğmesi) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesini (kırmızı çöp kutusu) tıklayın.

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