PHPackages aiarmada/jnt - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. aiarmada/jnt ActiveLibrary[API Development](/categories/api) aiarmada/jnt ============ J&T Express Malaysia API Integration Package v1.4.7(6mo ago)01002MITPHPPHP ^8.4 Since Nov 6Pushed 1mo agoCompare [ Source](https://github.com/AIArmada/jnt)[ Packagist](https://packagist.org/packages/aiarmada/jnt)[ Docs](https://github.com/aiarmada/commerce)[ RSS](/packages/aiarmada-jnt/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (1)Versions (34)Used By (2) J&T Express for Laravel =========================== [](#jt-express-for-laravel) > Laravel 12 integration for [J&T Express Malaysia](https://www.jtexpress.my/) Open API – orders, tracking, waybills, and real-time webhooks. Why this package? ----------------- [](#why-this-package) - **Complete API coverage** – create orders, track parcels, print waybills, cancel orders, batch operations. - **Clean API naming** – use `orderId` instead of `txlogisticId`, `trackingNumber` instead of `billCode`. - **Type-safe enums** – `ExpressType::DOMESTIC` instead 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 ------------ [](#installation) ``` composer require aiarmada/jnt ``` Publish configuration and migrations: ``` php artisan vendor:publish --tag="jnt-config" php artisan vendor:publish --tag="jnt-migrations" php artisan migrate ``` ### Environment Variables [](#environment-variables) ``` JNT_ENVIRONMENT=testing # or 'production' JNT_CUSTOMER_CODE=your_customer_code JNT_PASSWORD=your_password # Production only (testing uses J&T's public sandbox credentials): JNT_API_ACCOUNT=your_api_account JNT_PRIVATE_KEY=your_private_key # Optional JNT_LOGGING_ENABLED=true JNT_WEBHOOKS_ENABLED=true ``` > **Note:** When `JNT_ENVIRONMENT=testing`, the package automatically uses J&T's official sandbox credentials. You only need `JNT_CUSTOMER_CODE` and `JNT_PASSWORD`. --- Usage ----- [](#usage) ### Create an Order [](#create-an-order) ``` use AIArmada\Jnt\Facades\JntExpress; use AIArmada\Jnt\Data\{AddressData, ItemData, PackageInfoData}; use AIArmada\Jnt\Enums\{ExpressType, ServiceType, PaymentType, GoodsType}; $sender = new AddressData( name: 'John Sender', phone: '60123456789', address: 'No 32, Jalan Kempas 4', postCode: '81930', countryCode: 'MYS', state: 'Johor', city: 'Johor Bahru', ); $receiver = new AddressData( name: 'Jane Receiver', phone: '60987654321', address: '4678, Laluan Sentang 35', postCode: '31000', countryCode: 'MYS', state: 'Perak', city: 'Batu Gajah', ); $item = new ItemData( itemName: 'Basketball', quantity: 2, weight: 10, unitPrice: 50.00, ); $packageInfo = new PackageInfoData( quantity: 1, weight: 10, declaredValue: 50, goodsType: GoodsType::PACKAGE, ); $order = JntExpress::createOrderBuilder() ->orderId('ORDER-' . time()) ->expressType(ExpressType::DOMESTIC) ->serviceType(ServiceType::DOOR_TO_DOOR) ->paymentType(PaymentType::PREPAID_POSTPAID) ->sender($sender) ->receiver($receiver) ->addItem($item) ->packageInfo($packageInfo) ->build(); $result = JntExpress::createOrderFromArray($order); echo "Tracking: " . $result->trackingNumber; ``` ### Track a Parcel [](#track-a-parcel) ``` // By your order ID $tracking = JntExpress::trackParcel(orderId: 'ORDER-123'); // Or by J&T tracking number $tracking = JntExpress::trackParcel(trackingNumber: 'JT630002864925'); foreach ($tracking->details as $detail) { echo "{$detail->scanTime}: {$detail->description}\n"; } ``` ### Cancel an Order [](#cancel-an-order) ``` JntExpress::cancelOrder( orderId: 'ORDER-123', reason: 'Customer requested cancellation', trackingNumber: 'JT630002864925', ); ``` ### Print Waybill [](#print-waybill) ``` $label = JntExpress::printOrder( orderId: 'ORDER-123', trackingNumber: 'JT630002864925', ); $pdfUrl = $label['urlContent']; ``` --- Enums ----- [](#enums) Type-safe enums prevent invalid values: ``` // Express Type ExpressType::DOMESTIC // Standard delivery ExpressType::NEXT_DAY // Express next day ExpressType::FRESH // Cold chain delivery // Service Type ServiceType::DOOR_TO_DOOR // Pickup from sender ServiceType::WALK_IN // Drop-off at counter // Payment Type PaymentType::PREPAID_POSTPAID // Prepaid by merchant PaymentType::COLLECT_CASH // Cash on delivery // Goods Type GoodsType::DOCUMENT // Documents GoodsType::PACKAGE // Parcels ``` --- Webhooks -------- [](#webhooks) Receive real-time tracking updates from J&T. ### Setup [](#setup) 1. **Enable webhooks** in `.env`: ``` JNT_WEBHOOKS_ENABLED=true ``` 2. **Create a listener**: ``` namespace App\Listeners; use AIArmada\Jnt\Events\TrackingStatusReceived; class UpdateOrderTracking { public function handle(TrackingStatusReceived $event): void { $order = Order::where('tracking_number', $event->trackingNumber)->first(); $order?->update([ 'tracking_status' => $event->lastStatus, 'tracking_time' => $event->scanTime, ]); } } ``` 3. **Register the listener**: ``` // EventServiceProvider.php protected $listen = [ \AIArmada\Jnt\Events\TrackingStatusReceived::class => [ \App\Listeners\UpdateOrderTracking::class, ], ]; ``` 4. **Configure J&T Dashboard** with your webhook URL: ``` https://yourdomain.com/webhooks/jnt/status ``` --- Artisan Commands ---------------- [](#artisan-commands) ``` # Check configuration php artisan jnt:config:check # Health check php artisan jnt:health # Track parcel php artisan jnt:order:track --order-id=ORDER-123 # Cancel order php artisan jnt:order:cancel --order-id=ORDER-123 --reason="Out of stock" # Print waybill php artisan jnt:order:print --order-id=ORDER-123 --tracking-number=JT123456 ``` --- Documentation ------------- [](#documentation) - [API Reference](docs/api-reference.md) – Complete method reference - [Batch Operations](docs/batch-operations.md) – Process multiple orders efficiently - [Webhooks](docs/webhooks.md) – Webhook integration guide - [Testing Credentials](docs/testing-credentials.md) – Auto-configuration for sandbox --- Property Name Mapping --------------------- [](#property-name-mapping) The package translates clean names to J&T's API format automatically: Your CodeJ&T APIDescription`orderId``txlogisticId`Your order reference`trackingNumber``billCode`J&T tracking number`state``prov`State/province`quantity``number`Item quantity`chargeableWeight``packageChargeWeight`Billable weight--- Testing ------- [](#testing) ``` vendor/bin/pest tests/src/Jnt ``` --- Contributing ------------ [](#contributing) 1. Fork & clone the repository 2. Install dependencies: `composer install` 3. Run tests: `vendor/bin/pest` 4. Format code: `vendor/bin/pint` --- License ------- [](#license) Released under the MIT License. See [LICENSE](LICENSE) for details. ### Health Score 43 — FairBetter than 91% of packages Maintenance80 Actively maintained with recent releases Popularity9 Limited adoption so far Community6 Small or concentrated contributor base Maturity64 Established project with proven stability How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~4 days Recently: every ~33 days Total 33 Last Release 61d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/726da4efcb731bc0ebcdd0b7ce64759e1f8dd63f6f771eab335458f6a2f2d3af?d=identicon)[sairiz](/maintainers/sairiz) ### Embed Badge ![Health badge](/badges/aiarmada-jnt/health.svg) ``` [![Health](https://phpackages.com/badges/aiarmada-jnt/health.svg)](https://phpackages.com/packages/aiarmada-jnt) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk PHP SDK for Facebook Business 90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 265103.1M454](/packages/google-gax)[google/common-protos Google API Common Protos for PHP 173103.7M50](/packages/google-common-protos) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)