PHPackages bibliopolis/event-notification-php-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 & Networking](/categories/http) 4. / 5. bibliopolis/event-notification-php-sdk ActiveLibrary[HTTP & Networking](/categories/http) bibliopolis/event-notification-php-sdk ====================================== A PHP SDK for processing eBay event notifications. Bibliopolis aims to add new schemas for additional notiifications endpoints and fix problems with original repository. 1.1.0(1y ago)08ISCPHP Since Jun 27Pushed 1y agoCompare [ Source](https://github.com/Bibliopolis/event-notification-php-sdk)[ Packagist](https://packagist.org/packages/bibliopolis/event-notification-php-sdk)[ RSS](/packages/bibliopolis-event-notification-php-sdk/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (6)Versions (4)Used By (0) Event Notification SDK ====================== [](#event-notification-sdk) With notifications, business moments are communicated to all interested listeners a.k.a. subscribers of those event streams. eBay's most recent notification payloads are also secured using ECC signature headers. This PHP SDK is designed to simplify processing eBay notifications. The application receives subscribed messages, validates the integrity of the message using the X-EBAY-SIGNATURE header and delegates to a custom configurable MessageProcessor for plugging in usecase specific processing logic. Table of contents ================= [](#table-of-contents) - [What Notifications are covered?](#notifications) - [Features](#features) - [Usage](#usage) - [Logging](#logging) - [License](#license) Notifications ============= [](#notifications) This SDK is intended for the latest eBay notifications that use ECC signatures and JSON payloads. While this SDK is generic for any topic, it currently includes the schema definition for MARKETPLACE\_ACCOUNT\_DELETION notifications. Features ======== [](#features) This SDK is intended to bootstrap subscriptions to eBay Notifications and provides a ready PHP example. This SDK now also incorporates support for endpoint validation. This SDK incorporates - A deployable example PHP application that is generic across topics and can process incoming https notifications - Allows registration of custom Message Processors. - [Verify the integrity](https://github.corp.ebay.com/shuoyao/notification-sdk-php/blob/92d7cc9a6dae51576b2fba92bfa82885ae383a3c/src/lib/validator.php#L39) of the incoming messages - Use key id from the decoded signature header to fetch public key required by the verification algorithm. An LRU cache is used to prevent refetches for same 'key'. - On verification success, delegate processing to the registered custom message processor and respond with a 204 HTTP status code. - On verification failure, respond back with a 412 HTTP status code - Generate the challenge response required for validating this endpoint. For more details on endpoint validation please refer to the [documentation](https://developer.ebay.com/marketplace-account-deletion). Usage ===== [](#usage) **Prerequisite** ``` PHP: v7.3 or higher ``` **Configure** - Update config.json with the client credentials (required to fetch Public Key from /commerce/notification/v1/public\_key/{public\_key\_id}). - Specify environment (PRODUCTION or SANDBOX) in [example.php](./src/examples/example.php). Default: PRODUCTION - For Endpoint Validation - **verificationToken** associated with your endpoint. A random sample is included for your endpoint, this needs to be the same as that provided to eBay. - **Endpoint** specific to this deployment. A random url is included as an example. **Note**: it is recommended that the *verificationToken* be stored in a secure location. ``` { "SANDBOX": { "clientId": "", "clientSecret": "", "devid": "", "redirectUri": "", "baseUrl": "api.sandbox.ebay.com" }, "PRODUCTION": { "clientId": "", "clientSecret": "", "devid": "", "redirectUri": "", "baseUrl": "api.ebay.com" }, "endpoint": "", "verificationToken": "" } ``` For MARKETPLACE\_ACCOUNT\_DELETION use case simply implement custom logic in [accountDeletionMessageProcessor.processInternal()](./src/lib/processor/accountDeletionMessageProcessor.php) **Onboard any new topic in 3 simple steps! :** - Add the new topic constant to [constants.php](src/lib/constants.php) - Add a custom message processor for the new topic in `src/lib/processor/` - Update the [processor.php](src/lib/processor/processor.php) to return the new message processor for the topic Note: You can refer to [example.php](src/examples/example.php) for an example of how to setup an express server and use the SDK. **Install and Run** ``` composer install composer run-script start ``` **Note for Production deployment** ``` For production, please host with HTTPS enabled. ``` Logging ======= [](#logging) Uses standard error logging. License ======= [](#license) Copyright 2022 eBay Inc. Developer: Shuoyang Yao Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at ``` https://www.apache.org/licenses/LICENSE-2.0 ``` Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ### Health Score 23 — LowBetter than 27% of packages Maintenance32 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community9 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 77.8% 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 3 Last Release 684d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/2ed6cd78ad49031418eaa9dd5e21f18e673605548b3a01f51fbe413f07da253c?d=identicon)[mattybaer](/maintainers/mattybaer) --- Top Contributors [![mattybaer](https://avatars.githubusercontent.com/u/964664?v=4)](https://github.com/mattybaer "mattybaer (14 commits)")[![Shuoyang12](https://avatars.githubusercontent.com/u/102178566?v=4)](https://github.com/Shuoyang12 "Shuoyang12 (2 commits)")[![sj199](https://avatars.githubusercontent.com/u/59309687?v=4)](https://github.com/sj199 "sj199 (2 commits)") --- Tags sdkebayEvent NotificationEndpoint Validationbibliopolis ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/bibliopolis-event-notification-php-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/bibliopolis-event-notification-php-sdk/health.svg)](https://phpackages.com/packages/bibliopolis-event-notification-php-sdk) ``` ### Alternatives [xeroapi/xero-php-oauth2 Xero official PHP SDK for oAuth2 generated with OpenAPI spec 3 1054.3M14](/packages/xeroapi-xero-php-oauth2)[onesignal/onesignal-php-api A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com 34170.2k2](/packages/onesignal-onesignal-php-api)[ory/hydra-client Documentation for all of Ory Hydra's APIs. 17435.9k](/packages/ory-hydra-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)