PHPackages smart-dato/fedex-sdk - 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. smart-dato/fedex-sdk ActiveLibrary smart-dato/fedex-sdk ==================== This is my package fedex-sdk 0.0.5(5mo ago)0691↓32.2%1MITPHPPHP ^8.2 Since Nov 11Pushed 5mo ago2 watchersCompare [ Source](https://github.com/smart-dato/fedex-sdk)[ Packagist](https://packagist.org/packages/smart-dato/fedex-sdk)[ Docs](https://github.com/smart-dato/fedex-sdk)[ RSS](/packages/smart-dato-fedex-sdk/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (13)Versions (6)Used By (0) This is my package fedex-sdk ============================ [](#this-is-my-package-fedex-sdk) [![Latest Version on Packagist](https://camo.githubusercontent.com/0ad7ddc1f0f2f6d0556df513c0db34519ef2a0a9cbb3c0fb637f951aff987c5d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736d6172742d6461746f2f66656465782d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/smart-dato/fedex-sdk)[![GitHub Tests Action Status](https://camo.githubusercontent.com/02de2b245f30c7bd37d337c1ca6bfa57df60f0975b072881eaa3142cc74297f2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f736d6172742d6461746f2f66656465782d73646b2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/smart-dato/fedex-sdk/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/ba3f40f562aaf1ef85d48c5db5efb361190689a6232e471d2bf63d86b6407f8f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f736d6172742d6461746f2f66656465782d73646b2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/smart-dato/fedex-sdk/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/80028019f8e7ffab65fcd2c7c6c656e2eb424e2b0da809c5ece59d909a5c70e7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736d6172742d6461746f2f66656465782d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/smart-dato/fedex-sdk) A comprehensive Laravel package for integrating with the FedEx REST API. This package provides OAuth 2.0 authentication, automatic token management, shipment creation, tracking, and more. Built with modern PHP practices and Laravel conventions. Installation ------------ [](#installation) You can install the package via composer: ``` composer require smart-dato/fedex-sdk ``` Publish the configuration file: ``` php artisan vendor:publish --tag="fedex-config" ``` ### Environment Variables [](#environment-variables) Add the following variables to your `.env` file: ``` # FedEx Environment (sandbox or production) FEDEX_ENVIRONMENT=sandbox # FedEx OAuth Credentials FEDEX_CLIENT_ID=your-client-id FEDEX_CLIENT_SECRET=your-client-secret # FedEx Account Number FEDEX_ACCOUNT_NUMBER=your-account-number # Optional: Label Response Options (URL_ONLY or LABEL) FEDEX_LABEL_RESPONSE_OPTIONS=URL_ONLY # Optional: Token Cache TTL in seconds (default: 3500) FEDEX_TOKEN_CACHE_TTL=3500 ``` ### Getting FedEx API Credentials [](#getting-fedex-api-credentials) 1. Go to [FedEx Developer Portal](https://developer.fedex.com/) 2. Create an account or sign in 3. Create a new project 4. Generate API credentials (Client ID and Client Secret) 5. Use sandbox credentials for testing and production credentials for live operations Usage ----- [](#usage) ### OAuth Authentication [](#oauth-authentication) The package handles OAuth authentication automatically. Tokens are cached to minimize API calls and automatically refreshed when needed. ``` use SmartDato\FedEx\Fedex; class ShippingController extends Controller { public function __construct(private Fedex $fedex) { } public function createShipment() { // The OAuth token is automatically managed $result = $this->fedex->createShipment($shipmentPayload); } } ``` #### Manual Token Management [](#manual-token-management) If you need to manually manage tokens: ``` use SmartDato\FedEx\Fedex; public function __construct(private Fedex $fedex) { } // Force refresh the OAuth token $newToken = $this->fedex->refreshToken(); // Get the OAuth client directly $oauthClient = $this->fedex->getOAuthClient(); // Get current access token $token = $oauthClient->getAccessToken(); // Clear cached token $oauthClient->clearToken(); ``` ### Creating a Shipment [](#creating-a-shipment) ``` use SmartDato\FedEx\Fedex; use SmartDato\FedEx\Payloads\ShipmentPayload; use SmartDato\FedEx\Payloads\ShipperPayload; use SmartDato\FedEx\Payloads\RecipientPayload; use SmartDato\FedEx\Payloads\AddressPayload; use SmartDato\FedEx\Payloads\ContactPayload; use SmartDato\FedEx\Payloads\RequestedPackageLineItemPayload; use SmartDato\FedEx\Payloads\WeightPayload; use SmartDato\FedEx\Enums\WeightUnitEnum; use SmartDato\FedEx\Enums\PackagingTypeEnum; use SmartDato\FedEx\Enums\PickupTypeEnum; $shipment = ShipmentPayload::make() ->setShipper( ShipperPayload::make() ->setContact( ContactPayload::make() ->setPersonName('John Doe') ->setPhoneNumber('1234567890') ) ->setAddress( AddressPayload::make() ->setStreetLines(['123 Main St']) ->setCity('Memphis') ->setStateOrProvinceCode('TN') ->setPostalCode('38115') ->setCountryCode('US') ) ) ->setRecipient( RecipientPayload::make() ->setContact( ContactPayload::make() ->setPersonName('Jane Smith') ->setPhoneNumber('0987654321') ) ->setAddress( AddressPayload::make() ->setStreetLines(['456 Oak Ave']) ->setCity('Los Angeles') ->setStateOrProvinceCode('CA') ->setPostalCode('90001') ->setCountryCode('US') ) ) ->setRequestedPackageLineItems([ RequestedPackageLineItemPayload::make() ->setWeight( WeightPayload::make() ->setValue(10.0) ->setUnits(WeightUnitEnum::LB) ) ]) ->setPickupType(PickupTypeEnum::DROPOFF_AT_FEDEX_LOCATION) ->setPackagingType(PackagingTypeEnum::YOUR_PACKAGING); // Inject or resolve the Fedex service $fedex = app(Fedex::class); $response = $fedex->createShipment($shipment); ``` ### Tracking a Shipment [](#tracking-a-shipment) ``` use SmartDato\FedEx\Fedex; use SmartDato\FedEx\Enums\TrackBy; // Inject or resolve the Fedex service $fedex = app(Fedex::class); // Track by tracking number (default) $tracking = $fedex->trackShipment('123456789012'); // Track by tracking number with detailed scans $tracking = $fedex->trackShipment('123456789012', TrackBy::TRACKING_NUMBER, [ 'includeDetailedScans' => true, ]); // Track by TCN (Tracking Control Number) $tracking = $fedex->trackShipment('123456789012', TrackBy::TCN); // Track by reference number with ship date range $tracking = $fedex->trackShipment('REFERENCE123', TrackBy::REFERENCE_NUMBER, [ 'shipDateBegin' => '2024-01-01', 'shipDateEnd' => '2024-01-31', 'includeDetailedScans' => true, ]); // Track multiple shipments at once $tracking = $fedex->trackMultipleShipments([ '123456789012', '123456789013', '123456789014', ], [ 'includeDetailedScans' => true, ]); ``` ### OAuth Token Caching [](#oauth-token-caching) The package automatically caches OAuth tokens using Laravel's cache system. By default: - Tokens are cached for 3500 seconds (just under 1 hour) - Cache key is `fedex_oauth_token` - Tokens are automatically refreshed when expired You can customize these settings in the config file or via environment variables. ### Error Handling [](#error-handling) ``` use SmartDato\FedEx\Fedex; use Illuminate\Http\Client\ConnectionException; use RuntimeException; $fedex = app(Fedex::class); try { $result = $fedex->createShipment($shipmentPayload); } catch (ConnectionException $e) { // Handle connection errors Log::error('FedEx API connection error: ' . $e->getMessage()); } catch (RuntimeException $e) { // Handle OAuth or other runtime errors Log::error('FedEx API error: ' . $e->getMessage()); } ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [smart-dato](https://github.com/smart-dato) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 38 — LowBetter than 84% of packages Maintenance74 Regular maintenance activity Popularity19 Limited adoption so far Community9 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure 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 ~0 days Total 5 Last Release 178d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c3006db55caec62526937fa2d941da32fc5e69e2ca86a52e87c8046da5958d82?d=identicon)[smart-dato](/maintainers/smart-dato) --- Top Contributors [![tschigo](https://avatars.githubusercontent.com/u/344100?v=4)](https://github.com/tschigo "tschigo (7 commits)") --- Tags laravelsmart-datofedex-sdk ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/smart-dato-fedex-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/smart-dato-fedex-sdk/health.svg)](https://phpackages.com/packages/smart-dato-fedex-sdk) ``` ### Alternatives [vormkracht10/laravel-mails Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app. 24149.7k](/packages/vormkracht10-laravel-mails)[spatie/laravel-prometheus Export Laravel metrics to Prometheus 2651.3M6](/packages/spatie-laravel-prometheus)[hydrat/filament-table-layout-toggle Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts. 6292.3k1](/packages/hydrat-filament-table-layout-toggle)[scalar/laravel Render your OpenAPI-based API reference 6183.9k2](/packages/scalar-laravel)[ralphjsmit/laravel-helpers A package containing handy helpers for your Laravel-application. 13704.6k2](/packages/ralphjsmit-laravel-helpers)[musahmusah/laravel-multipayment-gateways A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless 852.2k1](/packages/musahmusah-laravel-multipayment-gateways) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)