PHPackages spyrosoft/magento2-google-ucp - 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. [Payment Processing](/categories/payments) 4. / 5. spyrosoft/magento2-google-ucp ActiveMagento2-module[Payment Processing](/categories/payments) spyrosoft/magento2-google-ucp ============================= This module adds support for Google Universal Checkout Platform (UCP) integration 1.1.0(3mo ago)45Apache-2.0PHPPHP ^8.1 Since Mar 30Pushed 3mo ago1 watchersCompare [ Source](https://github.com/Spyrosoft-eCommerce-S-A/magento2-google-ucp)[ Packagist](https://packagist.org/packages/spyrosoft/magento2-google-ucp)[ RSS](/packages/spyrosoft-magento2-google-ucp/feed)WikiDiscussions main Synced 4w ago READMEChangelog (1)Dependencies (2)Versions (2)Used By (0) Spyrosoft UCP - Universal Checkout Protocol for Magento 2 ========================================================= [](#spyrosoft-ucp---universal-checkout-protocol-for-magento-2) **Unlock the Future of AI-Powered Commerce with Standardized Checkout Integration** Overview -------- [](#overview) **Spyrosoft UCP** is a Proof of Concept (PoC) Magento 2 module prepared to work with the [Universal Checkout Protocol (UCP)](https://ucp.dev/specification/overview/) mechanism. UCP itself is currently under active development. The first publicly available version is expected to support only the US market, and the specification and supported capabilities may still change. This PoC provides an implementation of the core UCP functionalities known at this point in time, exposing a standardized checkout interface for UCP-compliant clients (e-commerce platforms, AI agents, and payment providers), with a focus on extensibility and protocol-driven interoperability. ### Why UCP Matters for Your Business [](#why-ucp-matters-for-your-business) ChallengeUCP SolutionComplex integration per payment providerSingle standardized API for all providersLimited AI/chatbot commerce capabilitiesNative support for autonomous AI agentsFragmented checkout experiencesUnified protocol across all touchpointsSlow time-to-market for new channelsInstant compatibility with UCP ecosystemKey Benefits ------------ [](#key-benefits) - **AI-Ready Commerce** - Enable AI agents and chatbots to complete purchases on behalf of customers through standardized protocols - **Reduced Integration Costs** - One implementation supports the entire UCP ecosystem of platforms and payment providers - **Future-Proof Architecture** - Built on an open specification with versioned schemas and capability negotiation - **PCI-DSS Compliant by Design** - Tokenized payment credentials keep sensitive data off your servers - **Enterprise Extensibility** - Leverage Magento 2's powerful dependency injection for unlimited customization --- Installation ------------ [](#installation) 1. Require the module: ``` composer require spyrosoft/magento2-google-ucp ``` 2. Enable the module: ``` bin/magento module:enable Spyrosoft_Ucp bin/magento setup:upgrade bin/magento cache:flush ``` --- Configuration ------------- [](#configuration) Configuration options are available in **Stores > Configuration > Sales > Universal Commerce Protocol**: ### General [](#general) - **Is Enabled** - Enable/disable the UCP functionalities ### Catalog [](#catalog) - **Product Identifier** - Select which product attribute should be used as product identifier in UCP (default: SKU) --- Implemented Functionalities --------------------------- [](#implemented-functionalities) ### Core Checkout Session Management [](#core-checkout-session-management) FeatureDescription**Create Session**Initialize checkout with line items, currency, buyer info, and fulfillment preferences**Update Session**Modify cart contents, shipping addresses, and selected fulfillment options**Retrieve Session**Get complete checkout state including totals, available methods, and validation messages**Complete Session**Process payment and convert checkout to confirmed order**Cancel Session**Gracefully terminate checkout and release resources### RESTful API Endpoints [](#restful-api-endpoints) ``` POST /rest/V1/ucp/checkout-sessions # Create new session PUT /rest/V1/ucp/checkout-sessions/:id # Update session GET /rest/V1/ucp/checkout-sessions/:id # Retrieve session POST /rest/V1/ucp/checkout-sessions/:id/complete # Complete checkout POST /rest/V1/ucp/checkout-sessions/:id/cancel # Cancel session GET /.well-known/ucp # Capability discovery ``` ### UCP Protocol Compliance [](#ucp-protocol-compliance) - **Capability Discovery** - Automatic `/.well-known/ucp` endpoint publishing supported services and capabilities - **Version Negotiation** - `UCP-Agent` header validation ensuring client-server compatibility - **Reverse-Domain Namespacing** - Full support for UCP's decentralized governance model ### Supported UCP Capabilities [](#supported-ucp-capabilities) CapabilitySpecification`dev.ucp.shopping.checkout`Core checkout session management`dev.ucp.shopping.fulfillment`Shipping methods and delivery options`dev.ucp.shopping.order`Order representation in UCP### Payment Processing [](#payment-processing) - **Google Pay** - Production-ready Google Pay integration with full tokenization support - **Multiple Payment Handlers** - Module may be extended with additional payment methods through handler registry pattern In current implementation, Google Pay is powered by [Przelewy24](https://commercemarketplace.adobe.com/przelewy24-magento2-przelewy24.html) module. Additional [Payment Service Providers](https://developers.google.com/pay/api) may be integrated by extending payment handler registry. ### Checkout Data Model [](#checkout-data-model) Complete implementation of required UCP checkout schema including: - **Line Items** - Products with SKU, title, quantity, unit price, and line totals - **Buyer Information** - Name, email, phone, and billing address - **Fulfillment** - Shipping methods, rates, destinations, and delivery groups - **Totals** - Subtotal, tax, discounts, fulfillment costs, and grand total - **Messages** - Validation errors, warnings, and informational notices - **Order Confirmation** - Order ID, status, and permalink after completion ### Guest Checkout Support [](#guest-checkout-support) All API endpoints support anonymous access, enabling frictionless guest checkout experiences without requiring customer registration. --- Extensibility Features ---------------------- [](#extensibility-features) Spyrosoft UCP leverages Magento 2's powerful dependency injection system to provide enterprise-grade extensibility at every layer. ### Payment Handler Extension [](#payment-handler-extension) Add custom payment methods by implementing `HandlerProviderInterface` and registering via DI: ``` Vendor\Module\Service\Payment\Handler\YourHandler ``` **Extension Points:** - `HandlerProviderInterface::getHandler()` - Define payment method metadata and configuration - `HandlerProviderInterface::handle()` - Process payment with custom gateway logic ### Checkout Builder Extension [](#checkout-builder-extension) Extend checkout response building using the Composite Builder pattern: ``` Vendor\Module\Service\Builder\Checkout\CustomData ``` **Available Builder Extension Points:** - `BuilderInterface::build()` - Add custom data to checkout response - Buyer, LineItems, Totals, Payment, Fulfillment, OrderConfirmation builders ### Validation Extension [](#validation-extension) Add custom validation rules through the Composite Validator pattern: ``` Vendor\Module\Service\Validator\Checkout\CustomRule Vendor\Module\Service\Validator\Request\CustomRequestRule ``` **Built-in Validators:** - Currency validation against store configuration - UCP-Agent version negotiation - Fulfillment address completeness ### UCP Capabilities Extension [](#ucp-capabilities-extension) Register custom capabilities for your UCP implementation: ``` https://yourcompany.com/ucp/spec https://yourcompany.com/ucp/schema.json ``` --- Architecture Highlights ----------------------- [](#architecture-highlights) ### Design Patterns [](#design-patterns) PatternImplementationBenefit**Composite**Builders, ValidatorsUnlimited extensibility without core modification**Strategy**Payment HandlersSwap payment implementations at runtime**Registry**HandlerListDynamic payment method registration**Facade**CheckoutManagementSimplified API surface for complex operations**Builder**Checkout BuilderClean construction of complex response objects--- Roadmap ------- [](#roadmap) ### General Enhancements [](#general-enhancements) - **Authentication** - Implement [Identity Linking Capacity](https://ucp.dev/specification/identity-linking) - **Schema Validation** - Extend request/response [validation](https://ucp.dev/specification/overview/#negotiation-protocol) against official UCP JSON schemas ### Checkout Capabilities [](#checkout-capabilities) - **Links** - Implement [UCP Links](https://ucp.dev/specification/checkout/#link) specification for enhanced checkout flows - **Buyer Consent Extension** - Add support for [Buyer Consent](https://ucp.dev/specification/buyer-consent) Capability - **Discount Extension** - Implement discount codes and promotions using [UCP Discounts](https://ucp.dev/specification/discount) specification - **Validation Enhancements** - Expand validation rules with inventory and buyer verification - **Continue URL** - Add support for `continue_url` to implement checkout session recovery flow - **Product Images** - Include product `image_url` in line item representation ### Cart Capability [](#cart-capability) - **Cart** - Implement [Cart Capability](https://ucp.dev/draft/specification/cart/) for pre-checkout cart management and persistence ### Catalog Capability [](#catalog-capability) - **Catalog** - Implement [Catalog Capability](https://ucp.dev/draft/specification/catalog/) ### Checkout Fulfillment [](#checkout-fulfillment) - **Pickup Point Fulfillment** - Integrate with [in-store](https://ucp.dev/specification/fulfillment/#retail-location-response) pickup shipping methods ### Payment Enhancements [](#payment-enhancements) - **Card Credential** - Add support for [Card Credential](https://ucp.dev/specification/checkout/#card-credential) payment instruments - **Additional Payment Methods** - Integrate with additional payment methods once UCP support will be extended ### Order Processing [](#order-processing) - **Order Capability** - Implement full [Order Capability](https://ucp.dev/specification/order/) including order retrieval and management - **Order Permalink** - Add support for order permalink in order confirmation response - **Webhooks** - Add support for [Order Event Webhooks](https://ucp.dev/specification/order/#order-event-webhook) --- License ------- [](#license) This project is licensed under the **Apache License, Version 2.0** (Apache-2.0). See: ### Health Score 37 — LowBetter than 81% of packages Maintenance82 Actively maintained with recent releases Popularity8 Limited adoption so far Community7 Small or concentrated contributor base Maturity42 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 Unknown Total 1 Last Release 93d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/aa06a2aa7c7b96230939b1d007ad3789764fc13a25b342cd53708b19667ecca5?d=identicon)[lukasz-gawronski-spyro](/maintainers/lukasz-gawronski-spyro) --- Top Contributors [![bartlomiej-szubert-spyro](https://avatars.githubusercontent.com/u/210000852?v=4)](https://github.com/bartlomiej-szubert-spyro "bartlomiej-szubert-spyro (2 commits)") ### Embed Badge ![Health badge](/badges/spyrosoft-magento2-google-ucp/health.svg) ``` [![Health](https://phpackages.com/badges/spyrosoft-magento2-google-ucp/health.svg)](https://phpackages.com/packages/spyrosoft-magento2-google-ucp) ``` ### Alternatives [adyen/module-payment Official Magento2 Plugin to connect to Payment Service Provider Adyen. 1673.2M10](/packages/adyen-module-payment)[checkoutcom/magento2 Checkout.com Payment Gateway for Magento 2 34276.2k1](/packages/checkoutcom-magento2)[buckaroo/magento2 Buckaroo Magento 2 extension 32420.3k7](/packages/buckaroo-magento2)[payone-gmbh/magento-2 PAYONE payment gateway for all German online and offline payment methods including PayPal, all major Credit Cards. 29447.5k2](/packages/payone-gmbh-magento-2)[mollie/magento2-hyva-checkout Hyvä Themes Checkout module for Mollie Payments 11240.0k](/packages/mollie-magento2-hyva-checkout)[vipps/module-payment Vipps MobilePay Payment Module for Magento 2 1098.4k](/packages/vipps-module-payment) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)