PHPackages                             rat.md/laravel-ebay-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. [HTTP &amp; Networking](/categories/http)
4. /
5. rat.md/laravel-ebay-sdk

ActiveLibrary[HTTP &amp; Networking](/categories/http)

rat.md/laravel-ebay-sdk
=======================

A Laravel eBay SDK for integrating with all eBay APIs, featuring OAuth authentication, webhook notifications, event handling, and practical utilities for common workflows.

0.2.2(1mo ago)11MITPHPPHP ^8.2

Since Jan 8Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/RatMD/laravel-ebay-sdk)[ Packagist](https://packagist.org/packages/rat.md/laravel-ebay-sdk)[ Docs](https://ebay-sdk.rat.md)[ RSS](/packages/ratmd-laravel-ebay-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (16)Versions (13)Used By (0)

 [![Laravel Logo](https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg)](https://laravel.com)

 [Laravel](https://laravel.com) is an accessible and powerful [PHP](http://php.net) web application framework with an expressive and elegant syntax.

---

eBay SDK for Laravel
====================

[](#ebay-sdk-for-laravel)

Caution

This is an **work-in-progress** eBay SDK in an alpha stage. Not all APIs have been fully tested or can be tested due to user, marketplace, country restrictions, or sandbox limitations. While the SDK should be usable, breaking changes may occur at any time, including minor releases.

A Laravel SDK for integrating with eBay APIs, featuring OAuth authentication, webhook notifications, event handling, and practical utilities for common workflows. The SDK supports both Modern REST APIs and Traditional (XML/SOAP) eBay APIs and is designed to evolve alongside eBay’s platform.

- [Documentation Page](https://ebay-sdk.rat.md)
- [OAuth Authorize with eBay](https://ebay-sdk.rat.md/guide/authorize.html)
- [Receive eBay Platform Notifications](https://ebay-sdk.rat.md/guide/webhook.html)
- [Handle Marketplace Account Deletions](https://ebay-sdk.rat.md/guide/marketplace.html)

Features
--------

[](#features)

- OAuth 2.0 authentication flow (authorization and callback).
- Support for Platform Notifications and Marketplace Account Deletions.
- Optional route and controller integration for OAuth, Marketplace and Webhooks.
- Support for Modern REST APIs and Traditional XML/SOAP APIs (XML-only).
- Dispatches Laravel events for all supported eBay notification types.

Requirements
------------

[](#requirements)

- PHP ≥ 8.2
- Laravel ≥ 11 | ≥ 12 | ≥ 13

Tip

We strongly recommend a task-scheduling enabled and queue-based Laravel setup to handle performance-intensive processes and, most importantly, to process eBay webhook notifications in a compliant and reliable manner (See [Configuration](https://ebay-sdk.rat.md/guide/configuration#webhook-configuration)).

Installation
------------

[](#installation)

Install the package via composer:

```
composer require rat.md/laravel-ebay-sdk
```

Publish the configuration file with:

```
php artisan vendor:publish --tag="ebay-sdk-config"
```

Basic Usage
-----------

[](#basic-usage)

[Visit the Documentation Page for more details](https://ebay-sdk.rat.md/guide/start.html#basic-usage)

```
use Rat\eBaySDK\API\InventoryAPI\InventoryItem\GetInventoryItem;
use Rat\eBaySDK\Client;

$client = new Client();
$client->setRefreshToken($refreshToken);
$response = $client->execute(new GetInventoryItem('MyCustomSKU'));
```

Testing
-------

[](#testing)

To run the test suite, you first need to provide your eBay Sandbox credentials. So, create an `.env.testing` file in the package root directory with the following details:

```
EBAY_CLIENT_ID=''
EBAY_CLIENT_SECRET=''
EBAY_REDIRECT_URI=''
EBAY_DEV_ID=''
EBAY_API_ENVIRONMENT='sandbox'

EBAY_CACHING=false
EBAY_DEBUG=true
EBAY_LOCALE=''

EBAY_COMPATIBILITY_LEVEL=1395
EBAY_SITE_ID=16
```

If you're unsure about your `EBAY_SITE_ID` refer to [src/Enums/SiteCode.php](src/Enums/SiteCode.php)or the official documentation page at [developer.ebay.com](https://developer.ebay.com/devzone/xml/docs/Reference/eBay/types/SiteCodeType.html)

Install the required composer dependencies using:

```
composer install
```

Now, generate a valid and working refresh token using Testbench:

```
./vendor/bin/testbench ebay:authorize --testing
```

This will output an authorization URL in the console.

1. Open this URL in your browser
2. Sign in using your Sandbox account (not your production one)
3. Grant access for the requested scopes
4. After successful authorization, you will be redirected to eBay's oAuth page

Once you see the success message, copy the full redirected URL and pass it back to the command (and Yes, the quotes matter. Especially on Windows, where everything breaks if you blink wrong.)

```
./vendor/bin/testbench ebay:authorize "https://auth2.ebay.com/..." --testing
```

If the `.env.testing` file exists, the command will automatically create or update your `PEST_EBAY_REFRESH_TOKEN=`, if not, the token will be printed to the console instead.

Once the refresh token is available, you can run the tests using:

```
./vendor/bin/pest
```

Changelog
---------

[](#changelog)

We provide an aggregated list of eBay API changes on our [documentation page](https://ebay-sdk.rat.md/changelog/overview.html)as well as via [RSS feeds](https://ebay-sdk.rat.md/changelog/feeds.html).

For changes specific to this Laravel package, please refer to the [CHANGELOG](CHANGELOG.md).

License
-------

[](#license)

Published under MIT License
Copyright © 2024 - 2026 Sam @ rat.md

This software is not an official eBay product and is not associated with, sponsored by, or endorsed by eBay Inc.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance91

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

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 ~7 days

Recently: every ~19 days

Total

12

Last Release

41d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e4616d6fd140e735e06c7e02e9d59660e6571d0229e67310fc1260a95653246b?d=identicon)[SamBrishes](/maintainers/SamBrishes)

---

Top Contributors

[![SamBrishes](https://avatars.githubusercontent.com/u/106578633?v=4)](https://github.com/SamBrishes "SamBrishes (80 commits)")

---

Tags

ebayebay-apiebay-sdklaravellaravel-packageapilaravelsdkhttp clientebay

###  Code Quality

TestsPest

Static AnalysisPHPStan

### Embed Badge

![Health badge](/badges/ratmd-laravel-ebay-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/ratmd-laravel-ebay-sdk/health.svg)](https://phpackages.com/packages/ratmd-laravel-ebay-sdk)
```

###  Alternatives

[kreait/laravel-firebase

A Laravel package for the Firebase PHP Admin SDK

1.3k16.5M42](/packages/kreait-laravel-firebase)[api-platform/laravel

API Platform support for Laravel

59126.4k6](/packages/api-platform-laravel)[sunchayn/nimbus

A Laravel package providing an in-browser API client with automatic schema generation, live validation, and built-in authentication with a touch of Laravel-tailored magic for effortless API testing.

29428.0k](/packages/sunchayn-nimbus)[butschster/kraken-api-client

The most powerful and extendable REST API / Websocket client for Kraken.com. Built on PHP8.0

5014.3k](/packages/butschster-kraken-api-client)[dragon-code/laravel-http-logger

Logging incoming HTTP requests

319.8k3](/packages/dragon-code-laravel-http-logger)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
