fraudhunter/laravel-sdk

FraudHunter SDK for Laravel applications

dev-main 2026-04-27 04:19 UTC

Requires

• php: >=5.6.0
• guzzlehttp/guzzle: ^6.0|^7.0
• illuminate/support: ^5.0|^6.0|^7.0|^8.0|^9.0|^10.0|^11.0

MIT

• FraudHunter Team

• detection
• fraud
• fraudhunter

README

Integrasikan aplikasi Laravel Anda dengan sistem deteksi fraud FraudHunter secara mudah menggunakan Event Listeners.

Fitur

• Otomatis: Melacak Login, Logout, dan Reset Password tanpa kode tambahan.
• Fleksibel: Kirim transaksi kustom untuk analisis risiko mendalam.
• Kompetibel: Mendukung Laravel 5.0 sampai 11.0+.
• Synchronous: Pengiriman data dilakukan secara real-time.

Instalasi

1. Tambahkan package via composer:

composer require fraudhunter/laravel-sdk

1. Tambahkan Service Provider (untuk Laravel < 5.5):

// config/app.php
'providers' => [
    // ...
    FraudHunter\Laravel\FraudHunterServiceProvider::class,
],

1. Publish konfigurasi:

php artisan vendor:publish --provider="FraudHunter\Laravel\FraudHunterServiceProvider"

1. Tambahkan environment variables di file .env:

FRAUDHUNTER_API_URL=http://your-fraudhunter-server:8080
FRAUDHUNTER_API_KEY=fh_live_xxxxxxxxxxxx
FRAUDHUNTER_SERVICE=WL

Penggunaan

1. Pelacakan Otomatis

Secara default, SDK ini mendengarkan event berikut:

• Illuminate\Auth\Events\Login
• Illuminate\Auth\Events\Logout
• Illuminate\Auth\Events\PasswordReset

Anda bisa menyesuaikan mapping ini di file config/fraudhunter.php.

2. Analisis Transaksi Manual

Anda bisa memanggil FraudHunterClient untuk menganalisis transaksi sebelum diproses:

use FraudHunter\Laravel\FraudHunterClient;

public function processPayment(FraudHunterClient $fraudHunter)
{
    $result = $fraudHunter->analyzeTransaction([
        'account_id'    => 'ACC001',
        'amount'        => 5000000,
        'currency'      => 'IDR',
        'type'          => 'PAYMENT',
        'ip_address'    => request()->ip(),
        'device_id'     => 'DEV-123',
    ]);

    if ($result['recommended_action'] === 'REJECT') {
        return response()->json(['error' => 'Transaksi ditolak oleh sistem keamanan'], 403);
    }

    // Lanjutkan proses pembayaran...
}

3. Log Aktivitas Kustom

$fraudHunter->logActivity([
    'account_id'    => 'ACC001',
    'activity_type' => 'UPDATE_PROFILE',
    'status'        => 'SUCCESS',
]);

Lisensi

MIT