# Flutterwave

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

Flutterwave ile kart, banka havalesi, USSD, mobil para ve diğer yerel yöntemlerle tek bir ödeme sayfasında, Flutterwave hesabınızın kabul ettiği para birimlerinde tahsilat yapın.

## Ekrana Erişim

**Ayarlar → Finansal → Ödeme Ağ Geçitleri** yolunu izleyin, **Tüm Modüller** sekmesini açın ve Flutterwave kartına tıklayın: `{admin}/modules/payment?module=Flutterwave`

**Durum** kutusunu işaretleyip kaydettiğinizde yöntem ödeme adımında listelenir. Müşterinin gördüğü sırayı [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri) ekranından düzenleyin.

## Ekranda Neler Var

Kart; Flutterwave gizli anahtarınızı, isteğe bağlı bildirim değerini (Secret Hash) ve göstermek istediğiniz ödeme seçeneklerini taşır.

Müşteri ödeme adımında tutarı ve **Flutterwave ile Devam Et** butonunu gösteren bir Flutterwave paneli görür. Butona tıklayınca Flutterwave'in kendi ödeme sayfası açılır, ödeme sonrası müşteri sitenize döner.

Tutar Flutterwave'e fatura para biriminde ya da **Para Birimi Dönüştürme** alanında seçtiğiniz para biriminde gider. İadeyi panelden gönderebilirsiniz. Abonelik, kart saklama, otomatik ödeme ve taksit desteklenmez.

Bu modül, Flutterwave'in kullanımdan kaldırdığı bir API üzerinde çalışan eski **RavePay (Eski v2)** modülünün yerine geçer.

## Ön Koşullar

- Bir Flutterwave hesabı ve panelde **Settings → API Keys** yolundan okunan gizli anahtarı. Modu anahtarın kendisi belirler; ayrı bir test kutusu yoktur.
- Tahsilat yapmayı planladığınız her para biriminin Flutterwave hesabınızda etkin olması. Hesabın kabul etmediği bir para birimi, ödeme sayfası oluşturulurken reddedilir.
- Müşteri tarayıcısını kapatsa bile ödemenin onaylanmasını istiyorsanız Flutterwave panelinde **Settings → Webhooks** bölümüne erişim.

## Alanlar

- **Durum**: Modülü açar. Kapalıyken diğer alanlar kilitli kalır ve müşteriye bu yöntem sunulmaz.
- **Gizli Anahtar**: Tahsilat için zorunlu. Test kipinde `FLWSECK_TEST-`, canlı kipte `FLWSECK-` ile başlar; form başka bir biçimi kabul etmez.
- **Secret Hash**: İsteğe bağlı. Webhook'u Flutterwave panelinde kaydederken Secret Hash olarak girdiğiniz değer. Bildirimin gerçekten Flutterwave'den geldiğini kanıtlar; boşsa bildirimler işlenmez.
- **Ödeme Seçenekleri**: İsteğe bağlı. Ödeme sayfasında gösterilecek Flutterwave seçenek adları, virgülle ayrılmış; örneğin `card,banktransfer,ussd`. Boş bırakırsanız hesabınızda etkin olan tüm yöntemler gösterilir.

Komisyon, **Para Birimi Dönüştürme**, kabul edilen tutar aralığı ve ülke listeleri her ağ geçidinde aynı çalışır: [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri). **Callback URL**, **Success URL** ve **Failed URL** alanlarını değiştiremezsiniz; webhook olarak kaydettiğiniz adres callback adresidir.

## İşlemler

### Flutterwave hesabınızı bağlama

1. Flutterwave panelinde **Settings → API Keys** sayfasını açın. Paneli test moduna alın ve `FLWSECK_TEST-` ile başlayan anahtarı kopyalayın.
2. **Tüm Modüller** altındaki Flutterwave kartını açın ve **Durum** kutusunu işaretleyin.
3. Anahtarı **Gizli Anahtar** alanına yapıştırın. Gösterilen yöntemleri sınırlamak istiyorsanız **Ödeme Seçenekleri** alanını doldurun.
4. **Değişiklikleri Kaydet** butonuna tıklayın. Yöntem artık ödeme adımında görünür.

### Bildirim adresini kaydetme

1. Modül kartındaki **Callback URL** değerini kopyalayın.
2. Flutterwave panelinde **Settings → Webhooks** bölümünü açın, adresi webhook adresi olarak yapıştırın ve **Secret Hash** olarak istediğiniz bir değer girip kaydedin.
3. Aynı değeri modül kartındaki **Secret Hash** alanına yapıştırın ve **Değişiklikleri Kaydet** butonuna tıklayın.
4. Müşteri Flutterwave sayfasındayken tarayıcısını kapatsa bile ödenen faturalar artık sonuçlanır.

### Test ödemesi yapma

1. Müşteri olarak küçük tutarlı bir sipariş verin, **Flutterwave ile Öde** yöntemini seçin ve **Flutterwave ile Devam Et** butonuna tıklayın.
2. Ödeme sayfasında Flutterwave'in test kartını kullanın: `5531 8866 5214 2950`, son kullanma `09/32`, CVV `564`, PIN `3310`, OTP `12345`.
3. Müşteri sitenize döner, fatura ödendi olarak işaretlenir ve sipariş aktifleşir.
4. Anahtarı `FLWSECK-` olanla değiştirin, canlı hesapta da webhook kaydedin ve küçük tutarlı gerçek bir ödemeyle tekrarlayın.

### İade gönderme

1. Faturayı [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis) ekranından açın.
2. Durumunu iade edildi yapın, iade yöntemi olarak **Ödeme altyapısı ile iade** seçin ve onaylayın. Diğer iki seçenek yalnız kayıt tutar, Flutterwave'e bir şey göndermez.
3. Faturanın Flutterwave ödemesindeki payı müşteriye geri gider. Flutterwave iadeyi 3 ile 15 iş günü içinde tamamlar.

### Eski RavePay modülünden geçiş

1. Flutterwave'i aynı Flutterwave hesabının anahtarlarıyla yukarıdaki gibi yapılandırın.
2. **Ödeme Ağ Geçitleri** ekranında **RavePay (Eski v2)** modülünü kapatın. RavePay ile ödenmiş faturaların kayıtları korunur.
3. Müşteri ödeme adımında artık yalnız **Flutterwave ile Öde** yöntemini görür.

## Dikkat Edilecekler

> **Modu anahtarın öneki belirler**
> 
> `FLWSECK_TEST-` anahtarla yapılan ödeme, para hareketi olmadan faturayı ödendi olarak işaretler. Canlıya geçerken anahtarı ve webhook'u birlikte değiştirin.

> **Secret Hash olmadan webhook işlem yapmaz**
> 
> Doğrulanamayan bildirimler yok sayılır. Müşteri sitenize döndüğünde ödeme yine sonuçlanır; tarayıcıyı erken kapatan müşteriler için değeri doldurun.

> **Eksik tahsilat faturayı açık bırakır**
> 
> Flutterwave toplamdan azını tahsil ederse yalnız o tutar kaydedilir ve fatura ödenmemiş kalır. Farklı para birimindeki ödeme reddedilir. Elle sonuçlandırmadan önce işlemi Flutterwave panelinde kontrol edin.

## Gerekli Yetkiler

**Ödeme Modülü Ayarları** (`MODULES_PAYMENT_SETTINGS`) yetkisi gerekir.

## İlgili Makaleler

- [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [Modül Yönetimi](https://docs.wisecp.com/tr/modul-yonetimi)