monkeyscommerce

MonkeysCommerce — The Next-Generation Drupal Commerce Engine

MonkeysCommerce is a modern, API-first, enterprise-grade e-commerce framework for Drupal 11.3+ and Drupal 12. Built from the ground up on event-sourced architecture, it provides a complete commerce stack — catalog, cart, checkout, orders, payments, shipping, tax, inventory, promotions, and a full headless Storefront API — all in a single, cohesive package.

Why MonkeysCommerce?

Legacy Drupal commerce solutions bolt APIs onto page-rendering architectures. MonkeysCommerce is different:

• Event-Sourced Orders: Every state change in your order lifecycle is stored as an immutable event. Full audit trails, easy debugging, replay, and never lose data.
• Headless-First Storefront API: A comprehensive REST API covering products, collections, cart, checkout, orders, coupons, and admin operations — plus Server-Sent Events (SSE) for real-time inventory and cart updates.
• Plugin-Based Extensibility: Payment gateways, tax providers, shipping rate providers, promotion conditions, and promotion actions are all discoverable annotation-based plugins. Add new ones without touching core.
• No Dependency Bloat: Payment gateways use Drupal's built-in Guzzle HTTP client to call provider APIs directly — no heavy vendor SDKs, no version conflicts.
• AI-Native Commerce: First-class integration with LLM-powered product enrichment, fraud scoring, and smart recommendations via the Apex AI extension.
• Global Tax Compliance: Pluggable tax provider system with official packs for the US, EU, UK, Canada, Latin America, and India — each handling jurisdiction-specific rules like nexus, VIES validation, HSN codes, and reverse charge.

Included Submodules (15)

MonkeysCommerce ships with these submodules that you enable as needed:

Foundation

Submodule Entities Key Services Description mkc_core Store, Channel, CustomerProfile mkc.store_resolver, mkc.audit_logger, mkc.consent_manager, mkc.pii_redactor Multi-store resolution, sales channels, GDPR consent management, PII redaction, audit logging with correlation IDs mkc_catalog Product, ProductVariant, ProductType, ProductCollection mkc.catalog_manager, mkc.sku_generator, mkc.slug_generator Full product management with configurable product types, variants with option values, collections, and auto-generated SEO slugs mkc_cart — mkc.cart_service, mkc.cart_token_manager Session and token-based cart management, add/update/remove line items, guest cart merging on login mkc_checkout — — Multi-step checkout flow: address → shipping → payment → confirmation. Fully themeable Twig templates.

Order & Fulfillment

Submodule Entities Key Services Description mkc_order — (event-sourced aggregate) mkc.event_store, mkc.projection_storage Event-sourced order management. Every status change, refund, and fulfillment action is an immutable event with full timeline view. mkc_inventory — mkc.inventory_service, mkc.atp_calculator Stock level tracking, Available-to-Promise (ATP) calculation, stock adjustment logs, low-stock alerts mkc_shipping Shipment, ShippingMethod, ShippingZone mkc.shipping_rate_resolver, plugin.manager.mkc_shipping_rate_provider Zone-based shipping with pluggable rate providers (flat rate, weight-based, free shipping). Multi-carrier support.

Money & Pricing

Submodule Entities Key Services Description mkc_payment — mkc.payment_service, mkc.idempotency_guard, plugin.manager.mkc_payment_gateway Gateway plugin system supporting authorize, capture, refund, and webhook handling. Idempotency guard prevents double charges. mkc_tax TaxZone mkc.tax_calculator, plugin.manager.mkc_tax_provider Tax zone management, pluggable tax provider system, inclusive/exclusive pricing modes mkc_promotions Promotion, Coupon mkc.promotion_evaluator, mkc.coupon_validator, mkc.stacking_resolver Percentage/fixed/free-shipping discounts, auto and coupon-based triggers, usage limits, stacking rules, bulk coupon generation

Customer & API

Submodule Key Services Description mkc_customer — Customer segmentation, address book, customer admin with unified profile mkc_storefront_api mkc.openapi_generator, mkc.broadcaster, mkc.api_scope_manager 40+ REST endpoints covering products, collections, cart, checkout, orders, coupons, and full admin CRUD. Auto-generated OpenAPI spec at /api/v1/openapi.json. Real-time SSE broadcasting for inventory and cart events. mkc_admin — Unified admin dashboard, themed admin templates, section collector for extension dashboard cards

The MonkeysCommerce Ecosystem

Beyond the core, MonkeysCommerce offers a full ecosystem of standalone Drupal modules — each installable independently via Composer:

Vertical Accelerators

• Digital Goods Accelerator — Sell downloads and license keys with secure delivery and activation tracking
• Fashion Accelerator — Size charts, lookbooks, fit recommendations, and return/exchange workflows

Enterprise Extensions

• B2B Suite — Company accounts, purchase orders, quotes, tiered pricing, cXML/OCI PunchOut
• Multi-Vendor Marketplace — Vendor onboarding, product approval, Stripe Connect payouts, commission splitting
• Subscriptions — Recurring billing with dunning, proration, usage metering, and self-service portals
• ERP Integrator — Bidirectional sync with SAP, NetSuite, Odoo via pluggable connector system
• Enterprise Search — Merchandising rules, synonyms, faceted search, and search analytics
• Advanced Analytics — Revenue dashboards, funnel analysis, product performance, CSV export
• Apex AI — AI-powered product enrichment, recommendations, fraud scoring via MonkeysLegion Apex
• PWA & Headless — Service worker generation, push notifications, manifest, sitemap, JSON-LD

Payment Gateways

• Adyen — Checkout API v71, Drop-in component, 250+ payment methods
• MercadoPago — Checkout Pro, OXXO/Rapipago cash, IPN webhooks
• Mollie — iDEAL, Bancontact, SOFORT, hosted checkout
• PayPal — Orders API v2, Pay Later, Venmo, OAuth2
• Square — Web Payments SDK, Apple Pay, Google Pay

Tax Compliance Packs

• US Sales Tax — Nexus tracking, origin vs destination, tax holidays, marketplace facilitator
• EU VAT — VIES validation, reverse charge, OSS/MOSS, digital goods rules
• Canada GST/HST — Provincial rate tables, exemptions
• UK VAT — Standard/reduced/zero rates, low-value import relief
• LATAM IVA — Mexico, Colombia, Argentina, Chile, Brazil, withholding taxes
• India GST — CGST/SGST/IGST, HSN codes, GSTR export

Storefront API Endpoints

The mkc_storefront_api submodule exposes 40+ REST endpoints including:

Category Endpoints Products GET /api/v1/products, GET /api/v1/products/{id}, GET /api/v1/products/slug/{slug} Collections GET /api/v1/collections, GET /api/v1/collections/{id} Cart GET/POST /api/v1/cart, POST /api/v1/cart/items, PATCH/DELETE /api/v1/cart/items/{id}, coupon apply/remove Checkout POST /api/v1/checkout/{id}/addresses, shipping, payment-intent, confirm Orders GET /api/v1/orders, GET /api/v1/orders/{id}, tracking Admin Full CRUD for products, orders, inventory, promotions, and customers Real-Time GET /api/v1/events/{channel} — Server-Sent Events for cart, inventory, and order updates OpenAPI GET /api/v1/openapi.json — Auto-generated specification

Installation

composer require drupal/monkeyscommerce
drush en monkeyscommerce -y

# Enable the submodules you need:
drush en mkc_core mkc_catalog mkc_cart mkc_checkout mkc_order mkc_inventory mkc_shipping mkc_payment mkc_promotions mkc_tax mkc_storefront_api mkc_admin -y

Requirements

• Drupal 11.3+ or Drupal 12
• PHP 8.2+
• MySQL 8.0+ or MariaDB 10.6+

License

GPL-2.0-or-later

Built with ❤️ by MonkeysCloud — empowering next-generation digital experiences.