Webshop Commercial

Description

Webshop Commercial bridges the public webshop with Enso commercial documents and Stripe payments.

The package extends webshop orders with commercial sale and line data, stores local transaction references, creates orders from cart entries, integrates with Stripe payment intents and checkout flows, listens for payment success events, and finalizes paid orders into the commercial domain.

Installation

This is a proprietary package distributed through the private Enso registry.

Run the migrations:

php artisan migrate

Make sure the host application already has:

• laravel-enso/commercial
• laravel-enso/products
• laravel-enso/stripe
• laravel-enso/webshop

Features

• Commercial order storage and order-line mapping for webshop carts.
• Stripe payment-intent and checkout-session creation.
• Webshop payment route integration for authenticated customers.
• Event listener for Stripe payment success.
• Invoice and payment-status aware order model.
• Payment received notification flow.

Usage

Published routes:

• GET webshop/payment-intent/{order}
• internal account payment and order-pay controllers bound through service providers

Main classes:

• LaravelEnso\WebshopCommercial\Models\Order
• LaravelEnso\WebshopCommercial\Models\Line
• Services\Orders\Store
• Services\Orders\Finalize
• Services\Stripe\Intent
• Services\Stripe\Payment

The package also overrides webshop payment services through WebshopServiceProvider so the storefront order payment flow resolves the commercial implementation automatically.

API

This package exposes its backend integration through the routes, controllers, services, jobs, and configuration points referenced in the usage examples above.

Consumers should rely on the published config keys, documented route groups, and explicit service classes shown in the examples. Internal helper classes, listeners, casts, and background jobs are implementation details unless the README calls them out as extension points.

Depends On

Required Enso packages:

• laravel-enso/core ↗
• laravel-enso/commercial ↗
• laravel-enso/discounts ↗
• laravel-enso/dynamic-methods ↗
• laravel-enso/products ↗
• laravel-enso/stripe ↗
• laravel-enso/webshop ↗

External service dependency:

• Stripe payment intents, checkout sessions, and payment events

Contributions

are welcome. Pull requests are great, but issues are good too.

Thank you to all the people who already contributed to Enso!