Moderate stores

In this guide, you’ll learn how to drive a store through its lifecycle from your own server code. Each transition has a dedicated workflow, so the side effects (events, notifications, and compensation) run consistently.

Approve a store

Move a pending_approval store to open with approveSellerWorkflow.

src/api/custom/approve/route.ts

import type { MedusaRequest, MedusaResponse } from "@medusajs/framework/http"
import { approveSellerWorkflow } from "@mercurjs/core/workflows"

export async function POST(req: MedusaRequest, res: MedusaResponse) {
  await approveSellerWorkflow(req.scope).run({
    input: { seller_id: req.params.id },
  })

  res.sendStatus(200)
}

Suspend and reinstate

Freeze an open store’s operations, then reinstate it once the issue is resolved.

import {
  suspendSellerWorkflow,
  unsuspendSellerWorkflow,
} from "@mercurjs/core/workflows"

await suspendSellerWorkflow(container).run({ input: { seller_id } })
// ...later
await unsuspendSellerWorkflow(container).run({ input: { seller_id } })

Terminate a store

import { terminateSellerWorkflow } from "@mercurjs/core/workflows"

await terminateSellerWorkflow(container).run({ input: { seller_id } })

Termination is irreversible. All orders and payouts must be resolved first.

React to lifecycle changes

To run your own side effects when a store’s status changes, subscribe to the events these workflows emit instead of polling. The Event reference lists the event names.

Store

Catalog

Offer

Attribute

Product Edit

Order Group

Commission

Payout

Review

Approve a store

Suspend and reinstate

Terminate a store

React to lifecycle changes

​Approve a store

​Suspend and reinstate

​Terminate a store

​React to lifecycle changes

Approve a store

Suspend and reinstate

Terminate a store

React to lifecycle changes