README

Laravel is an accessible and powerful PHP web application framework with an expressive and elegant syntax.

eBay SDK for Laravel

Caution

This is an experimental eBay SDK in an early 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
• Authorize with eBay
• Receive eBay Notifications

Features

• OAuth 2.0 authentication flow (authorization and callback).
• Optional route and controller integration for OAuth and webhooks.
• Support for Modern REST APIs and Traditional XML/SOAP APIs (XML-only).
• Normalized handling of eBay notification webhooks.
• Dispatches Laravel events for all supported eBay notification types.
• Designed for event-driven and extensible integrations.

Requirements

• PHP ≥ 8.2
• Laravel ≥ 11 | ≥ 12

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).

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

Visit the Documentation Page for more details

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

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

Testing

./vendor/bin/pest

Changelog

We provide an aggregated list of eBay API changes on our documentation page as well as via RSS feeds.

For changes specific to this Laravel package, please refer to the CHANGELOG.

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.