VakıfBank Sanal POS Modülü

Ön koşullar

• WHMCS 8.x/9.x desteklenen sürüm
• PHP 7.4+, cURL, JSON, mbstring ve OpenSSL
• Geçerli HTTPS alan adı
• Merchant ID
• Terminal/POS numarası
• POS parolası
• Üye işyeri tipi
• Banka uçlarına gerekli ağ erişimi (belgede 4443 portu belirtilmiştir)

Kurulum adımları

1. 1

   Yedek ve ön kontrol

   WHMCS dosyaları ile veritabanını yedekleyin; işlemi önce staging ortamında uygulayın.

2. 2

   Dosyaları yükleyin

   Paket dizin yapısını bozmadan şu hedeflere yükleyin: modules/gateways/vakifbankpos.php, modules/gateways/vakifbankpos/, modules/gateways/callback/vakifbankpos.php

3. 3

   İzinleri doğrulayın

   Klasörleri normalde 750/755, dosyaları 640/644 tutun; web sunucusu sahibini doğru ayarlayın ve 777 kullanmayın.

4. 4

   Bağımlılıkları kurun

   Paket vendor klasörü içermiyorsa, composer.json bulunan modül klasöründe üretim bağımlılıklarını kurun.

   Komut Kopyala

   composer install --no-dev --optimize-autoloader

5. 5

   Modülü etkinleştirin

   WHMCS > Sistem Ayarları > Ödeme Yöntemleri bölümünde modülü etkinleştirin; önce sağlayıcının test ortamını seçin.

6. 6

   İlk yapılandırmayı kaydedin

   Aşağıdaki modüle özel alanları doldurun; test tamamlanmadan canlı ortam/kimlik bilgilerine geçmeyin.

Yapılandırma

Testler

• Bankanın verdiği güncel test verisiyle başarı/ret akışlarını deneyin.
• 3D dönüş ve sunucu callback sonuçlarını birlikte doğrulayın.
• Canlıda bağlantı portu ve TLS erişimini sunucu üzerinden test edin.

Güvenlik

• Kart numarası, CVC, banka parolası ve gizli anahtarları WHMCS veya web sunucusu loglarına yazmayın.
• Canlıda yalnız 3D Secure ve bankanızın/onaylı sağlayıcınızın izin verdiği modeli kullanın.
• Sabit test kartı yayımlamayın; sağlayıcının güncel test dokümanını izleyin.

Sorun giderme