Dolandırıcılık Modülü Yazma

// Bu noktada hiçbir şey kalıcılaştırılmamıştır: engellenen bir deneme geriye
// ne sipariş, ne fatura, ne de hizmet bırakır.
if ($fraudError = \FraudModule::run_checks($this->fraud_payload($pricing, $pmethod, (float) $taxCalc['total'], $member)))
    throw new \Exception($fraudError);

Acme.php        namespace WISECP\Modules\Fraud; class Acme extends FraudModule
config.php      ['meta' => [...], 'status' => false, 'settings' => []]
lang/en.php
lang/tr.php
logo.png

<?php
namespace WISECP\Modules\Fraud;

// Dosya bir ad alanı içindedir, yani her global sınıf import edilmeli ya da
// başına ters bölü konmalıdır. Nitelenmemiş bir ad bu ad alanının içine çözülür
// ve çalışma anında patlar; sözdizimi denetimi bunu yakalamaz.
use FraudModule;
use Language;
use User;
use UserManager;

class Acme extends FraudModule
{
    public function check($params = []): bool
    {
        return true;
    }
}

// Kapı. Ödeme akışı çağırır, bir modül asla çağırmaz.
public static function run_checks(array $params = []): string;   // '' = devam, aksi hâlde mesaj

// Kayıtlar
public function insert_record($user_id = 0, $message = '', $ip = '');
public function records($rCount = false, $filters = [], $orders = [], $start = 0, $end = -1);
public function record_table(): WISECP\Components\Table|string;

// Ayar ekranı, sizin için birleştirilir
public function page_settings(): string;
public function save_config($data = []): int|bool;

// Yönetici controller'ları, operation=module_controller&controller={name} ile erişilir
public function controller_records(): string;
public function controller_save_settings(): array;
public function controller_clear_records(): array;

// Public durum
public ?string $error;     // false döndüğünüzde müşterinin gördüğü mesaj
public ?array  $config;    // ['status' => bool, 'settings' => [...], 'meta' => [...]]
public ?array  $lang;
public ?array  $user;      // giriş yapmış üye, yapıcıda çözülür
public ?array  $admin;
public ?string $dir;
public string  $url;       // dikkat: komşularının aksine nullable değil
public ?string $area_link;

// ZORUNLU. true = geçir, false = engelle ($this->error ayarlanmış olarak).
public function check($params = []): bool;

// İSTEĞE BAĞLI
public function fields(): array;                              // ayar formu tanımlayıcıları
public function save_fields($fields = []): array;             // kalıcılaştırmadan önce doğrula
public function activate(): bool;                             // modülü açma
public function deactivate(): bool;                           // modülü kapatma
public function setConfigureTab(\WISECP\Components\Tab $obj): void;   // ek ayar sekmeleri

public function fields(): array
{
    $settings = $this->config['settings'] ?? [];

    return [
        'api-key' => [
            'wrap_width' => 100,
            'type'       => 'text',
            'name'       => $this->lang['api-key'] ?? 'API Key',
            'value'      => $settings['api-key'] ?? '',
        ],
        'risk-score' => [
            'wrap_width'  => 100,
            'width'       => 15,
            'type'        => 'number',
            'name'        => $this->lang['risk-score'] ?? 'Risk Score',
            'description' => $this->lang['risk-score-desc'] ?? '',
            'value'       => $settings['risk-score'] ?? '20',
        ],
        'block-country-mismatch' => [
            'wrap_width' => 100,
            'type'       => 'approval',      // bir anahtar: 'value', kutu işaretliyken gönderilen değerdir
            'name'       => $this->lang['country-mismatch'] ?? 'Block country mismatch',
            'value'      => 1,
            'checked'    => $settings['block-country-mismatch'] ?? false,
        ],
    ];
}

public function save_fields($fields = []): array
{
    // Burada reddetmek, modülün yarım yapılandırılmışken açılmayı geri çevirme yoludur.
    if (\Validation::isEmpty($fields['api-key'] ?? ''))
        return ['status' => "error", 'message' => $this->lang['error-is-empty'] ?? 'API key is required.'];

    return $fields;
}

public function check($params = []): bool
{
    $settings = $this->config['settings'] ?? [];
    $user     = (array) ($params['user_data'] ?? $this->user ?? []);
    $ip       = (string) ($user['ip'] ?? '');
    $uid      = (int) ($user['id'] ?? 0);          // misafir denemesinde 0

    // Her kural bağımsız olarak açılıp kapanır, yani değeri değil bayrağı okuyun.
    if ((int) ($settings['block-country-mismatch'] ?? 0) === 1) {
        $billing = strtoupper((string) ($user['address']['country_code'] ?? ''));
        $origin  = strtoupper((string) (UserManager::ip_info($ip)['countryCode'] ?? ''));

        // Yalnız KESİN bir uyuşmazlık engeller. Aksi hâlde çözülemeyen bir IP ya da
        // eksik bir fatura ülkesi, her yarım profili bir yanlış pozitife çevirirdi;
        // burada bir yanlış pozitif ise kaybedilmiş bir satıştır.
        if ($billing !== '' && $origin !== '' && $billing !== $origin) {
            // Bunun için çekirdekte bir dize var; WFraud da aynı anahtarı kullanır.
            $this->error = Language::gc("website/checkout/error-fraud-country");
            $this->insert_record($uid, "IP country ({$origin}) does not match billing country ({$billing})", $ip);

            return false;
        }
    }

    // Uzak bir puan. Buradaki hiçbir hata engellememeli: kapı fırlatılan bir
    // istisnayı geçiş sayar, bu erken dönüş de bozuk bir yanıt için aynısını yapar.
    $score = $this->remote_score($params);
    if ($score === null) return true;

    if ($score >= (int) ($settings['risk-score'] ?? 20)) {
        // Kendi ifadeniz SİZİN dil dosyanıza aittir. Language::gc(), çekirdekte
        // olmayan bir anahtar için false döner; bu da $error'ı boş bırakır ve
        // genel "güvenlik denetimlerimizden geçemedi" cümlesine düşülür.
        $this->error = $this->lang['error-risk-score'] ?? 'Your order could not be approved automatically.';
        $this->insert_record($uid, "Risk score {$score} reached the configured threshold", $ip);

        return false;
    }

    return true;
}

// coremio/classes/FraudModule.php, run_checks()
foreach ($modules as $name => $row) {
    if (!(bool) ($row['config']['status'] ?? false)) continue;      // etkin değil: atlanır

    try {
        $module = Modules::getInstance("Fraud", (string) $name);
        if (!$module || !method_exists($module, 'check')) continue;
        if ($module->check($params) !== false) continue;            // geçti: sonraki modül

        $message = trim((string) ($module->error ?? ''));

        return $message !== ''
            ? $message
            : Language::gc("website/checkout/error-fraud", ['{module}' => (string) $name]);
    }
    catch (\Throwable $e) {
        // Bir sağlayıcının çökmesi ödeme akışını da beraberinde çökertmemelidir.
        Logger::warning("Fraud module '{$name}' check failed: " . $e->getMessage());
    }
}

return '';   // etkin her modül geçti