PHPackages                             shahariar-ahmad/courier-fraud-checker-bd - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. shahariar-ahmad/courier-fraud-checker-bd

ActiveLibrary

shahariar-ahmad/courier-fraud-checker-bd
========================================

A fraud detection tool for e-commerce platforms to analyze customer order behavior across Steadfast and Pathao couriers.

v2.0.2(10mo ago)7267↓100%9[3 issues](https://github.com/ShahariarAhmad/ShahariarAhmad-CourierFraudCheckerBD---packagist.org/issues)GPL-3.0PHPPHP ^8.1

Since Apr 27Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/ShahariarAhmad/ShahariarAhmad-CourierFraudCheckerBD---packagist.org)[ Packagist](https://packagist.org/packages/shahariar-ahmad/courier-fraud-checker-bd)[ RSS](/packages/shahariar-ahmad-courier-fraud-checker-bd/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (8)Used By (0)

Courier Fraud Checker BD for Laravel
====================================

[](#courier-fraud-checker-bd-for-laravel)

A Laravel package to detect potential fraudulent orders by checking customer delivery behavior through Pathao and Steadfast courier services in Bangladesh.

---

✨ Features
----------

[](#-features)

- Check customer delivery history across multiple couriers
- Validate Bangladeshi phone numbers
- Get success/cancel/total delivery statistics
- Supports both Pathao and Steadfast courier services

---

⚙️ Installation
---------------

[](#️-installation)

### Install via Composer:

[](#install-via-composer)

```
composer require shahariar-ahmad/courier-fraud-checker-bd
```

### Add Service Provider (Laravel 5.4 and below)

[](#add-service-provider-laravel-54-and-below)

In `config/app.php`:

```
'providers' => [
    ShahariarAhmad\CourierFraudCheckerBd\CourierFraudCheckerBdServiceProvider::class,
],
```

### Add Facade Alias (optional)

[](#add-facade-alias-optional)

In `config/app.php`:

```
'aliases' => [
    'CourierFraudCheckerBd' => ShahariarAhmad\CourierFraudCheckerBd\Facade\CourierFraudCheckerBd::class,
],
```

---

🔧 Configuration
---------------

[](#-configuration)

Add these environment variables to your `.env` file:

```
# Pathao Credentials
PATHAO_USER=your_pathao_email
PATHAO_PASSWORD=your_pathao_password

# Steadfast Credentials
STEADFAST_USER=your_steadfast_email
STEADFAST_PASSWORD=your_steadfast_password
```

---

🚀 Usage
-------

[](#-usage)

### Basic Usage

[](#basic-usage)

```
use CourierFraudCheckerBd;

$result = CourierFraudCheckerBd::check('01886607475');

print_r($result);
```

**Output:**

```
[
    'pathao' => ['success' => 5, 'cancel' => 2, 'total' => 7],
    'steadfast' => ['success' => 3, 'cancel' => 1, 'total' => 4]
]
```

---

☎️ Phone Number Validation
--------------------------

[](#️-phone-number-validation)

The package automatically validates phone numbers with this regex:

```
/^01[3-9][0-9]{8}$/
```

✅ Valid examples:

- `01712345678`
- `01876543219`

❌ Invalid examples:

- `+8801712345678` (includes country code)
- `1234567890` (too short)
- `02171234567` (invalid prefix)

---

🛠️ Advanced Usage
-----------------

[](#️-advanced-usage)

### Using Individual Services

[](#using-individual-services)

```
use ShahariarAhmad\CourierFraudCheckerBd\Services\PathaoService;
use ShahariarAhmad\CourierFraudCheckerBd\Services\SteadfastService;

$pathao = (new PathaoService())->pathao('01712345678');
$steadfast = (new SteadfastService())->steadfast('01712345678');
```

### Custom Validation Rules

[](#custom-validation-rules)

```
use ShahariarAhmad\CourierFraudCheckerBd\Helpers\CourierFraudCheckerHelper;

CourierFraudCheckerHelper::validatePhoneNumber('01712345678');
```

---

🧹 Troubleshooting
-----------------

[](#-troubleshooting)

### Common Issues

[](#common-issues)

1. **Missing Environment Variables**

    - Ensure all required credentials are set in `.env`
    - Run `php artisan config:clear` after updating
2. **Invalid Phone Number Format**

    - Must use local (BD) format like `01712345678`
    - Do **not** include `+88` prefix

---

📝 License
---------

[](#-license)

This package is open-source software licensed under the [GNU General Public License v3.0 (GPL-3.0)](https://opensource.org/licenses/GPL-3.0).

Under this license:

✅ **You are allowed to:**

- Use the package for personal or commercial projects.
- Modify the source code for your own use.
- Distribute the modified or original source code **provided** you also license it under **GPL-3.0**.
- Study and learn from the source code freely.

❌ **You are NOT allowed to:**

- Re-license the package under a different license.
- Distribute the package as part of a proprietary/commercial closed-source software without making your source code public.
- Sub-license or sell the software under a restrictive license.

**Important:**
If you distribute modified versions of this package, you must also release your changes under the GPL-3.0 license and include the original copyright.

> GPL-3.0 promotes **freedom** to use, share, and modify, but ensures that any distributed version remains **free and open-source**.

---

💬 Support
---------

[](#-support)

For issues and feature requests:

- Email:

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance46

Moderate activity, may be stable

Popularity24

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~14 days

Total

6

Last Release

309d ago

Major Versions

v1.1.1 → v2.0.02025-06-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/4d8f18c27ea6497c4e6556919cf57aac44d4cf87a697a171b5814c2b2df08a53?d=identicon)[ShahariarAhmad](/maintainers/ShahariarAhmad)

---

Top Contributors

[![ShahariarAhmad](https://avatars.githubusercontent.com/u/71463303?v=4)](https://github.com/ShahariarAhmad "ShahariarAhmad (6 commits)")

---

Tags

laravel-packagee-commerceshippingdeliveryapi integrationcourierfraud detectionfraud preventionorder managementorder trackingOrder Statuscustomer behaviorfraud checkerpathaosteadfast courierorder cancellatione-commerce fraudorder verificationLaravel fraud checkerdelivery tracking

### Embed Badge

![Health badge](/badges/shahariar-ahmad-courier-fraud-checker-bd/health.svg)

```
[![Health](https://phpackages.com/badges/shahariar-ahmad-courier-fraud-checker-bd/health.svg)](https://phpackages.com/packages/shahariar-ahmad-courier-fraud-checker-bd)
```

###  Alternatives

[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

852.2k1](/packages/musahmusah-laravel-multipayment-gateways)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)