# Razorpay Modülü

https://docs.wisecp.com/tr/razorpay-modulu

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 Ağ Geçitleri → 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. Modül tutarı 100 ile çarpar; farklı ondalık basamak kullanan para birimlerinin desteklendiğini varsaymayın.

## Alanlar

- **Key Id**: Zorunlu; varsayılanı boş. Seçilen üye iş yeri hesabının test veya canlı Key ID değerini girin.
- **Key Secret**: Zorunlu; varsayılanı boş. Key Id ile aynı ortam ve anahtar çiftine ait olmalı.
- **Payment Action**: Formun varsayılanı Authorize and Capture. Authorize sadece ön onay ister. Seçiminizi açıkça kaydedin ve Razorpay tahsilat ayarlarını kontrol edin.

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 Modülleri](https://docs.wisecp.com/tr/odeme-modulleri) 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

1. Razorpay Dashboard'da test modunu seçin. **Account & Settings → Website and app settings → API Keys** yolundan **Generate Key** butonuna tıklayın.
2. 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.
3. **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.
4. WISECP **Ödeme Ağ Geçitleri → 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

1. Ödenmemiş test faturasını ilgili müşteri olarak açın. RazorPay'i seçip sağlayıcının ödeme penceresini açın.
2. [Razorpay test ödeme bilgilerini](https://razorpay.com/docs/payments/payment-gateway/web-integration/standard/integration-steps/) kullanın. Pencereyi kapatmadan siteye dönüşü tamamlayın.
3. 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.
4. 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

1. Razorpay **Transactions → Payments** bölümünde tahsil edilmiş ödemeyi açın. **Refund Payment** bölümüne iade tutarını girin.
2. **Refund Instantly** seçeneğini ücretini inceleyerek belirleyin. **Issue Full Refund** veya **Issue Partial Refund** butonuna tıklayıp iade durumunu kontrol edin.
3. 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.
4. **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

> **Ön Onay Tahsilat Değildir**
> 
> Mevcut modül, geçerli imzalı dönüşü tahsilat durumunu sorgulamadan kabul eder. Authorize seçimi bu nedenle para tahsil edilmeden WISECP faturasını kapatabilir. Hizmet sunmadan önce Razorpay'deki tahsilatı doğrulayın.

> **Kaybolan Dönüşü 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ı **Modüller → Ö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

- [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı Genel Görünüm](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [Razorpay API Anahtarları](https://razorpay.com/docs/payments/dashboard/account-settings/api-keys/)
- [Razorpay Tahsilat Ayarları](https://razorpay.com/docs/payments/payments/capture-settings/)
- [Razorpay İadeleri](https://razorpay.com/docs/payments/refunds/issue/)