VibeFox Razorpay for OpenCart — Yardım

Gereksinimler

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

PHP: 8.0 veya üzeri.

Razorpay hesabı: test modu için Razorpay hesabınızın Key ID ve Key Secret bilgilerine, canlı mod için ise hesabınız etkinleştirildikten sonra bu bilgilere ihtiyacınız vardır. Seçtiğiniz bir gizli anahtarla bir webhook oluşturmanız kesinlikle önerilir (bkz. Yapılandırma). INR dışındaki para birimlerinde yapılan ödemeler için Razorpay hesabınızda International Payments etkin olmalıdır.

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_razorpay_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_razorpay_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önetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_razorpay_payment-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications sayfasını yenilemeniz 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 sayfasına gidin ve tür olarak Payments seçin. VibeFox Razorpay Payment 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 iznine sahip olması gerekir.

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

4. Test Key ID ve Test Key Secret bilgilerinizi girin, Razorpay Dashboard'da webhook'u ayarlayın ve gizli anahtarını girin (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode açıkken bir test ödemesi yapın. Hazır olduğunuzda Live anahtarlarını girin ve Test mode seçeneğini kapatın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_razorpay_payment.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ı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox Razorpay Payment eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, Razorpay 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 test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Razorpay Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Ayarların üzerinde sayfa, siparişin yalnızca ödeme Razorpay ile doğrulandıktan sonra bir durum aldığını açıklar ve uyarılar gösterir: geçerli modun anahtarları eksiktir (bu durumda Razorpay ödeme sayfasında gösterilmez), test modunda Key ID rzp_test_ ile, canlı modda ise rzp_live_ ile başlamıyordur, test modu açıktır, webhook gizli anahtarı boştur veya mağazanın varsayılan para birimi INR değildir ve Razorpay hesabınızda International Payments etkin olmalıdır. Uyarılar her kayıttan sonra güncellenir.

Kaydederken Title alanı 1 ila 128 karakter uzunluğunda olmalıdır (Enter a title for the payment method (1 to 128 characters).), Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve bölge ile her sipariş durumu mevcut olmalıdır. Aksi takdirde hiçbir şey kaydedilmez. Key ID'lerle birlikte yapıştırılan boşluklar silinir.

Razorpay

Enable/Disable: Enable Razorpay 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ı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: UPI, Cards, NetBanking. Zorunludur, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında, onay düğmesinin üzerinde gördüğü metin. Varsayılan: Pay securely via UPI, Credit/Debit Card, or Internet Banking through Razorpay.

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

Geo Zone: Razorpay'ı 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 altında ayarlanır.

Total: Razorpay'ın sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme tutarı: 0 veya daha büyük bir sayı. Her tutar için Razorpay sunmak üzere boş bırakın.

API anahtarları

Anahtarlarınızı Razorpay Dashboard'da Account & Settings > API Keys altından alın (sayfada bu bölümün bağlantısı bulunur). Test anahtarları (rzp_test_...) oluşturmak için Dashboard'u Test moduna alın. Canlı anahtarlar (rzp_live_...) hesabınız etkinleştirildikten sonra kullanılabilir.

Test mode: Test modu anahtarlarını kullanır, bu nedenle gerçek para tahsil edilmez. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın. Bir siparişin ödemeleri, tahsilatları ve iadeleri her zaman siparişin ödendiği modun anahtarlarını kullanır; bu nedenle modu daha sonra değiştirmek mevcut siparişleri etkilemez. Açıkken müşteriler Confirm Order adımında ve ödeme sayfasında Razorpay Test mode: no real money will be charged. ifadesini görür.

Test Key ID: Test modunda Razorpay Dashboard'dan alınan Key ID. rzp_test_ ile başlar.

Test Key Secret: Test modunda Razorpay Dashboard'dan alınan Key Secret.

Live Key ID: Canlı modda Razorpay Dashboard'dan alınan Key ID. rzp_live_ ile başlar.

Live Key Secret: Canlı modda Razorpay Dashboard'dan alınan Key Secret.

Kaydedilmiş gizli anahtarlar bir daha asla 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 değeri kaldırmak için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme

Payment Action: paranın tahsil edildiği an. Varsayılan: Authorize & Capture.

Webhook

Webhook, müşteri ödemeden hemen sonra tarayıcıyı kapatsa bile ödemeleri onaylar ve Razorpay Dashboard'da yapılan iadeleri kaydeder. Razorpay Dashboard'da Account & Settings > Webhooks sayfasına gidin ve Test modunda bir webhook, Canlı modda bir webhook daha ekleyin. Bu bölümde Webhook URL altında gösterilen URL'yi kullanın. OpenCart 3'te URL şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_razorpay_payment/webhook; OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_razorpay_payment/payment/wcp_razorpay_payment.webhook. URL, OpenCart kurulumunuzun mağaza adresinden oluşturulur. Ayarların gösterdiği gibi birebir kopyalayın. Razorpay'de seçtiğiniz bir gizli anahtar girin ve şu olayları seçin (bu bölümde de listelenmişlerdir):

Webhook Secret: webhook oluştururken girdiğiniz gizli anahtar. Test ve Canlı webhook'lar için aynı gizli anahtarı kullanın, çünkü eklentinin ikisi için tek bir alanı vardır. Geçerli imzası olmayan webhook'lar reddedilir. Webhook olmadan bir ödeme yalnızca müşteri açılır pencereden döndüğünde ya da müşteri aynı sepet için ödemeyi daha sonra yeniden başlattığında onaylanır.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, yalnızca Razorpay ödemeyi onayladıktan sonra bir durum alır. Başarısız veya yarıda bırakılan bir ödeme siparişi durumsuz bırakır ve sepet korunur. OpenCart'ta Authorized ve On hold durumları yoktur, bu nedenle mevcut durumlardan birini seçersiniz; nedeni sipariş notları açıklar. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: ödeme tahsil edilmiştir ve tutar ile para birimi eşleşir. Varsayılan: İşleniyor.

Authorized Status: Authorize Only: para ayrılmıştır, henüz tahsil edilmemiştir. Varsayılan: Beklemede.

On Hold (Review) Status: manuel inceleme: ödenen tutar veya para birimi sipariş toplamından farklıdır, iptal edilmiş bir sipariş için ödeme gelmiştir ya da açılır pencerenin imzası geçerliydi ancak ödeme Razorpay API'si üzerinden doğrulanamadı. Varsayılan: Beklemede. Kendi durumlarınızı System > Localisation > Order Statuses altında oluşturabilir ve buradan seçebilirsiniz.

Cancelled Status: Eklenti bu durumu hiçbir zaman ayarlamaz. Yalnızca eklentiye hangi siparişlerin iptal edildiğini bildirir: böyle bir sipariş için daha sonra tahsil edilen bir ödeme siparişi yeniden açmak yerine incelemeye alır; yetkilendirilmiş bir ödeme yalnızca bir not ekler. Varsayılan: İptal edildi.

Refunded Status: ödeme tamamen iade edildikten sonra, sipariş sekmesinden veya Razorpay Dashboard'dan ayarlanır. Varsayılan: İade edildi.

Gelişmiş

Enable Logging: günlük, OpenCart günlükler klasöründe (storage/logs) razorpay_p_debug.log.php dosyasına yazılır. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman günlüğe yazılır; bu seçenek hata ayıklama ayrıntılarını ekler. Anahtarlar, imzalar ve müşteri iletişim bilgileri asla günlüğe yazılmaz. Varsayılan: kapalı.

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

Delete Data on Uninstall: açık olduğunda eklentiyi kaldırmak, geçit ayarlarını ve günlüğü siler. Siparişler ile bunların Razorpay işlemleri ve iadeleri her zaman korunur. Varsayılan: kapalı.

İçe Aktar / Dışa Aktar

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Gizli 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ı gizli anahtarlar korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak UPI, Cards, NetBanking). Confirm Order adımında müşteri açıklamanızı ve After "Confirm Order" the Razorpay Checkout window opens to pay securely (UPI, cards, NetBanking, wallets). notunu görür. OpenCart siparişi bu adımda, yine durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, siparişin tam tutarı ve para birimi için bir Razorpay siparişi oluşturur ve mağazanızın Razorpay payment sayfasını açar. Razorpay Checkout penceresi orada otomatik olarak açılır ve müşterinin adı, e-posta adresi ve telefonu önceden doldurulmuş olur. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Ödeme Razorpay'de Order # ve sipariş numarası olarak görünür. Pencere kapatılırsa müşteri yeniden açmak için Pay Now, ödeme sayfasına dönmek için Choose another payment method düğmesine tıklayabilir. Sepet korunur.

Başarılı bir ödemeden sonra müşteri Please wait while we process your payment... mesajını görür. Eklenti Razorpay imzasını kontrol eder, ödemeyi Razorpay API'sinden alır ve tutarı ile para birimini siparişle karşılaştırır. Sipariş, yalnızca Razorpay onaylarsa ödenmiş olarak işaretlenir. Ardından sipariş, olağan OpenCart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri OpenCart sipariş başarı sayfasını görür. İmza geçerli ancak ödeme o anda alınamıyorsa sipariş On Hold (Review) Status alır ve webhook bunu daha sonra onaylar.

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 günceller; bu nedenle açılır pencere kapatıldıktan veya Choose another payment method seçildikten sonra müşteri aynı siparişi öder. Yeni bir ödeme başlamadan önce eklenti aynı sepetin açık Razorpay siparişlerini kontrol eder: zaten ödenmiş olan (örneğin müşteri tarayıcıyı kapattığı ve webhook bulunmadığı için) bir sipariş, ikinci bir ödeme istemek yerine uygulanır ve diğerleri artık sunulmaz. Müşteri aynı siparişi yeniden öderse, tutar, para birimi ve mod değişmemişse o siparişin Razorpay siparişi yeniden kullanılır; aksi halde yeni bir tane oluşturulur. Sepet zaten başka bir sipariş tarafından ödenmişse müşteri doğrudan başarı sayfasına gider.

Müşterinin görebileceği mesajlar:

OpenCart 4'te, siparişi mağaza tarafından kapatıldıysa ya da farklı bir sepet için zaten ödenmişse (örneğin sepet o zamandan beri değişmişse, yeni bir adet dahil), müşteri Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order işlemi yeni bir sipariş öder. OpenCart 4'te ödeme sayfasına geri döndüren mesajlar, örneğin bu mesaj, Payment session not found. Please try again. ve We could not verify your payment., ödeme sayfasının üstünde gösterilir.

Webhook, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentisi isteklerine izin verir, OpenCart 4'te ise eklenti webhook ve açılır pencerenin sonucu için bir başlangıç eylemi ekler.

Eklenti yalnızca tek seferlik ödemeleri kabul eder. Abonelik veya tekrarlayan ödeme, kayıtlı kart, Razorpay Magic Checkout, Payment Links veya Route (bölünmüş ödemeler) ve teklif ya da taksit bileşenleri yoktur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri ödeme yapmadı, ödeme denemesi başarısız oldu veya Razorpay ödemeyi henüz onaylamadı. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.

Order Status After Payment (varsayılan İşleniyor): ödeme tahsil edildi ve onaylandı. Bir notta Razorpay ödeme kimliği (pay_...), tutar ve onaylanma biçimi (callback, webhook, senkronizasyon veya yönetici) gösterilir.

Authorized Status (varsayılan Beklemede): ödeme yalnızca yetkilendirildi (Authorize Only). Siparişi tamamlamak için tahsil edin.

On Hold (Review) Status (varsayılan Beklemede): bu durumlarda ayarlanır, her biri bir notla: ödenen tutar veya para birimi siparişle eşleşmedi, iptal edilmiş bir sipariş için ödeme tahsil edildi ya da ödeme o anda Razorpay API'si üzerinden doğrulanamadı. Siparişi kontrol edin ve ardından işleyin veya ödemeyi iade edin.

Cancelled Status: iptal edilmiş bir sipariş için daha sonra gelen bir ödeme, siparişi otomatik olarak yeniden açmaz: yetkilendirilmiş bir ödeme tahsil edilmez ve yalnızca bir not alır, tahsil edilmiş bir ödeme ise siparişi incelemeye alır. Siparişi daha sonra iptal etseniz bile, siparişi zaten ödemiş olan ödemenin tekrarlanan bildirimi hiçbir şeyi değiştirmez.

Refunded Status (varsayılan İade edildi): ödeme tamamen iade edilmiştir.

Zaten ödenmiş bir sipariş için ek bir ödeme gelirse sipariş değiştirilmez. Bir not, bu istenmeyen bir ödemeyse Razorpay Dashboard'da iade etmenizi ister. Zaten ödenmiş bir sepetin daha eski bir siparişi için geç gelen bir ödeme, o eski siparişi durumsuz bırakır ve ödenmiş sipariş nota kavuşur. Ödenmiş bir sipariş için geç gelen payment.failed yalnızca bir not ekler.

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

VibeFox Razorpay Payment sekmesi

Sales > Orders sayfasında Razorpay ile ödenmiş bir siparişi açın. Sipariş sayfasının alt kısmında, History ve Additional yanında bulunan VibeFox Razorpay Payment sekmesi; test ödemeleri için Test mode etiketli Payment ID'yi, Razorpay order'ı, ödemenin Status'ünü, Paid / refunded bilgisini (Razorpay'in tahsil ettiği tutar ve iade edilen tutar), tahsilat düğmesini, iade formunu, iade geçmişini ve siparişin Razorpay notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir. Tahsilat ve iadeler için eklentiyi değiştirme izni gerekir (System > Users > User Groups altında ayarlanır).

Tahsilat (Authorize Only)

Siparişi Authorized Status durumunda açın, sekmede Capture Razorpay payment düğmesine tıklayın ve Capture the authorized Razorpay payment? sorusunu onaylayın. Ödeme, yetkilendirildiği modda tahsil edilir ve sipariş, müşteriye bildirilmeden ve stok değiştirilmeden, elle durum değişikliği gibi Order Status After Payment durumuna alınır. Razorpay reddederse sekme ve notlar, nedeniyle birlikte Razorpay capture failed: mesajını gösterir. Razorpay Dashboard'da yapılan bir tahsilat, siparişi webhook aracılığıyla tamamlar.

İadeler

Sekmede 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 Razorpay düğmesine tıklayın. Refund this amount through Razorpay? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. İadeler, Razorpay'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çekten ödediği tutara kadar iade yapabilirsiniz. Daha büyük bir tutar girilirse Invalid refund amount: at most ve ardından tutar gösterilir. İade, ödemenin yapıldığı modun anahtarlarıyla gönderilir. Razorpay iadeyi kabul etmezse sekme Razorpay refund failed: ve nedenini gösterir; hiçbir iade kaydedilmez. Başarılı bir iade, Razorpay iade kimliği, tutar ve durum bilgileriyle birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan Refunded Status durumuna alır. Kısmi iade durumu değiştirmez. İadeler, ödeme tahsil edildikten sonra kullanılabilir.

Sales > Returns altındaki ürün iadeleri Razorpay üzerinden para göndermez.

Razorpay Dashboard'da yapılan iadeler webhook aracılığıyla gelir ve iade geçmişine (Razorpay Dashboard olarak işaretlenmiş) ve notlara bir kez kaydedilir. Sipariş tamamen iade edildiğinde durumu Refunded Status olur. Başka bir para biriminde veya iade edilebilir tutarın üzerinde yapılan bir Dashboard iadesi otomatik olarak kaydedilmez; bir not bunu elle kaydetmenizi ister.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Razorpay Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox Razorpay Payment > 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: 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. Bunların altında Product: opencart-payment-razorpay 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 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 açıklar, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihle birlikte License expired on. Mağaza adresi değiştikten 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 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 serbest bırakın.

Etkin bir anahtar olmadan Razorpay, müşterilere ödeme sayfasında 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önetici paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmediği için etkin anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün boyunca gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve tahsilat ile iadeler çalışır.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Razorpay ö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 iki anahtarın da bulunduğunu kontrol edin: test modunda Test Key ID ve Test Key Secret, canlı modda Live Key ID ve Live Key Secret. Eksik olduklarında ayarlar sayfası bir uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme başarılı oldu ama sipariş durumsuz kaldı: webhook çalışmıyor. Razorpay Dashboard'da, kullandığınız modda (Test veya Live) webhook'un var olduğunu, URL'sinin Webhook URL altında gösterilenle birebir aynı olduğunu ve beş olayın seçili olduğunu kontrol edin. Webhook Secret değerinin Razorpay'deki gizli anahtarla aynı olduğunu doğrulayın. Müşteri açılır pencereden döndüğünde ya da aynı sepet için ödemeyi yeniden başlattığında sipariş de durumunu alır.

Webhook şu yanıtı veriyor: Webhook secret not configured: Webhook Secret boş. Razorpay webhook'unun gizli anahtarını girin. Razorpay olayı daha sonra yeniden gönderir.

Webhook şu yanıtı veriyor: Invalid signature veya Missing signature: ayarlardaki gizli anahtar, Razorpay webhook'unun gizli anahtarından farklı. Test ve Canlı webhook'lar için her iki yere de aynı anahtarı girin.

Webhook şu yanıtı veriyor: Retry later: eklenti bir tahsilatı Razorpay API ile onaylayamadı, sipariş durumu ayarlanamadı veya sepet o anda başka bir istek tarafından güncelleniyordu. Razorpay olayı otomatik olarak yeniden gönderir. Nedeni Log alanındadır.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Razorpay'den gelen istekleri kabul eder.

Bir sipariş inceleme durumunda: VibeFox Razorpay Payment sekmesindeki notları okuyun. Tutar veya para birimi siparişle eşleşmedi, ödeme iptal edilmiş bir sipariş için geldi ya da o anda Razorpay API'si üzerinden doğrulanamadı ve webhook'u bekliyor.

Müşteri ödeme sırasında bir hata görüyor: eklenti sayfasındaki Log alanına bakın. Enable Logging kapalı olsa bile hatalar günlüğe yazılır. Yanlış anahtarlar, ödeme yönteminin o an kullanılamadığı mesajını verir. Razorpay'in diğer nedenleri Razorpay could not accept this payment: ifadesinden sonra gösterilir.

Açılır pencere açılmıyor: Razorpay Checkout betiği bir içerik engelleyici veya bağlantı tarafından engellendi. Müşteri bir mesaj görür ve sayfayı yeniden yükleyebilir.

Sekmede tahsilat veya iade formu yok: sekme nedenini belirtir: ödeme henüz tahsil edilmemiştir, tamamen iade edilmiştir, kullanıcı grubunuzun eklentiyi değiştirme izni yoktur veya ödemenin yapıldığı modun anahtarları ayarlanmamıştır (The payment was made in Test mode, but the Test Key ID / Key Secret are not configured. ya da Canlı mod için aynı mesaj). Bu modun anahtarlarını girin ve yeniden deneyin.

Kaldırma

Extensions > Extensions sayfasına gidin, tür olarak Payments seçin ve VibeFox Razorpay Payment 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. OpenCart 4'te ayrıca eklentinin 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 geçit ayarları (başlık, açıklama, test modu, anahtarlar, ödeme eylemi, webhook gizli anahtarı, günlükleme) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Razorpay işlemleri ve iadeleri her zaman korunur; bu nedenle önceden ödenmiş siparişler yeniden kurulumdan sonra da tahsil edilip 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 Razorpay Payment 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) tıklayın.

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