bKash Modülü

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 ü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

Durum modülü etkinleştirir. Komisyon, dönüşüm, tutar sınırları ve ülke listeleri Ödeme Modülleri 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

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
• Fatura Detayı Genel Görünüm
• bKash Başvurusu ve Sandbox
• bKash Ödeme Akışı ve Sonuç Sorgulama