VibeFox Razorpay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

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 anahtara sahip bir webhook şiddetle önerilir (bkz. Yapılandırma). INR dışındaki para birimlerinde yapılan ödemeler için Razorpay hesabınızda International Payments etkinleştirilmelidir.

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, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_razorpay_payment klasörünü FTP ile /wp-content/plugins/ klasörüne de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Razorpay > Manage ya da 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. Test Key ID ve Test Key Secret bilgilerinizi girin, Razorpay Dashboard'da webhook'u ayarlayın ve onun gizli anahtarını girin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve Test mode açıkken bir test ödemesi yapın. Hazır olduğunuzda Live anahtarlarını girin ve Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Razorpay. Alanların üstünde sayfa uyarılar gösterir: geçerli modun anahtarları eksiktir (bu durumda ödeme yöntemi ödeme sayfasında gizlenir), Key ID test modunda rzp_test_ ile, canlı modda rzp_live_ ile başlamıyordur, test modu açıktır, webhook gizli anahtarı boştur ya da mağaza para birimi INR değildir ve Razorpay hesabınızda International Payments etkinleştirilmelidir. Ödeme yöntemleri listesinde, geçerli modun anahtarları girilene kadar Razorpay kurulum gerektiren olarak işaretlenir; test modu açık olduğu sürece bir Test mode rozeti görünür. Anahtarlarla birlikte yapıştırılan boşluklar kaydetme sırasında kaldırılır.

Genel

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önteminin adı. Varsayılan: UPI, Cards, NetBanking.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via UPI, Credit/Debit Card, or Internet Banking through Razorpay.

API anahtarları

Anahtarlarınızı Razorpay Dashboard'da Account & Settings > API Keys altında alın. Test anahtarları (rzp_test_...) oluşturmak için Dashboard'u Test moduna geçirin. Canlı anahtarlar (rzp_live_...) hesabınız etkinleştirildikten sonra kullanılabilir.

Test mode: Use the Test mode keys (no real money is charged). Varsayılan: açık. Gerçek ödemeler almak için işaretini kaldırın. Bir siparişin ödemeleri, tahsilatları ve iadeleri her zaman siparişin ödendiği modun anahtarlarını kullanır; bu nedenle modu sonradan değiştirmek mevcut siparişleri etkilemez.

Test Key ID: Razorpay Dashboard'da Test modundaki Key ID. rzp_test_ ile başlar.

Test Key Secret: Razorpay Dashboard'da Test modundaki Key Secret.

Live Key ID: Razorpay Dashboard'da Live modundaki Key ID. rzp_live_ ile başlar.

Live Key Secret: Razorpay Dashboard'da Live modundaki Key Secret.

Ödeme

Payment Action: paranın ne zaman tahsil edileceği. Varsayılan: Authorize & Capture.

Authorize & Capture: müşteriden hemen tahsilat yapılır. Razorpay yetkilendirilmiş bir ödeme bildirirse eklenti bunu tahsil eder.

Authorize Only: tutar ayrılır. Sipariş “Beklemede” durumuna alınır ve ödemeyi daha sonra Capture Razorpay payment sipariş işlemiyle ya da Razorpay Dashboard'da tahsil edersiniz. Razorpay, zamanında tahsil edilmeyen yetkilendirilmiş ödemeleri otomatik olarak iade eder.

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 bölümüne gidin ve test modu için bir webhook, canlı mod için başka bir webhook ekleyin. Ayarların bu bölümünde gösterilen URL'yi kullanın. URL şu biçimdedir: https://your-site/wc-api/razorpay_p_webhook/. Ayarlarda gösterildiği gibi birebir kopyalayın. Razorpay'de seçtiğiniz bir gizli anahtar girin ve şu olayları seçin:

payment.authorized: bir ödeme yetkilendirildi.

payment.captured: bir ödeme tahsil edildi; Razorpay Dashboard'da tahsil ettiğinizde de dahil.

payment.failed: bir ödeme denemesi başarısız oldu.

order.paid: ödemeye ait Razorpay siparişi ödendi.

refund.created: bir ödeme iade edildi, örneğin Razorpay Dashboard'da.

Webhook Secret: webhook oluştururken girdiğiniz gizli anahtar. Test ve canlı webhook'lar için aynı gizli anahtarı kullanın, çünkü eklentide 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 veya daha sonra sipariş ödeme sayfasını yeniden açtığında onaylanır.

Gelişmiş

Enable Logging: Save debug logs. Günlük WooCommerce > Status > Logs altında, kaynak wcp_razorpay_payment olarak bulunur. Hatalar ve uyarılar her zaman kaydedilir; bu seçenek hata ayıklama ayrıntılarını ekler. Anahtarlar, imzalar ve müşteri iletişim bilgileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: Remove the plugin settings and logs when the plugin is deleted (orders are never touched). Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak UPI, Cards, NetBanking) ve siparişi verir. Eklenti, sipariş toplamı ve para birimi için tam bir Razorpay siparişi oluşturur ve sipariş ödeme sayfasını açar. Razorpay Checkout penceresi orada otomatik olarak açılır; müşterinin adı, e-posta adresi ve telefon numarası önceden doldurulmuş olur. Pencere kapatılırsa müşteri yeniden açmak için Pay Now düğmesine ya da Cancel order düğmesine tıklayabilir. Test modunda sayfa Razorpay Test mode: no real money will be charged. mesajını gösterir.

Başarılı bir ödemeden sonra 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 onayladıktan sonra ödenmiş olarak işaretlenir. Müşteri ardından sipariş alındı sayfasını görür. İmza geçerli olduğu halde ödeme o anda alınamazsa sipariş “Beklemede” durumuna alınır ve webhook bunu daha sonra onaylar.

Müşteri ödenmemiş bir siparişe geri dönerse eklenti, o siparişin Razorpay siparişini yeniden kullanır. Razorpay siparişi zaten ödenmişse, örneğin müşteri tarayıcıyı kapattığı ve webhook bulunmadığı için, eklenti ikinci bir ödeme istemek yerine ödemeyi uygular.

Müşterinin görebileceği mesajlar:

Payment was cancelled. Please click "Pay Now" to try again.

Your session has expired. Please click "Pay Now" to try again.

We could not verify your payment. Mesajda, para çekilmişse Razorpay onayladığında siparişin otomatik olarak güncelleneceği belirtilir.

Razorpay is temporarily unavailable. Please try again in a few minutes.

Razorpay could not accept this payment: ardından Razorpay'in belirttiği neden gelir.

The order amount is too small to be paid with Razorpay.

Razorpay Checkout could not be loaded. Pencere betiği engellendi; mesaj bağlantının kontrol edilmesini, içerik engelleyicilerin devre dışı bırakılmasını ve sayfanın yeniden yüklenmesini ister.

Ödeme yöntemi klasik ödeme sayfasında, Checkout bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca tek seferlik ödemeleri destekler. Abonelik veya yinelenen ödemeler, kayıtlı kartlar, Razorpay Magic Checkout, Payment Links veya Route (bölünmüş ödemeler) ve teklif ya da uygun fiyat widget'ları içermez.

Siparişler ve iadeler

Order statuses

Pending payment: Razorpay siparişi oluşturuldu ve müşteri henüz ödeme yapmadı. Her Razorpay siparişi, tutarı ve modu ile birlikte sipariş notlarına eklenir.

Processing or Completed: ödeme tahsil edildi ve onaylandı; ödemeden sonra WooCommerce'in varsayılan durumudur. Sipariş notu, Razorpay ödeme kimliğini, tutarı ve onayın nasıl alındığını (geri çağrı, webhook veya dönüşte kontrol) gösterir. İşlem kimliği, Razorpay ödeme kimliğidir (pay_...).

On hold: şu durumlarda ayarlanır ve her biri bir sipariş notuyla birlikte gelir: ödeme yalnızca yetkilendirildi (Authorize Only), ödenen tutar veya para birimi siparişle eşleşmiyor, ödeme iptal edilmiş bir sipariş için tahsil edildi ya da ödeme o anda Razorpay API'si üzerinden doğrulanamadı. Zaten “Beklemede” durumunda olan bir sipariş de nota sahip olur.

Failed: bekleyen bir sipariş için payment.failed webhook'u geldi. Not, Razorpay hatasını gösterir. Müşteri yine de tekrar ödeme yapabilir; zaten yetkilendirilmiş veya tahsil edilmiş bir ödemesi olan sipariş değiştirilmez.

Cancelled: müşteri Cancel order seçeneğine tıkladı ya da sipariş sizin tarafınızdan veya WooCommerce stok rezervi zaman aşımı nedeniyle iptal edildi. Daha sonra gelen bir ödeme siparişi otomatik olarak yeniden açmaz: yetkilendirilmiş bir ödeme tahsil edilmez, tahsil edilmiş bir ödeme ise siparişi incelemeniz için “Beklemede” durumuna alır.

Zaten ödenmiş bir sipariş için ek bir ödeme gelirse sipariş değişmez. Bir not, bunun amaçlanmadığı durumda Razorpay Dashboard'da iade etmenizi ister.

Tahsilat (Authorize Only)

“Beklemede” durumundaki siparişi açın, Order actions bölümünde Capture Razorpay payment seçeneğini seçin ve güncelleme düğmesine tıklayın. Ödeme, yetkilendirildiği modda tahsil edilir ve sipariş ödenmiş olur. Razorpay reddederse sipariş notu, nedeniyle birlikte Razorpay capture failed: mesajını gösterir. Razorpay Dashboard'da yapılan bir tahsilat, siparişi webhook aracılığıyla tamamlar.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve ardından ödeme yönteminin adını içeren Refund via düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı modun anahtarlarıyla gönderilir. Razorpay iadeyi kabul etmezse WooCommerce nedeniyle birlikte Razorpay refund failed: mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Razorpay iade kimliği, tutar ve durumla birlikte sipariş notlarına eklenir.

Razorpay Dashboard'da yapılan iadeler webhook ile gelir ve siparişe WooCommerce iadesi olarak, bir kez ve ürünleri stoğa geri eklemeden kaydedilir. Başka bir para biriminde ya da iade edilebilir tutardan yüksek yapılan bir Dashboard iadesi otomatik olarak kaydedilmez; bir not sizden bunu elle kaydetmenizi ister.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Razorpay 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 düğmesini 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. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Razorpay, ö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. Oturum açmış mağaza yöneticileri, bir anahtar satın almadan eklentiyi kurup test edebilmeniz için ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisansın 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

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. Eksikse ayarlar sayfası bir uyarı gösterir.

Ödeme geçti ama sipariş Pending payment durumunda kalıyor: webhook çalışmıyor. Razorpay Dashboard'da kullandığınız modda (Test veya Live) webhook'un var olduğunu, URL'sinin ayarlarda 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 sipariş ödeme sayfasını yeniden açtığında da sipariş onaylanır.

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

Webhook, Invalid signature veya Missing signature yanıtını veriyor: ayarlardaki gizli anahtar, Razorpay webhook'unun gizli anahtarından farklı. Aynı gizli anahtarı iki yere de girin.

Webhook, Retry later yanıtını veriyor: eklenti, Razorpay API ile bir tahsilatı onaylayamadı ya da sipariş aynı anda başka bir istek tarafından güncelleniyordu. Razorpay olayı otomatik olarak yeniden gönderir.

Bir sipariş On hold durumunda: sipariş notunu okuyun. Ödeme yalnızca yetkilendirildi (Capture Razorpay payment kullanın), tutar veya para birimi siparişle eşleşmedi, ödeme iptal edilmiş bir siparişe ulaştı ya da o anda Razorpay API üzerinden doğrulanamadı ve webhook'u bekliyor.

Müşteri ödeme yaparken bir hata görüyor: sipariş notlarını açın ya da WooCommerce > Status > Logs bölümüne bakın; kaynak wcp_razorpay_payment. Hatalar, Enable Logging kapalıyken bile kaydedilir. Yanlış anahtarlar, ödeme yönteminin şu anda kullanılamadığı mesajını verir. Razorpay'den gelen diğer nedenler Razorpay could not accept this payment: mesajının ardından gösterilir.

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

İade başarısız oluyor: iade, ödemenin yapıldığı modun anahtarlarını kullanır. Bu modun anahtarlarının girildiğini kontrol edin ve hata mesajındaki nedeni okuyun.

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 hak 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. Geçit ayarları ve günlükler (döndürülmüş olanlar dahil günlük dosyaları ve veritabanındaki günlük kayıtları), yalnızca Delete Data on Uninstall açıksa silinir. Aksi halde ileride yeniden kurulum için saklanır. Siparişler ve Razorpay verileri hiçbir zaman silinmez. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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