Monkeys Commerce Marketplace

MonkeysCommerce: Multi-Vendor Marketplace

Transform your MonkeysCommerce store into a full multi-vendor marketplace. Includes vendor onboarding, product approval workflows, Stripe Connect payouts, commission splitting, dispute resolution, and dedicated vendor dashboards.

Entities

Entity Description Vendor Merchant account with profile, Stripe Connect ID, and approval status VendorProduct Product submitted by a vendor, pending admin review VendorOrder Order line items allocated to a specific vendor for fulfillment Commission Calculated commission record per vendor order Payout Scheduled or completed payout to a vendor VendorShippingMethod Vendor-specific shipping methods and rates

Services

Service ID Description mkc_marketplace.vendor_manager Vendor registration, approval, suspension lifecycle mkc_marketplace.order_splitter Splits multi-vendor carts into per-vendor sub-orders mkc_marketplace.commission_calculator Calculates platform fees based on configurable rates mkc_marketplace.payout_processor Processes vendor payouts via Stripe Connect transfers mkc_marketplace.stripe_connect Stripe Connect OAuth and account management mkc_marketplace.dispute_handler Manages customer-vendor-platform dispute resolution mkc_marketplace.vendor_shipping_resolver Resolves shipping rates per vendor mkc_marketplace.vendor_inventory_bridge Vendor-scoped inventory management

Admin Pages (12)

• /admin/commerce/marketplace — Marketplace dashboard
• /admin/commerce/marketplace/settings — Commission rates, payout schedule
• /admin/commerce/marketplace/vendors — Vendor list with approve/reject actions
• /admin/commerce/marketplace/vendor-orders — All vendor sub-orders
• /admin/commerce/marketplace/vendor-products — Review submitted products
• /admin/commerce/marketplace/commissions — Commission ledger
• /admin/commerce/marketplace/payouts — Payout history and batch creation
• /admin/commerce/marketplace/disputes — Active disputes

Vendor Portal

• /vendor/dashboard — Vendor sales summary
• /vendor/products — Manage own product catalog
• /vendor/orders — View and fulfill assigned orders
• /vendor/payouts — Payout history and earnings
• /vendor/shipping — Manage shipping methods
• /marketplace/register — Public vendor registration form

Stripe Connect Integration

• OAuth-based vendor onboarding to Stripe Express or Standard accounts
• Automatic transfer of vendor earnings on order fulfillment
• Webhook handling for payout failures and dispute notifications
• /marketplace/stripe/connect/callback — OAuth callback endpoint

API Endpoints

Method Path Description GET /api/v1/vendors List active vendors GET /api/v1/vendors/{id} Vendor detail GET /api/v1/vendors/{id}/products Vendor product catalog

Features

• Vendor Onboarding: Streamlined registration → admin approval → Stripe Connect setup pipeline.
• Product Approval Queues: Vendors submit products for admin review before publication.
• Order Splitting: Multi-vendor carts are automatically split into per-vendor sub-orders.
• Commission Engine: Configurable percentage or flat-fee commission per sale.
• Stripe Connect Payouts: Automatic fund transfers to vendor Stripe accounts.
• Dispute Resolution: Three-party dispute workflow (customer ↔ vendor ↔ platform).
• Vendor-Scoped Shipping: Each vendor configures their own shipping methods and rates.

Installation

composer require drupal/mkc_marketplace
drush en mkc_marketplace -y

Requirements

• Drupal 11.3+ or 12, PHP 8.2+
• MonkeysCommerce
• stripe/stripe-php (installed automatically via Composer)

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