April 17th, 2026

New

Split Shipment Support

Overview

The new Shipping Details Provider extension enables merchants to implement split shipment logic through an external service. When integrated with the Ingrid shipping provider, orders can be automatically split into multiple delivery groups — each with its own items, shipping dates, and delivery options.

What's New

Split Shipment via External Provider

Merchants can now connect an external Shipping Details Provider that determines how checkout items should be grouped into separate shipments. This enables scenarios such as:

  • Shipping items from different warehouses as separate deliveries

  • Splitting bulky or heavy items into their own shipment

  • Grouping items by estimated availability or shipping speed

  • Assigning different shipping attributes per delivery group

Delivery Groups

Each delivery group returned by the provider can include:

  • Display name — a label for the shipment group shown to the customer

  • Shipping dates — earliest and latest estimated shipping dates per group

  • Shipping attributes — custom attributes that influence delivery and shipping options

  • Checkout items, gifts, and gift card products — each assigned to their respective group

Fallback

If the external provider is unavailable or returns an error, the system automatically falls back to default behavior (single delivery group with all items), ensuring the checkout flow is never blocked.

Secure Authentication

The extension uses OAuth2 client credentials flow, ensuring secure communication between Brink Commerce and the external provider.

Integration

The extension follows the Brink Extension pattern. To integrate:

  1. Implement the endpoint according to the openAPI specification (upon request)

  2. Configure the provider URL and OAuth2 credentials in Brink Commerce

  3. The Shopper API will call your provider during checkout to determine delivery groups

Shipping Provider Support

Split shipment delivery groups are currently supported with the Ingrid shipping provider. Each delivery group is mapped to an Ingrid cart group, enabling Ingrid to present separate delivery options per group in the checkout widget.