Download the PHP package sabitahmad/laravel-steadfast without Composer

Laravel SteadFast Courier Package

Laravel integration for the SteadFast Courier API with typed DTOs for orders, tracking, returns, balance checks, optional bulk processing, bulk lifecycle events, caching, and database-backed request logging.

Features

• Create single and bulk orders
• Track shipments by consignment ID, invoice, or tracking code
• Create and fetch return requests
• Check account balance
• Fetch merchant payments and payment details with consignments
• Fetch delivery coverage zones / police stations with caching
• Typed request and response DTOs
• Queue-backed bulk processing
• Bulk lifecycle events
• Configurable caching for balance, status, and zone lookups
• Optional fraud checking through the SteadFast merchant panel
• Optional request logging and usage statistics
• Built-in artisan commands for testing, statistics, and cleanup

Installation

Add your credentials to .env:

Optional settings:

Verify the setup:

Usage

Create an Order

You can also use optional order fields when needed:

Use the Facade

Bulk Orders

Bulk responses include helper methods:

Track an Order

You can also track by invoice or consignment ID:

Return Requests

You can also create return requests by consignment ID or tracking code:

Balance

Payments

Fetch merchant payment / disbursement history or inspect an individual payment with all associated consignment orders:

Police Stations (Coverage Zones)

Retrieve the list of police stations / thanas supported by Steadfast Courier. This response is automatically cached to prevent unnecessary network requests:

Response Helpers

The DTOs expose helper methods so your application code stays clean:

Fraud Check

This feature logs into the SteadFast merchant panel and is slower than the normal API calls. Enable it only if you need it.

Accepted phone formats are normalized automatically, including 01712345678, 8801712345678, +8801712345678, and values with spaces or dashes.

Fraud responses also include helper methods:

Events

Bulk processing dispatches these events:

• SabitAhmad\SteadFast\Events\BulkOrderStarted
• SabitAhmad\SteadFast\Events\BulkOrderCompleted
• SabitAhmad\SteadFast\Events\BulkOrderFailed

Example listener registration:

Caching

Balance and status lookups can be cached:

Clear cached entries when needed:

Error Handling

Logging and Statistics

If logging is enabled, requests are stored in the steadfast_logs table.

Useful scopes on the SteadfastLog model:

Artisan Commands

Available commands:

What they do:

• steadfast:test: validates config and checks API connectivity
• steadfast:stats: shows request volume, success rate, bulk usage, and top endpoints
• steadfast:cleanup: removes old log records from steadfast_logs

API Coverage