# bKash Modülü

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

bKash'ı yapılandırarak cüzdan ödemelerini sağlayıcının sayfasında kabul edin ve ilgili faturaları WISECP'te takip edin.

## Ekrana Erişim

**Ayarlar → Finansal → Ödeme Ağ Geçitleri → Tüm Modüller** yolundan **bKash** kartına tıklayın: `{admin}/modules/payment?module=bKash`

## Ekranda Neler Var

Formda üye iş yeri bilgileri, sandbox seçeneği ve ortak ödeme ayarları bulunur. Müşteri cüzdan numarası, OTP ve PIN bilgilerini bKash sayfasında girer.

Bu modül tek seferlik ödeme sunar. Kayıtlı cüzdan anlaşması, kart saklama, otomatik ödeme, abonelik, taksit, ayrı capture ve otomatik iade yoktur. bKash'ın diğer ürünleri bu modüle aynı yetenekleri kazandırmaz.

## Başlamadan Önce

[bKash Online Business](https://www.bkash.com/en/business) üzerinden başvurun. Hesap yöneticinizin istediği üye iş yeri belgelerini ve sözleşmeyi tamamlayın. Checkout (URL based) erişimini ve ayrı sandbox/canlı entegrasyon bilgilerini isteyin.

HTTPS ve TLS 1.2 veya üzerini kullanın. Ödeme bKash'a BDT olarak ulaşmalı. Mevcut modül ortak dönüşüm ayarını uygulamadan ödeme tutarını ve para birimini gönderir; BDT fatura kullanın ve sandbox'ta alınan para birimini doğrulayın. Onaylı site adresini ve API sürümünü bKash ile doğrulayın. Bu formda özel API adresi alanı yoktur.

## Alanlar

- **Username**: Zorunlu; varsayılanı boş. Seçili ortam için bKash'ın verdiği entegrasyon kullanıcı adı.
- **Password**: Zorunlu; varsayılanı boş. Aynı hesabın API parolasıdır; müşterinin cüzdan PIN bilgisini girmeyin.
- **App Key**: Zorunlu; varsayılanı boş. Bu entegrasyon bilgileriyle verilen uygulama anahtarı.
- **App Secret**: Zorunlu; varsayılanı boş. Aynı App Key değerine ait uygulama gizli anahtarı.
- **Fee**: İsteğe bağlı; varsayılanı boş. Bu alan modülün ödeme tutarını değiştirmez. Ek ücret için ortak Komisyon Oranı (%) ayarını kullanın.
- **Sandbox**: Varsayılanı kapalı. Sandbox bilgileri için açın; canlı bilgilerle gerçek ödeme almak için kapatın.

**Durum** modülü etkinleştirir. Komisyon, dönüşüm, tutar 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 oluşturduğu adreslerdir.

## İşlemler

### Üye İş Yerini Yapılandırma

1. Username, Password, App Key ve App Secret değerlerini bKash entegrasyon ekibinden alın. Başvuru sürecinde verilen bu bilgileri WISECP formu oluşturamaz.
2. Ayrı bir test sisteminde sandbox bilgilerini bKash formuna girin. **Durum** ve **Sandbox** seçeneklerini açın.
3. **Değişiklikleri Kaydet** butonuna tıklayın. BDT test faturası hazırlayın; ortak dönüşüm ayarı bu modülün ödeme isteğini dönüştürmez.
4. **Ödeme Ağ Geçitleri → Başlangıç → Etkin Modül Seçimi** alanında bKash'ı seçip **Değişiklikleri Kaydet** butonuna tıklayın. Yöntem belirlediğiniz sınırlar içinde kullanılabilir olur.

### Ödeme Dönüşünü Kontrol Etme

Modül her ödeme oluşturulurken **Callback URL** adresini bKash'a gönderir. bKash onay aşamasında dönüş adresinizi isterse bu tam değeri WISECP'ten kopyalayın.

Ayrı webhook/IPN kaydı veya imza anahtarı alanı kullanılmaz. Tarayıcı dönüşü ödeme kimliğini getirir; WISECP bKash'tan ödemeyi tamamlamasını ister. Ödemenin tamamlanması başarılı yanıt ve **Completed** durumu gerektirir.

### Test Etme ve Canlıya Geçme

1. Ödenmemiş test faturasını ilgili müşteri olarak açın. bKash'ı seçip **Ödeme Yap** butonuna tıklayın.
2. bKash'ın verdiği sandbox cüzdan bilgilerini sağlayıcı sayfasında kullanın. Başarı, iptal ve kesilen dönüşü ayrı deneyin.
3. bKash işlem kimliğini, tutarı ve BDT para birimini WISECP faturası ve ödeme kaydıyla karşılaştırın. Ayarları kaydetmek bağlantı testi değildir.
4. Üye iş yeri onayı ve başarılı testlerden sonra dört bilgiyi canlı değerlerle değiştirin. **Sandbox** işaretini kaldırıp **Değişiklikleri Kaydet** butonuna tıklayın; sonraki ödemeler gerçek para kullanır.

### İadeyi Kaydetme

1. bKash üye iş yeriniz için onaylanan süreçten iadeyi başlatın. Yetkili kişiye asıl işlem kimliğini verin ve dönen tutarı doğrulayın.
2. Tamamlanmış tam iade için WISECP faturasını açın: `{admin}/invoices/detail?id={fatura}`.
3. **Özet → Durumu Değiştir** bölümünde **İade Edildi → Gider olarak ekle** seçip **Durumu Güncelle** butonuna tıklayın.
4. WISECP para göndermeden iadeyi kaydeder. Sağlayıcı referansını saklayın; kısmi iadeyi gerçek tutarıyla ayrıca takip edin.

## Dikkat Edilecekler

> **Önce Belirsiz Ödemeyi Açıklığa Kavuşturun**
> 
> Modül, yanıtsız Execute isteğinden sonra otomatik Query Payment sorgusu yapmaz. Kesilen dönüş faturayı ödenmemiş bırakabilir. Yeniden ödeme istemeden veya hizmeti açmadan önce işlemi bKash ile doğrulayın.

> **Tekrarlar Sağlayıcı Sınırlarına Takılabilir**
> 
> Mevcut modül ödeme oluştururken ve dönüşte yeni erişim anahtarı ister. bKash anahtar sınırı bildirirse ödemeyi tekrarlamayı durdurup entegrasyon ekibinizle görüşün. Hata sayfası paranın hareket etmediğini kanıtlamaz.

## Gerekli Yetkiler

Ayarlar **Modüller → Ödeme Altyapıları** (`MODULES_PAYMENT_SETTINGS`), fatura değişiklikleri **Faturalandırma → Düzenleme** (`INVOICES_OPERATION`) yetkisini gerektirir. bKash, üye iş yeri entegrasyonunu ve iade işlemini yapacak kişiyi ayrıca yetkilendirmelidir.

## İ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)
- [bKash Başvurusu ve Sandbox](https://developer.bka.sh/docs/product-overview)
- [bKash Ödeme Akışı ve Sonuç Sorgulama](https://developer.bka.sh/docs/checkout-url-process-overview)