Download the PHP package azmolla/fraud-checker-bd-courier without Composer

📌 Introduction

E-commerce businesses in Bangladesh often face significant losses due to fraudulent orders and high return rates. Fraud Checker BD Courier protects your bottom line by instantly analyzing a customer's track record across major logistics providers (Steadfast, Pathao, and RedX).

By checking a simple phone number, you get immediate insights into a customer's success and cancellation ratios, helping you decide whether to approve, verify, or reject cash-on-delivery (COD) shipments.

🎯 Key Capabilities

• 🔍 Multi-Courier Analytics: Fetch delivery histories simultaneously from Steadfast, Pathao, and RedX.
• 📊 Aggregated Statistics: Get a unified view of total deliveries, successes, cancellations, and percentages.
• 📱 Smart Number Validation: Built-in strictly enforced validation for standard Bangladeshi mobile numbers (e.g., 017XXXXXXXX).
• 🏗️ Framework-Agnostic Core: Completely decoupled from Laravel. Use it in any native PHP, Symfony, or CodeIgniter project.
• ⚡ Laravel Friendly: Simple Facade access and effortless Laravel auto-discovery integration are still included!

💻 Requirements

• PHP: ^8.2.0
• Guzzle: ^7.8

📦 Installation

1. Install via Composer:

2. Laravel Users - Publish Configuration File:

(This will create a config/fraud-checker-bd-courier.php file in your application directory.)

(Note: Laravel Auto-Discovery is fully supported. If you are using Laravel 5.4 or older, you will need to manually register the Service Provider and Facade in config/app.php.)

🧩 Setup & Usage

Usage in Laravel

Add credentials to your .env file just like before:

Checking a customer's fraud probability is a one-liner using the provided Facade.

Usage in Pure PHP (or Non-Laravel Frameworks)

Since Version 1.2.0, this package is completely decoupled from Laravel. You can instantiate it using the FraudCheckerConfig class:

📈 Structural Response Example

The package returns a highly structured array indicating individual and aggregated network metrics:

🛠️ Advanced Usage (SOLID Design)

For granular control, the package is architected using SOLID principles. Every courier class adheres to Azmolla\FraudCheckerBdCourier\Contracts\CourierServiceInterface, guaranteeing a uniform getDeliveryStats(string $phoneNumber): array signature.

Instantiating Individual Services

If you only need to run analytics against a single courier, avoid the Facade overhead and use the specific service classes directly:

📱 Phone Validation Helper

Numbers are strictly validated against ^01[3-9][0-9]{8}$ to prevent unnecessary API failures.

• ✅ Valid: 01712345678, 01876543219
• ❌ Invalid: +8801712345678, 1234567890, 02171234567

You can manually trigger this validation check:

🧪 Testing

The package includes an extensive test suite built with orchestra/testbench and phpunit. API calls are safely mocked, meaning you do not need live .env credentials to confidently run tests locally.

🙏 Acknowledgments

Special thanks to S. Ahmad for the initial inspiration and discovering the API endpoints.

‍💻 Created By

Abiruzzaman Molla

• 📧 Email: [email protected]
• 🐙 GitHub: @AbiruzzamanMolla

☕ Support Me

If you find this project useful, you can buy me a coffee!