This project is not covered by Drupal’s security advisory policy.

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

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.

Supporting organizations: 
Sponsor

Project information

Releases