Order group events

Order groups emit one event of their own, order_group.created, when checkout splits a cart. The same run emits Medusa’s order.placed for every child order. Subscribe to these events to send confirmations, sync external systems, or start follow-up workflows.

Events

Both events come from completeCartWithSplitOrdersWorkflow. Neither is emitted when the workflow returns an existing group for a cart that was already split.

Event	Emitted when	Payload
`order_group.created`	Checkout creates a group for a completed cart	`{ id }`, the group id
`order.placed`	Checkout creates a child order, once per seller	`{ id }`, the order id

The event name is available as OrderGroupWorkflowEvents.CREATED from @mercurjs/core/workflows. order.placed is Medusa’s OrderWorkflowEvents.PLACED from @medusajs/framework/utils. Use order_group.created for work that concerns the whole purchase, such as one confirmation email for a checkout that spans three sellers:

src/subscribers/order-group-created.ts

import type { SubscriberArgs, SubscriberConfig } from "@medusajs/framework"
import { getOrderGroupDetailWorkflow } from "@mercurjs/core/workflows"

export default async function orderGroupCreatedHandler({
  event,
  container,
}: SubscriberArgs<{ id: string }>) {
  const { result: group } = await getOrderGroupDetailWorkflow(container).run({
    input: {
      order_group_id: event.data.id,
      fields: ["id", "display_id", "total", "orders.seller.name"],
    },
  })
}

export const config: SubscriberConfig = {
  event: "order_group.created",
}

The subscriber loads the new group with its child orders and sellers, ready to pass to your notification provider.

Subscribe to order.placed instead when the work belongs to one seller, such as notifying that seller of a new order. Each child order fires its own event.

Store

Catalog

Offer

Attribute

Product Edit

Order Group

Commission

Payout

Review

Events

​Events

​Subscribe to a new group

Events

Subscribe to a new group