Download the PHP package aiarmada/jnt without Composer
On this page you can find all versions of the php package aiarmada/jnt. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package jnt
Short Description J&T Express Malaysia API Integration Package
License MIT
Homepage https://github.com/aiarmada/commerce
Informations about the package jnt
J&T Express for Laravel
Laravel 12 integration for J&T Express Malaysia Open API – orders, tracking, waybills, and real-time webhooks.
Why this package?
- Complete API coverage – create orders, track parcels, print waybills, cancel orders, batch operations.
- Clean API naming – use
orderIdinstead oftxlogisticId,trackingNumberinstead ofbillCode. - Type-safe enums –
ExpressType::DOMESTICinstead of magic strings like'EZ'. - First-class Laravel DX – facades, fluent builders, data objects, events, Artisan commands.
- Production ready – PHP 8.4 / Laravel 12, PHPStan level 6, Pest test suite.
- Webhooks included – automatic signature verification and event dispatching.
Installation
Publish configuration and migrations:
Environment Variables
Note: When
JNT_ENVIRONMENT=testing, the package automatically uses J&T's official sandbox credentials. You only needJNT_CUSTOMER_CODEandJNT_PASSWORD.
Usage
Create an Order
Track a Parcel
Cancel an Order
Print Waybill
Enums
Type-safe enums prevent invalid values:
Webhooks
Receive real-time tracking updates from J&T.
Setup
-
Enable webhooks in
.env: -
Create a listener:
-
Register the listener:
- Configure J&T Dashboard with your webhook URL:
Artisan Commands
Documentation
- API Reference – Complete method reference
- Batch Operations – Process multiple orders efficiently
- Webhooks – Webhook integration guide
- Testing Credentials – Auto-configuration for sandbox
Property Name Mapping
The package translates clean names to J&T's API format automatically:
| Your Code | J&T API | Description |
|---|---|---|
orderId |
txlogisticId |
Your order reference |
trackingNumber |
billCode |
J&T tracking number |
state |
prov |
State/province |
quantity |
number |
Item quantity |
chargeableWeight |
packageChargeWeight |
Billable weight |
Testing
Contributing
- Fork & clone the repository
- Install dependencies:
composer install - Run tests:
vendor/bin/pest - Format code:
vendor/bin/pint
License
Released under the MIT License. See LICENSE for details.