Ana içeriğe geç
Pazartesi - Cuma: 09:00 - 18:00
Ödeme Modülleri

Akbank Sanal POS Modülü

Akbank Sanal POS üzerinden 3D Secure kart ödemelerini WHMCS faturalarına bağlar.

5 dk Güncelleme: 29 Temmuz 2026 v1.0.0 WHMCS 8.x / 9.x

Ö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ı
  • MerchantSafeID
  • TerminalSafeID
  • Secret Key

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/akbankpos.php, modules/gateways/akbankpos/, modules/gateways/callback/akbankpos.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
    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

Banka/sağlayıcı ayarları

3D Secure modelini ve banka hesabınızın desteklediği para birimi/taksitleri seçin.

Testler

  • Bankanın güncel test verileriyle başarılı ve başarısız ödeme deneyin.
  • Callback sonrası faturanın yalnız bir kez ödendiğini doğrulayın.
  • Canlıya geçmeden debug ve test modunu kapatın.

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

Ödeme dönüyor ancak fatura ödenmiyor

Callback URL'sinin HTTPS, POST erişimi, WAF kuralı, imza doğrulaması, tutar ve para birimini kontrol edin.

Mükerrer ödeme

Sağlayıcı işlem kimliği için benzersizlik ve callback idempotency kaydını kontrol edin.