kbtonmoy / steadfast-for-bagisto
Steadfast (Packzy) courier shipping integration for Bagisto — create shipments, track status, and receive delivery webhooks from the order view.
Requires
- php: ^8.3
- sabitahmad/laravel-steadfast: ^2.2
README
Steadfast (Packzy) courier integration for Bagisto 2.4.x. Create shipments straight from the order view, sync delivery status, and receive status updates via webhook.
Requirements
- Bagisto
^2.4 - PHP
^8.3 - A Steadfast merchant account (API key + secret key)
Installation
1. Require the package
From Packagist (public):
composer require kbtonmoy/steadfast-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/steadfast-for-bagisto.git" } ]
composer require kbtonmoy/steadfast-for-bagisto:^1.0
From a local path (monorepo / same machine): ensure your root composer.json has the Bagisto
default path repository (it does out of the box):
"repositories": [ { "type": "path", "url": "packages/*/*", "options": { "symlink": true } } ]
Drop the package folder into packages/Webkul/Steadfast/ and run:
composer require kbtonmoy/steadfast-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\Steadfast\Providers\ModuleServiceProvider::class, ],
3. Migrate and clear caches
php artisan migrate # creates the steadfast_shipments table
php artisan optimize:clear
Configuration
In the admin panel go to Configure → Sales → Steadfast and set:
| Setting | Config key | Notes |
|---|---|---|
| Enabled | sales.steadfast.settings.enabled |
Master on/off switch |
| API Key | sales.steadfast.settings.api_key |
From your Steadfast merchant portal |
| Secret Key | sales.steadfast.settings.secret_key |
From your Steadfast merchant portal |
| Base URL | sales.steadfast.settings.base_url |
Defaults to https://portal.packzy.com/api/v1 |
| Default delivery type | sales.steadfast.settings.default_delivery_type |
Webhook
Point your Steadfast delivery-status webhook at:
POST https://your-store.test/steadfast/webhook/{token}
The {token} is shown on the Steadfast configuration screen in the admin panel.
Usage
Open any order in the admin panel — a Steadfast panel appears in the order view with actions to create a consignment and refresh its delivery status.
License
MIT © Khabirul Basar