@mercurjs/docs 2.3.8-canary.3 → 2.3.9-canary.1

package/content/platform/store/reference/workflows.mdx

@@ -1,35 +1,315 @@
 ---
-title: "Workflows"
+title: "Seller module workflows"
 sidebarTitle: "Workflows"
-description: "Seller and member workflows, service methods, and events."
+description: "Every store, lifecycle, business-detail, and team workflow in the Seller module, with inputs, hooks, and events."
 ---
 
-This reference lists the workflows, service methods, and events for the Store
-domain. Import workflows from `@mercurjs/core/workflows` and run them against the
-Medusa container.
+This reference lists every workflow that writes Seller module data. Import them from `@mercurjs/core/workflows` and run them against the Medusa container: `await workflow(container).run({ input })`. Workflows roll back their completed steps when a later step fails.
 
-## Seller workflows
+```ts
+import { approveSellerWorkflow } from "@mercurjs/core/workflows"
 
-| Workflow | Input | Purpose |
+await approveSellerWorkflow(container).run({
+  input: { seller_id: "sel_01JD8Q1234567" },
+})
+```
+
+Workflows that take `additional_data` pass it to their hooks. Register a hook handler with `workflow.hooks.<hookName>(handler)`.
+
+## createSellersWorkflow
+
+Creates one or more stores, links each to the default region plus `region_ids`, and invites one member per store with `role_seller_administration`. Returns `SellerDTO[]`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `sellers` | `CreateSellerDTO & { member, region_ids? }[]` | Store fields; `status` defaults to `pending_approval` |
+| `sellers[].member` | `{ email: string }` | Required, the address that gets the invite |
+| `sellers[].region_ids` | `string[]` | Optional, regions besides the default one |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `validate` (`{ input }`), `sellersCreated` (`{ sellers, additional_data }`)
+- **Events**: `seller.created` per store, `member_invite.created` per invite
+
+## createSellerAccountWorkflow
+
+Creates one store in `pending_approval` and adds a member as its owner with `role_seller_administration`. Returns `SellerDTO`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `auth_identity_id` | `string` | The auth identity to attach the member to |
+| `seller` | `CreateSellerDTO` | Store fields; `status` is forced to `pending_approval` |
+| `member_id` | `string` | Optional, an existing member to make owner |
+| `member_email` | `string` | Used when `member_id` is absent to upsert a member |
+| `first_name`, `last_name` | `string` | Optional, set on a new member |
+| `address` | `UpdateSellerAddressDTO` | Optional, written through `updateSellerAddressWorkflow` |
+| `professional_details` | `UpdateProfessionalDetailsDTO` | Optional |
+| `payment_details` | `UpdatePaymentDetailsDTO` | Optional |
+| `region_ids` | `string[]` | Optional, regions besides the default one |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `validate` (`{ input }`), `sellerAccountCreated` (`{ seller, member_id, additional_data }`)
+- **Events**: `seller.created`
+
+## updateSellersWorkflow
+
+Updates every store that matches `selector` with the same `update`. Returns `SellerDTO[]`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `selector` | `Record<string, unknown>` | Filters, such as `{ id: "sel_01JD8Q1234567" }` |
+| `update` | `UpdateSellerDTO` | Fields to set |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `sellersUpdated` (`{ sellers, additional_data }`)
+- **Events**: `seller.updated` per store
+
+## deleteSellersWorkflow
+
+Soft deletes stores by id. Compensation restores them.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `ids` | `string[]` | Seller ids |
+
+- **Hooks**: none
+- **Events**: `seller.deleted` per store
+
+## approveSellerWorkflow
+
+Moves a `pending_approval` store to `open`, clears `status_reason`, and sets `approved_at` if it’s empty.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store to approve |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `sellerApproved` (`{ seller_id, additional_data }`)
+- **Events**: `seller.approved`
+
+## suspendSellerWorkflow
+
+Moves a `pending_approval` or `open` store to `suspended`, saves `reason` in `status_reason`, and sets `rejected_at` if it’s empty.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store to suspend |
+| `reason` | `string` | Optional |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `sellerSuspended` (`{ seller_id, additional_data }`)
+- **Events**: `seller.suspended`
+
+## unsuspendSellerWorkflow
+
+Moves a `suspended` store to `open` and clears `status_reason`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store to reopen |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `sellerUnsuspended` (`{ seller_id, additional_data }`)
+- **Events**: `seller.unsuspended`
+
+## terminateSellerWorkflow
+
+Moves a `pending_approval` or `suspended` store to `terminated` and saves `reason` in `status_reason`. Fails for an `open` store.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store to terminate |
+| `reason` | `string` | Optional |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `sellerTerminated` (`{ seller_id, additional_data }`)
+- **Events**: `seller.terminated`
+
+## unterminateSellerWorkflow
+
+Moves a `terminated` store to `suspended` and clears `status_reason`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store to restore |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `sellerUnterminated` (`{ seller_id, additional_data }`)
+- **Events**: `seller.unterminated`
+
+## linkSellerRegionsWorkflow
+
+Adds and removes store region links in one run. Fails if a region or seller doesn’t exist, or if a store would be left with no region.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `add` | `{ seller_id, region_id }[]` | Optional, links to create |
+| `remove` | `{ seller_id, region_id }[]` | Optional, links to dismiss |
+
+- **Hooks**: none
+- **Events**: none
+
+## updateSellerAddressWorkflow
+
+Creates or updates a store’s `SellerAddress`. Returns `SellerAddressDTO`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store |
+| `data` | `UpdateSellerAddressDTO` | Address fields |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `addressUpdated` (`{ address, additional_data }`)
+- **Events**: none
+
+## updateSellerProfessionalDetailsWorkflow
+
+Creates or updates a store’s `ProfessionalDetails`. Returns `ProfessionalDetailsDTO`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store |
+| `data` | `UpdateProfessionalDetailsDTO` | `corporate_name`, `registration_number`, `tax_id` |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `professionalDetailsUpdated` (`{ professional_details, additional_data }`)
+- **Events**: none
+
+## deleteSellerProfessionalDetailsWorkflow
+
+Deletes a store’s `ProfessionalDetails`, if it has any.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `professionalDetailsDeleted` (`{ seller_id, additional_data }`)
+- **Events**: none
+
+## updateSellerPaymentDetailsWorkflow
+
+Creates or updates a store’s `PaymentDetails`. Returns `PaymentDetailsDTO`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store |
+| `data` | `UpdatePaymentDetailsDTO` | Bank account fields |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `paymentDetailsUpdated` (`{ payment_details, additional_data }`)
+- **Events**: none
+
+## inviteSellerWorkflow
+
+Sends an email that invites someone to register a new store. It creates a notification with the template `newSellerInvitation` on the `email` channel, and writes no Seller module records.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `email` | `string` | The prospective seller |
+| `registration_url` | `string` | Optional, the link in the email’s button |
+
+- **Hooks**: none
+- **Events**: none
+
+## createMemberInvitesWorkflow
+
+Creates team invites with signed tokens. Fails if an email already belongs to the store. Returns `MemberInviteDTO[]`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `[].seller_id` | `string` | The store |
+| `[].email` | `string` | The invitee |
+| `[].role_id` | `string` | A `SellerRole` value |
+
+The input is an array of invites, not an object.
+
+- **Hooks**: none
+- **Events**: `member_invite.created` per invite
+
+## resendMemberInviteWorkflow
+
+Deletes an invite and creates a replacement with the same email and role, a new token, and a new expiry. Returns `MemberInviteDTO[]`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `invite_id` | `string` | The invite to replace |
+| `seller_id` | `string` | The store that owns it |
+
+- **Hooks**: none
+- **Events**: `member_invite.created`
+
+## deleteMemberInviteWorkflow
+
+Deletes an invite.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `invite_id` | `string` | The invite to delete |
+
+- **Hooks**: none
+- **Events**: none
+
+## acceptMemberInviteWorkflow
+
+Validates an invite token, upserts the member by email, creates the membership with the invite’s role, and deletes the invite. The member becomes owner when the store has no owner yet. Returns `MemberDTO`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `invite_token` | `string` | The token from the invite |
+| `auth_identity_id` | `string` | The invitee’s auth identity |
+| `member_id` | `string` | Optional; when set, the auth identity isn’t updated |
+| `first_name`, `last_name` | `string` | Optional, set on a new member |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
+
+- **Hooks**: `validate` (`{ input, invite }`), `memberInviteAccepted` (`{ member, invite, additional_data }`)
+- **Events**: `member_invite.accepted`
+
+## addSellerMemberWorkflow
+
+Adds an existing member to a store. Returns the `SellerMember`.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_id` | `string` | The store |
+| `member_id` | `string` | The existing member |
+| `role_id` | `string` | A `SellerRole` value |
+
+- **Hooks**: none
+- **Events**: `seller_member.created`
+
+## updateMemberRoleWorkflow
+
+Changes the role on a membership. Fails for the owner membership.
+
+| Input | Type | Description |
 | --- | --- | --- |
-| `createSellersWorkflow` | `{ sellers[], additional_data? }` | Create stores with defaults |
-| `updateSellersWorkflow` | `{ selector, update }` | Update store fields |
-| `deleteSellersWorkflow` | `{ ids[] }` | Delete stores |
-| `approveSellerWorkflow` | `{ seller_id, additional_data? }` | `pending_approval` → `open` |
-| `suspendSellerWorkflow` | `{ seller_id }` | `open` → `suspended` |
-| `unsuspendSellerWorkflow` | `{ seller_id }` | `suspended` → `open` |
-| `terminateSellerWorkflow` | `{ seller_id }` | → `terminated` (irreversible) |
+| `seller_member_id` | `string` | The membership id (`selmem_…`) |
+| `role_id` | `string` | A `SellerRole` value |
+
+- **Hooks**: none
+- **Events**: `seller_member.updated`
+
+## removeSellerMemberWorkflow
+
+Deletes a membership and keeps the `Member` record. Fails for the owner membership.
+
+| Input | Type | Description |
+| --- | --- | --- |
+| `seller_member_id` | `string` | The membership id |
+| `seller_id` | `string` | The store, included in the event payload |
+
+- **Hooks**: none
+- **Events**: `seller_member.deleted`
+
+## updateMemberWorkflow
 
-## Member workflows
+Updates the profile of every member that matches `selector`. Returns `MemberDTO[]`.
 
-| Workflow | Input | Purpose |
+| Input | Type | Description |
 | --- | --- | --- |
-| `inviteSellerWorkflow` | `{ email, seller_id }` | Create + send a member invite |
-| `acceptMemberInviteWorkflow` | `{ token }` | Accept an invite, link the member |
-| `addSellerMemberWorkflow` | `{ seller_id, member }` | Add a member directly |
-| `removeSellerMemberWorkflow` | `{ seller_id, member_id }` | Revoke access |
-| `updateMemberRoleWorkflow` | `{ id, role_id }` | Change a member's role |
+| `selector` | `Record<string, unknown>` | Filters, such as `{ id: "mem_01JD8Q1234567" }` |
+| `update` | `{ first_name?, last_name?, locale? }` | Profile fields |
+| `additional_data` | `Record<string, unknown>` | Optional, passed to hooks |
 
-To work with records directly instead of through a workflow, see the
-[Service reference](/platform/store/reference/service). To run side effects when
-a store changes, see the [Event reference](/platform/store/reference/events).
+- **Hooks**: `membersUpdated` (`{ members, additional_data }`)
+- **Events**: none

package/content/references/api/conventions.mdx

@@ -35,6 +35,26 @@ A handful of vendor routes are public by design: seller registration (`POST /ven
 
 Store routes are public. Customer authentication (session or bearer) is **required** for `/store/order-groups` and **optional** for `/store/offers` and `/store/products`, where it enriches the pricing context when present. Public seller routes only return sellers whose status is `open` and who are not inside a scheduled closure window.
 
+### With the client
+
+`@mercurjs/client` carries the credential for you. Pass `auth` once and every request resolves it fresh, so a token stored after login is picked up by the next call:
+
+```typescript
+import { createClient, adminAuth, vendorAuth, apiKeyAuth, publishableKeyAuth } from "@mercurjs/client"
+
+// inside the admin or vendor panel, or a plugin's dashboard code
+const admin = createClient({ baseUrl, auth: adminAuth() })
+const vendor = createClient({ baseUrl, auth: vendorAuth() })
+
+// a server-side integration with a secret API key
+const integration = createClient({ baseUrl, auth: apiKeyAuth(() => process.env.MERCUR_API_KEY) })
+
+// a storefront
+const store = createClient({ baseUrl, auth: publishableKeyAuth(() => publishableKey) })
+```
+
+`adminAuth()` and `vendorAuth()` read the same token stores the panels write on login (`adminTokenStore`, `vendorTokenStore`, `vendorSellerStore`), so dashboard extensions share the user's session without knowing a storage key. `createTokenStore(key)` builds your own store, falling back to memory where `localStorage` is unavailable. A `401` clears the bearer store unless you pass `onUnauthorized`.
+
 ## Pagination
 
 List endpoints use offset pagination with two query parameters:

package/content/resources/integrations/magento2.mdx

@@ -0,0 +1,162 @@
+---
+title: "Magento 2 marketplace integration"
+sidebarTitle: "Magento 2"
+description: "Turn your Magento 2 or Adobe Commerce store into a multi-vendor marketplace with Mercur. Install the connector, sync seller offers, and split each order per seller."
+---
+
+The Magento 2 connector lets a store you already run sell marketplace offers next to its own catalog. Magento keeps the storefront, cart, checkout, payment capture and your first-party products. Mercur keeps sellers, their offers, the split of one checkout into one order per seller, commission lines and payouts.
+
+The integration has two halves:
+
+- **`@mercurjs/magento2-connector-plugin`**, a plugin for your Mercur API that adds outbound webhooks, an external payment provider and a few admin routes
+- **`mercurjs/magento2-connector`**, a Composer package of Magento modules that mirrors sellers and offers into Magento and talks to Mercur during checkout
+
+<Tip>
+  This page is the setup guide. The connector's source, module layout and development workflow live in the [magento2-connector repository](https://github.com/mercurjs/magento2-connector).
+</Tip>
+
+## Quick start
+
+<Steps>
+  <Step title="Install the plugin in Mercur">
+    Add the plugin and register its payment provider in `medusa-config.ts`:
+
+    ```ts
+    module.exports = withMercur({
+      plugins: [
+        { resolve: "@mercurjs/magento2-connector-plugin", options: {} },
+      ],
+      modules: [
+        {
+          resolve: "@medusajs/medusa/payment",
+          options: {
+            providers: [
+              {
+                resolve: "@mercurjs/magento2-connector-plugin/providers/payment-external",
+                id: "external",
+              },
+            ],
+          },
+        },
+      ],
+    })
+    ```
+
+    Run `medusa db:migrate` afterwards. The provider is registered as `pp_external_external`; it records a payment Magento already captured instead of charging anyone.
+
+    Then enable it for the region your Magento website sells in: open the region in the Mercur admin and add **pp_external_external** to its payment providers. The shadow cart cannot complete without it.
+  </Step>
+  <Step title="Install the Magento package">
+    In your Magento root. The package is installed from its Git repository until it is published to Packagist, so add the repository first:
+
+    ```bash
+    composer config repositories.mercur vcs https://github.com/mercurjs/magento2-connector
+    composer require mercurjs/magento2-connector:dev-main
+    bin/magento module:enable Mercur_Core Mercur_Process Mercur_Connector \
+      Mercur_OfferIndexer Mercur_Catalog Mercur_Settlement Mercur_Frontend Mercur_GraphQl
+    # Only on stores that run Multi-Source Inventory:
+    bin/magento module:enable Mercur_Inventory
+    bin/magento setup:upgrade
+    bin/magento setup:di:compile
+    bin/magento cache:flush
+    ```
+  </Step>
+  <Step title="Get API details">
+    You need four values from Mercur:
+
+    - **Admin API key**: create a secret API key under **Settings → API keys**. If your deployment runs a roles module, bind it to a role that holds only the `integrations` permission; without one the key has full admin access, so treat it like an admin password
+    - **Publishable API key**: the publishable key of the sales channel the shadow cart is created in
+    - **Sales channel ID** and **Region ID**: the channel and the region whose prices the Magento website shows, one region per website
+  </Step>
+  <Step title="Connect Magento">
+    In Magento open **Stores → Configuration → Mercur → Marketplace** and enter the API URL and the four values above. Choose a best offer rule: lowest price, your own stock first, or premium sellers first.
+  </Step>
+  <Step title="Register the webhook">
+    In the Mercur admin open **Settings → Magento → Add endpoint**, enter `https://your_shop_domain/mercur/webhook`, keep every event selected, and copy the signing secret. The connector needs the fulfillment, shipment, delivery, return and refund events to keep orders in step. It is shown once. Paste it into the Magento configuration under **Webhooks → Signing secret**.
+  </Step>
+  <Step title="Run the first sync">
+    Push your taxonomy, then mirror everything:
+
+    ```bash
+    bin/magento mercur:sync taxonomy
+    bin/magento mercur:sync full
+    ```
+
+    Cron keeps the mirror current afterwards: sellers every 15 minutes, offers every 5 minutes, published products hourly, a full resync every night. Each run is a process under **Mercur → Processes** in the Magento admin.
+  </Step>
+</Steps>
+
+## How a mixed order flows
+
+A shopper buys one of your own products and one seller offer in the same checkout and pays once:
+
+1. The product page lists every active seller offer next to your own stock, with its price for that website, any price list strike-through, quantity tiers and an estimated delivery date. Adding an offer marks the cart line as a marketplace line priced by the offer and labels it "Sold by" the seller. The same works through REST and GraphQL with `mercur_offer_id`.
+2. The cart and the checkout group the marketplace lines by seller. Magento copies them into a shadow Mercur cart, asks Mercur for each seller's shipping options and lets the shopper pick one per seller; the sum is the "Seller shipping" total. Your own carriers only price your own lines, and a cart of seller lines only gets the "Shipped by the sellers" method.
+3. The shopper pays in Magento. The invoice includes seller shipping.
+4. After the order is placed, Magento records the capture on the external payment provider and completes the Mercur cart. Mercur answers with an order group, one order per seller, and Magento stores those ids on the order and its lines.
+5. Sellers fulfill in the vendor panel. Each shipped fulfillment becomes its own Magento shipment with its tracking numbers, so partial and multi-parcel deliveries show up as they happen. Deliveries, returns and cancellations update the line's marketplace status, shown to the shopper in their account and to you in the admin.
+6. Mercur computes commission lines when the cart completes and pays sellers from the recorded capture.
+
+If Mercur is unreachable at step 4, the Magento order still succeeds and the `order_retry` process completes the Mercur side on its next run.
+
+## Refunds
+
+| Starts in | What happens |
+| --- | --- |
+| Magento | A credit memo on marketplace lines is reported to Mercur per seller order, with seller shipping split by what each seller charged, so commission lines and payout balances follow |
+| Mercur, a seller or operator refund | Mercur sends `order.refund_requested`; Magento creates an adjustment credit memo and refunds the shopper online when the invoice was captured online |
+| Mercur, a canceled seller order | Magento refunds that seller's lines and shipping |
+
+A `refunds` process every 15 minutes picks up any refund whose webhook did not arrive.
+
+## Essential practices
+
+### One region per website
+
+Offer prices are read for the region configured on each Magento website, including Mercur price lists. A store with a US and an EU website needs two Mercur regions and two website-scoped values of **Mercur region ID**, and each website's base currency must match its region's currency.
+
+### Set delivery estimates
+
+Under **Mercur → Marketplace → Delivery estimates** set the order cut-off time, business days and transit days for each website. A Mercur shipping option can carry its own `transit_days_min` and `transit_days_max` in its data.
+
+### Keep the operator's stock as a candidate
+
+Your own product is always one of the ways to buy a SKU. The best offer rule decides whether it wins over a cheaper seller; `operator_first` keeps your stock on top whenever it is in stock.
+
+### Let webhooks drive, keep cron as the floor
+
+Offer, seller and product events enqueue the matching delta sync within a minute. The cron schedules exist so the mirror heals after a missed delivery; a full nightly resync removes anything a delta could not see.
+
+## Your products or seller offers
+
+| Situation | What happens |
+| --- | --- |
+| A product only you sell | A normal Magento line: your price, your stock, your carriers |
+| A product only sellers sell | Imported from Mercur, as a configurable product when its variant axes are Magento attributes; it is in stock while an offer is available and every line is a marketplace line |
+| A product both you and sellers sell | Same SKU, one buy box; the best offer rule picks the default and the shopper can choose another. When you run out, the product stays buyable from sellers |
+
+Each seller has a page at `/seller/{handle}` listing what they sell on your store. In the Magento admin, **Mercur → Sellers** and **Mercur → Offers** show the mirror, orders show each seller order with its status, and the product page lists the offers for that SKU.
+
+## Not supported yet
+
+- Buyer and seller messaging, order incidents and seller ratings
+- Documents sellers attach to orders
+- A third-party tax engine for seller lines; Magento taxes them with the product's tax class
+- Mercur promotions; Magento cart rules still apply to seller lines
+
+## Next steps
+
+<CardGroup cols={2}>
+  <Card title="Connector repository" icon="github" href="https://github.com/mercurjs/magento2-connector">
+    Modules, development workflow, and the webhook handler registry.
+  </Card>
+  <Card title="Offer module" icon="tag" href="/platform/offer/overview">
+    How offers carry seller SKU, price, inventory and shipping.
+  </Card>
+  <Card title="Order Group module" icon="layer-group" href="/platform/order-group/overview">
+    How one checkout becomes one order per seller.
+  </Card>
+  <Card title="Commission module" icon="percent" href="/platform/commission/overview">
+    How commission lines are computed at completion.
+  </Card>
+</CardGroup>

package/content/resources/integrations/overview.mdx

@@ -23,6 +23,16 @@ interface.
   </Card>
 </CardGroup>
 
+## Storefront platforms
+
+A storefront you already run can sell marketplace offers next to its own catalog. Mercur keeps sellers, offers, split orders, commissions and payouts; the platform keeps checkout and payment.
+
+<CardGroup cols={2}>
+  <Card title="Magento 2" icon="store" href="/resources/integrations/magento2">
+    Set up the Magento 2 connector.
+  </Card>
+</CardGroup>
+
 ## Blocks
 
 Other integrations ship as installable blocks. You add the block, own its source

package/content/resources/integrations/stripe-connect.mdx

@@ -21,7 +21,7 @@ This guide covers both. It walks through setting up Stripe, configuring both pro
 - A [Stripe account](https://dashboard.stripe.com) with Connect enabled
 - Stripe Secret API key and Publishable API key
 - A running Mercur project ([installation guide](/learn/introduction))
-- Node.js 20+
+- Node.js 22.22+
 
 ## Architecture overview
 

package/content/resources/tutorials/custom-api-route.mdx

@@ -54,14 +54,15 @@ A `GET /vendor/sales-summary` endpoint returns the seller's order count. You cal
     Codegen rewrites the generated `Routes` type that your panel apps already import:
 
     ```typescript apps/vendor/src/lib/client.ts
-    import { createClient, type InferClient } from "@mercurjs/client"
+    import { createClient, vendorAuth, type InferClient } from "@mercurjs/client"
     import type { Routes } from "@acme/api/_generated"
 
     declare const __BACKEND_URL__: string
 
     export const client: InferClient<Routes> = createClient({
       baseUrl: __BACKEND_URL__,
-      fetchOptions: { credentials: "include" },
+      fetchOptions: { credentials: "omit" },
+      auth: vendorAuth(),
     })
     ```