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

📌 Introduction

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

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, RedX, Paperfly, and Carrybee.
• 📊 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).
• 📝 Automated Error Logging: Exceptions from any courier service are automatically logged into Laravel's default log file without breaking the main flow.
• 🏗️ SOLID Architecture: Highly decoupled under the hood. You can easily interact with individual couriers thanks to strict contract implementations.
• ⚡ Developer Friendly: Simple Facade access and effortless Laravel integration.

💻 Requirements

• PHP: ^8.2.0
• Laravel: 8.x, 9.x, 10.x, 11.x, 12.x, or 13.x
• Guzzle: ^7.8

📦 Installation

1. Install via Composer:

2. 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.)

🧩 Environment Setup

To authenticate with the respective courier APIs, strictly add your credentials to your application's .env file:

🚀 Quick Start

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

🖥️ API Response GUI

📈 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: 01*********, 01876543219
• ❌ Invalid: +8801*********, 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 of Steadfast, Pathao.

‍💻 Created By

Abiruzzaman Molla

• 📧 Email: [email protected]
• 🐙 GitHub Profile: @AbiruzzamanMolla
• 📦 Repository: Fraud-Checker-BD-Courier-Laravel

If you find this package helpful in fighting fraudulent orders, please consider starring the repository! ⭐ I hate arguing. If you have something to contribute or improve, please fork the repository, make your edits, and then submit a pull request.