README

Order fraud screening for Bagisto 2.4.x. Checks a customer's phone number against BD Courier delivery history and surfaces a success/return ratio in the admin order view — useful for vetting risky cash-on-delivery orders.

Requirements

• Bagisto ^2.4
• PHP ^8.3
• A BD Courier API key

Installation

1. Require the package

From Packagist (public):

composer require kbtonmoy/fraud-checker-for-bagisto

From the Git repo (reuse across your own projects): add the repository to your project's root composer.json, then require it:

"repositories": [
    { "type": "vcs", "url": "https://github.com/kbtonmoy/fraud-checker-for-bagisto.git" }
]

composer require kbtonmoy/fraud-checker-for-bagisto:^1.0

From a local path (monorepo / same machine): with Bagisto's default packages/*/* path repository in place, drop the folder into packages/Webkul/FraudChecker/ and run:

composer require kbtonmoy/fraud-checker-for-bagisto:@dev

The main service provider is auto-discovered — no need to edit bootstrap/providers.php.

2. Register the Concord module

Concord model registration is not auto-discovered. Add this one line to the modules array in your project's config/concord.php:

'modules' => [
    // ...
    Webkul\FraudChecker\Providers\ModuleServiceProvider::class,
],

3. Migrate and clear caches

php artisan migrate            # creates the fraud_checks table
php artisan optimize:clear

The fraud check runs on a queued job (CheckOrderFraud), so make sure a queue worker is running (php artisan queue:work) if you use a non-sync queue driver.

Configuration

In the admin panel go to Configure → Sales → Fraud Checker and set:

Usage

With Auto check on, each new order is screened automatically and the result appears in a panel on the admin order view. You can also trigger a re-check manually from that panel.

License

MIT © Khabirul Basar