PHPackages wallee/plugin-core - 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. [Utility & Helpers](/categories/utility) 4. / 5. wallee/plugin-core ActiveLibrary[Utility & Helpers](/categories/utility) wallee/plugin-core ================== Core functionality for the Wallee plugins. 0.2.4(3w ago)07141Apache-2.0PHPPHP >=8.2 Since Feb 13Pushed yesterdayCompare [ Source](https://github.com/wallee-payment/plugin-core)[ Packagist](https://packagist.org/packages/wallee/plugin-core)[ RSS](/packages/wallee-plugin-core/feed)WikiDiscussions 0.1.x Synced 2w ago READMEChangelog (10)Dependencies (25)Versions (15)Used By (1) Wallee Plugin Core Library ========================== [](#wallee-plugin-core-library) **The canonical, framework-agnostic business logic engine for Wallee payment integrations.** This library abstracts the complexity of the Wallee SDK and provides a standardized, robust implementation of payment flows. It is designed to be used as a core dependency by platform-specific plugins (Magento, WooCommerce, Shopware, etc.), decoupling **business logic** from **platform infrastructure**. --- Core Philosophy --------------- [](#core-philosophy) The goal of this project is to centralize all payment business logic into a single, reusable library, decoupling it from the specific constraints of platforms like Magento or WooCommerce. Instead of duplicating complex logic across different shop systems, `plugin-core` implements the payment workflows once, using pure PHP. This shifts the role of the shop-specific plugin: - **Plugin Core:** Implements the business logic, manages state machines, and handles all API interactions via the SDK. - **Shop Plugin:** Acts as an **adapter**. It interchanges data between the shop and the Core, handles database persistence, manages configuration, and integrates into the shop's frontend/backend events. ### Key Architectural Benefits [](#key-architectural-benefits) - **Pure PHP:** Framework-agnostic code that runs anywhere PHP runs. - **Minimal Dependencies:** Depends only on the official `wallee/php-sdk`, making it lightweight and easy to port to any environment. - **Type Safety:** Written with strict typing to catch errors early. - **Testability:** Designed for 100% unit test coverage with isolated components. - **PSR Standards:** Fully compliant with PSR-3 (Logging) and other standard interfaces. - **Contract-Driven:** Clear Interfaces and Abstract Base Classes guide developers to implement the necessary platform-specific adapters correctly. --- Key Features ------------ [](#key-features) The library is divided into major functional components, each designed for robustness and ease of integration. ### 1. Checkout Engine [](#1-checkout-engine) The core of the payment flow. Handles transaction creation and management with a sophisticated "upsert" strategy, ensuring seamless navigation without duplicate charges. - **[Read Checkout Docs](docs/Checkout/README.md)** ### 2. Webhook Processor [](#2-webhook-processor) The engine for handling asynchronous events from the Wallee Portal. It's built for scale and high concurrency. - **[Read Webhook Processor Docs](docs/Webhook/Processor/README.md)** ### 3. Webhook Management [](#3-webhook-management) Tools for programmatically managing webhooks in the Wallee Portal, including URL creation and Listener setup. - **[Read Webhook Management Docs](docs/Webhook/Management/README.md)** ### 4. Transaction Completion (Capture & Void) [](#4-transaction-completion-capture--void) Manage the final stages of the transaction lifecycle. Finalize payments (Capture) or cancel them (Void) with dedicated service handlers. - **[Read Completion Docs](docs/Completion/README.md)** ### 5. Recurring Payments [](#5-recurring-payments) Enables Merchant Initiated Transactions (MIT) for seamless subscription renewals and unscheduled subsequent charges using saved tokens. - **[Read Recurring Docs](docs/Recurring/README.md)** ### 6. Refund Management [](#6-refund-management) Support for full and partial refunds. Includes precise line-item logic and validation to prevent over-refunding. - **[Read Refund Docs](docs/Refund/README.md)** ### 7. Document Management [](#7-document-management) Retrieve official PDF documents (Invoices, Packing Slips, Credit Notes) directly from the Wallee Portal for the merchants. - **[Read Document Docs](docs/Document/README.md)** ### 8. Payment Method Service [](#8-payment-method-service) A centralized service to fetch available payment method configurations from the Wallee Portal, ensuring the shop systems have an up-to-date view of available payment methods. - **[Read Payment Method Docs](docs/PaymentMethod/README.md)** ### 9. Manual Task Tracking [](#9-manual-task-tracking) Check how many manual tasks (e.g. a manual risk review) are outstanding for a space, so the shop can surface a reminder to the merchant before a transaction can proceed. - **[Read Manual Task Docs](docs/ManualTask/README.md)** ### 10. Token Management [](#10-token-management) Saved payment credentials for recurring/Merchant Initiated Transactions, with explicit control over how and when tokenization is applied at checkout. - **[Read Token Docs](docs/Token/README.md)** --- Documentation & Examples ---------------------------- [](#documentation--examples) For detailed implementation guides and runnable examples for every module, see the [documentation index](docs/README.md). --- Installation ------------ [](#installation) ``` composer require wallee/plugin-core ``` --- Unit Tests ---------- [](#unit-tests) You can run the test suite to verify the library's behavior. ``` composer test ``` License ------- [](#license) Apache License. See \[LICENSE.txt\]. ### Health Score 45 — FairBetter than 91% of packages Maintenance98 Actively maintained with recent releases Popularity18 Limited adoption so far Community12 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 90% 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 ~10 days Recently: every ~3 days Total 14 Last Release 23d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/79ce1a833759c18051edb71ae575a0cf5ac10625ae6cad91d0509b9da246488f?d=identicon)[andrewrowanwallee](/maintainers/andrewrowanwallee) --- Top Contributors [![alberto-wallee](https://avatars.githubusercontent.com/u/109144904?v=4)](https://github.com/alberto-wallee "alberto-wallee (9 commits)")[![andrewrowanwallee](https://avatars.githubusercontent.com/u/73881084?v=4)](https://github.com/andrewrowanwallee "andrewrowanwallee (1 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/wallee-plugin-core/health.svg) ``` [![Health](https://phpackages.com/badges/wallee-plugin-core/health.svg)](https://phpackages.com/packages/wallee-plugin-core) ``` ### Alternatives [neuron-core/neuron-ai The PHP Agentic Framework. 2.0k656.1k46](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3661.3M47](/packages/tencentcloud-tencentcloud-sdk-php)[spatie/laravel-export Create a static site bundle from a Laravel app 674146.0k6](/packages/spatie-laravel-export)[eslazarev/wildberries-sdk Wildberries OpenAPI clients (generated). 293.1k](/packages/eslazarev-wildberries-sdk)[oat-sa/tao-core TAO core extension 65143.7k124](/packages/oat-sa-tao-core)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)