Razorpay
Razorpay'i bağlayarak müşterilerinize sağlayıcının ödeme penceresini sunun ve fatura ödemelerini WISECP üzerinden takip edin.
Ekrana Erişim
Ayarlar → Finansal → Ödeme Altyapıları → Tüm Modüller yolundan RazorPay kartına tıklayın: {admin}/modules/payment?module=RazorPay
Ekranda Neler Var
Formda API anahtar çifti, ödeme işlemi seçimi ve ortak ödeme ayarları bulunur. Ödeme penceresini Razorpay sağlar. Modül WISECP kart saklama, otomatik yenileme tahsilatı, abonelik, taksit ayarı veya ödeme altyapısından iade sunmaz.
Ön Koşullar
Kullanacağınız yöntem ve para birimleri için onaylı Razorpay üye iş yeri hesabı gerekir. Canlı anahtarlar hesap etkinleştirmesi ve ilgili site onayını gerektirir. Ayrı bir test sisteminde test anahtarlarıyla başlayın.
Site HTTPS kullanmalı ve Razorpay ödeme betiğine izin vermeli. Bağlantı testi butonu yoktur. 5.0-beta.4 ya da 5.0-beta.3 düzeltme paketinden itibaren sipariş tutarı her para biriminin Razorpay alt birimiyle gider. KWD gibi üç ondalıklı birimler 1000 ile çarpılır, JPY gibi sıfır ondalıklılar tam birimle gönderilir. Önceki sürümler her tutarı 100 ile çarpar; orada iki ondalıklı para birimleri kullanın.
Alanlar
Test Mode seçeneği yoktur; ortam değiştirirken iki anahtarı da değiştirin. Durum modülü etkinleştirir. Komisyon, dönüşüm, sınırlar ve ülke listeleri Ödeme Yapılandırma rehberindedir.
Callback URL, Success URL ve Failed URL sistemin hazırladığı adreslerdir. Ödeme formu sonucunu zaten Callback URL adresine gönderir.
İşlemler
Anahtarları Tanımlama
- Razorpay Dashboard'da test modunu seçin. Account & Settings → Website and app settings → API Keys yolundan Generate Key butonuna tıklayın.
- Key ID ve Key Secret değerlerini güvenle saklayın; gizli anahtar yalnız üretilirken gösterilir. WISECP RazorPay formunda Durum seçeneğini etkinleştirip iki değeri girin.
- Payment Action → Authorize and Capture seçip Değişiklikleri Kaydet butonuna tıklayın. Razorpay Account & Settings → Payments Capture bölümünde otomatik tahsilatı doğrulayın.
- WISECP Ödeme Altyapıları → Başlangıç → Etkin Modül Seçimi alanında RazorPay'i seçip Değişiklikleri Kaydet butonuna tıklayın. Yöntem belirlediğiniz sınırlar içinde kullanılabilir olur.
Razorpay tahsilat ayarını değiştirmek için Automatic Capture yanındaki Change butonunu kullanın. Süreyi seçip Next ile ilerleyin; iade davranışı ve hızını seçerek Save butonuna tıklayın. Bu ayarlar diğer entegrasyonlar dahil üye iş yeri hesabını etkiler.
Tarayıcı Dönüşü ve Webhook
Modül, imzalı tarayıcı formu yanıtını müşterinin oturumundaki siparişle kontrol eder. Ödeme dönene kadar aynı oturumu açık tutun.
Bu modül Razorpay webhook bildirimlerini kabul etmez ve webhook gizli anahtar alanı yoktur. Callback URL adresini order.paid webhook'u olarak kaydetmeyin.
Test Etme ve Canlıya Geçme
- Ödenmemiş test faturasını ilgili müşteri olarak açın. RazorPay'i seçip sağlayıcının ödeme penceresini açın.
- Razorpay test ödeme bilgilerini kullanın. Pencereyi kapatmadan siteye dönüşü tamamlayın.
- Razorpay'de captured durumunu, WISECP'te ödenmiş faturayı ve tutar/para birimi eşliğini doğrulayın. İptali ve yarıda kalan dönüşü de kontrol edin.
- Onaydan sonra Razorpay canlı anahtarlarını üretin. WISECP'teki iki değeri değiştirip Değişiklikleri Kaydet butonuna tıklayın. Sonraki ödemeler gerçek para kullanır.
Ödemeyi İade Etme
- Razorpay Transactions → Payments bölümünde tahsil edilmiş ödemeyi açın. Refund Payment bölümüne iade tutarını girin.
- Refund Instantly seçeneğini ücretini inceleyerek belirleyin. Issue Full Refund veya Issue Partial Refund butonuna tıklayıp iade durumunu kontrol edin.
- Tam iade için WISECP faturasını açın: {admin}/invoices/detail?id={fatura}. Özet → Durumu Değiştir → İade Edildi ve Gider olarak ekle seçin.
- Durumu Güncelle butonuna tıklayın. WISECP yeni para transferi istemeden iadeyi kaydeder. Kısmi iadeleri gerçek tutarlarıyla ayrıca kaydedin.
Dikkat Edilecekler
Authorize seçiminde ödeme yalnız ön onay alır; zamanında yakalamazsanız Razorpay ödemeyi iade eder (varsayılan 3 gün). 5.0-beta.4 ya da 5.0-beta.3 düzeltme paketinden itibaren imzalı dönüş faturayı Ödeme Bekleniyor durumunda bırakır. Ödemeyi Razorpay'den yakalayın, ardından faturada Özet → Durumu Değiştir → Ödendi seçip Durumu Güncelle butonuna tıklayın. Önceki sürümler dönüşte faturayı ödenmiş sayar; hizmet sunmadan önce Razorpay'deki tahsilatı doğrulayın.
Ödeme, Razorpay siparişinin tutarıyla kaydedilir. Ödeme sayfası açıldıktan sonra fatura büyüdüyse fatura kalan tutar için Ödenmedi durumunda kalır. Bu davranış 5.0-beta.4 ya da 5.0-beta.3 düzeltme paketiyle gelir. Önceki sürümlerde fatura tam ödenmiş sayılır; Razorpay tutarını faturayla karşılaştırın.
Tarayıcı dönüşü kaybolduğunda bu modülü güncelleyen webhook yoktur. Yeniden tahsilattan önce Razorpay ödemesini faturayla karşılaştırın. Ayar kaydının başarılı olması, seçtiğiniz tahsilat işleminin uygulandığını tek başına kanıtlamaz.
Gerekli Yetkiler
WISECP ayarları Faturalandırma Ayarları → Ödeme Altyapıları (MODULES_PAYMENT_SETTINGS), fatura değişiklikleri Faturalandırma → Düzenleme (INVOICES_OPERATION) yetkisini gerektirir. Razorpay anahtarları Owner veya Admin rolü ister. İade için ödeme ve iade kontrollerine erişim gerekir.
İlgili Makaleler
Geri bildiriminiz için teşekkürler!
Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.