@mercurjs/docs 2.2.0-canary.40

package/content/references/api/admin/sellers/upsert-seller-address.mdx

@@ -0,0 +1,91 @@
+---
+title: "Upsert Seller Address"
+api: "POST /admin/sellers/{id}/address"
+description: "Create or update a seller's address."
+---
+
+Creates the seller's address if none exists, otherwise updates it.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The seller's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+
+## Body parameters
+
+<ParamField body="name" type="string">Label for the address.</ParamField>
+<ParamField body="company" type="string">Company name.</ParamField>
+<ParamField body="first_name" type="string">First name of the contact person.</ParamField>
+<ParamField body="last_name" type="string">Last name of the contact person.</ParamField>
+<ParamField body="address_1" type="string">First address line.</ParamField>
+<ParamField body="address_2" type="string">Second address line.</ParamField>
+<ParamField body="city" type="string">City.</ParamField>
+<ParamField body="country_code" type="string">Two-letter ISO country code.</ParamField>
+<ParamField body="province" type="string">Province or state.</ParamField>
+<ParamField body="postal_code" type="string">Postal code.</ParamField>
+<ParamField body="phone" type="string">Phone number for the address.</ParamField>
+<ParamField body="metadata" type="object">Custom key-value data.</ParamField>
+<ParamField body="additional_data" type="object">Extra data passed to workflow hooks.</ParamField>
+
+## Response
+
+<ResponseField name="seller" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The seller's ID.</ResponseField>
+    <ResponseField name="address" type="object">
+      <Expandable title="properties">
+        <ResponseField name="address_1" type="string">First address line.</ResponseField>
+        <ResponseField name="city" type="string">City.</ResponseField>
+        <ResponseField name="country_code" type="string">Two-letter ISO country code.</ResponseField>
+        <ResponseField name="postal_code" type="string">Postal code.</ResponseField>
+      </Expandable>
+    </ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/address' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "address_1": "123 Market St",
+    "city": "San Francisco",
+    "country_code": "us",
+    "postal_code": "94103"
+  }'
+```
+
+```ts JS Client
+const { seller } = await client.admin.sellers.$id.address.mutate({
+  $id: "sel_01HXYZABCDEF",
+  address_1: "123 Market St",
+  city: "San Francisco",
+  country_code: "us",
+  postal_code: "94103",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "seller": {
+    "id": "sel_01HXYZABCDEF",
+    "name": "Acme",
+    "status": "open",
+    "address": {
+      "address_1": "123 Market St",
+      "city": "San Francisco",
+      "country_code": "us",
+      "postal_code": "94103"
+    },
+    "updated_at": "2026-06-12T10:30:00.000Z"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin.mdx

@@ -0,0 +1,134 @@
+---
+title: "Admin API"
+description: "Operator routes under /admin/* — sellers, commissions, payouts, master catalog, and marketplace-wide orders."
+---
+
+The Admin API is the marketplace operator's surface. It extends Medusa's standard admin routes with the marketplace domains below; everything else (regions, currencies, users, API keys, …) comes from Medusa core unchanged.
+
+Authentication and shared conventions are covered in [API conventions](/rc/references/api/conventions).
+
+## Sellers
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` `POST` | `/admin/sellers` | List sellers / create a seller |
+| `GET` `POST` | `/admin/sellers/:id` | Retrieve / update a seller |
+| `POST` | `/admin/sellers/:id/approve` | Approve a pending seller |
+| `POST` | `/admin/sellers/:id/suspend` | Suspend a seller |
+| `POST` | `/admin/sellers/:id/unsuspend` | Lift a suspension |
+| `POST` | `/admin/sellers/:id/terminate` | Terminate a seller |
+| `POST` | `/admin/sellers/:id/unterminate` | Reverse a termination |
+| `POST` | `/admin/sellers/:id/address` | Upsert the seller address |
+| `POST` | `/admin/sellers/:id/payment-details` | Upsert payment details |
+| `POST` `DELETE` | `/admin/sellers/:id/professional-details` | Upsert / remove professional details |
+| `GET` | `/admin/sellers/:id/products` | List the seller's products |
+
+### Members and invites
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` | `/admin/members` | List members across all sellers |
+| `GET` `POST` | `/admin/sellers/:id/members` | List / add a member |
+| `DELETE` | `/admin/sellers/:id/members/:member_id` | Remove a member |
+| `POST` | `/admin/sellers/:id/members/invite` | Invite a member |
+| `GET` | `/admin/sellers/:id/members/invites` | List pending invites |
+| `DELETE` | `/admin/sellers/:id/members/invites/:invite_id` | Revoke an invite |
+| `POST` | `/admin/sellers/:id/members/invites/:invite_id/resend` | Resend an invite |
+
+## Commission rates
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` `POST` | `/admin/commission-rates` | List rates (supports the `scope_type` filter) / create a rate |
+| `GET` `POST` `DELETE` | `/admin/commission-rates/:id` | Retrieve / update / delete a rate |
+| `POST` | `/admin/commission-rates/:id/rules` | Batch add and remove rules on a rate |
+
+## Payouts
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` | `/admin/payouts` | List payouts across the marketplace |
+| `GET` | `/admin/payouts/:id` | Retrieve a payout |
+
+## Products (master catalog)
+
+Products are shared catalog records — see the [master products model](/rc/references/modules/product-edit#the-master-products-model).
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` `POST` | `/admin/products` | List / create a product (`seller_ids` sets selling eligibility) |
+| `GET` `POST` `DELETE` | `/admin/products/:id` | Retrieve / update / delete a product |
+| `GET` | `/admin/products/:id/preview` | Preview the product with pending changes applied |
+| `POST` | `/admin/products/:id/confirm` | Confirm the pending change |
+| `POST` | `/admin/products/:id/reject` | Reject the pending change |
+| `POST` | `/admin/products/:id/request-changes` | Send a change back to the seller for action |
+| `POST` | `/admin/products/:id/sellers` | Set the selling-eligibility allowlist |
+| `POST` | `/admin/products/:id/attributes/batch` | Batch add / update / remove product attributes |
+| `GET` `POST` | `/admin/products/:id/variants` | List / create variants |
+| `GET` `POST` `DELETE` | `/admin/products/:id/variants/:variant_id` | Retrieve / update / delete a variant |
+
+### Product changes
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `POST` | `/admin/product-changes/:id/confirm` | Confirm a change request directly |
+| `POST` | `/admin/product-changes/:id/cancel` | Cancel a change request |
+
+## Offers
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` | `/admin/offers` | List offers (supports `group_by_seller`) |
+| `GET` `DELETE` | `/admin/offers/:id` | Retrieve / delete an offer |
+| `POST` | `/admin/offers/batch` | Batch create offers |
+
+## Product attributes
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` `POST` | `/admin/product-attributes` | List / create attributes |
+| `GET` `POST` `DELETE` | `/admin/product-attributes/:id` | Retrieve / update / delete an attribute |
+| `POST` | `/admin/product-attributes/:id/values` | Create a value |
+| `POST` `DELETE` | `/admin/product-attributes/:id/values/:value_id` | Update / delete a value |
+
+## Categories and collections
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` `POST` | `/admin/product-categories` | List / create categories (with media + icon) |
+| `GET` `POST` `DELETE` | `/admin/product-categories/:id` | Retrieve / update / delete a category |
+| `POST` | `/admin/product-categories/:id/products` | Batch link products |
+| `POST` | `/admin/product-categories/:id/sellers` | Batch link sellers |
+| `GET` `POST` | `/admin/collections` | List / create collections (with media + icon) |
+| `GET` `POST` `DELETE` | `/admin/collections/:id` | Retrieve / update / delete a collection |
+
+## Orders and order groups
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `GET` | `/admin/orders` | List all orders across sellers |
+| `GET` | `/admin/orders/:id/commission-lines` | Commission lines computed for an order |
+| `GET` | `/admin/orders/:id/order-group` | The order group an order belongs to |
+| `GET` | `/admin/order-groups` | List order groups |
+| `GET` | `/admin/order-groups/:id` | Retrieve an order group with its child orders |
+
+### Order edits, claims, exchanges, returns
+
+Mercur extends the Medusa RMA routes so they respect seller boundaries:
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `POST` | `/admin/order-edits/:id/items` | Add items to an order edit |
+| `POST` | `/admin/order-edits/:id/confirm` | Confirm an order edit |
+| `POST` | `/admin/claims/:id/outbound/items` | Add outbound items to a claim |
+| `POST` `DELETE` | `/admin/claims/:id/request` | Request / cancel a claim |
+| `POST` | `/admin/exchanges/:id/outbound/items` | Add outbound items to an exchange |
+| `POST` `DELETE` | `/admin/exchanges/:id/request` | Request / cancel an exchange |
+| `POST` | `/admin/returns/:id/receive/confirm` | Confirm receipt of a return |
+
+## Next steps
+
+<CardGroup cols={2}>
+  <Card title="Vendor API" href="/rc/references/api/vendor" />
+  <Card title="API Client" href="/rc/tools/api-client" />
+</CardGroup>

package/content/references/api/conventions.mdx

@@ -0,0 +1,109 @@
+---
+title: "API conventions"
+description: "Authentication, seller scoping, pagination, field selection, and webhooks — shared by every Mercur API surface."
+---
+
+Mercur exposes three HTTP surfaces on the Medusa server. They share the same conventions for authentication, pagination, and field selection.
+
+| Surface | Base path | Audience | Authentication |
+| --- | --- | --- | --- |
+| [Admin API](/rc/references/api/admin) | `/admin/*` | Marketplace operator | Medusa admin user (session or bearer) |
+| [Vendor API](/rc/references/api/vendor) | `/vendor/*` | Sellers | Member auth + seller scoping (below) |
+| [Store API](/rc/references/api/store) | `/store/*` | Storefront | Mostly public; customer auth where noted |
+
+All requests and responses are JSON. The recommended way to call these APIs is the typed [`@mercurjs/client`](/rc/tools/api-client) — every route below maps 1:1 to a client call.
+
+## Authentication
+
+### Admin
+
+Admin routes use standard Medusa admin authentication — log in via `/auth/user/emailpass`, then send the session cookie or a `Authorization: Bearer <token>` header.
+
+### Vendor
+
+Vendor routes authenticate the **member** actor (`/auth/member/emailpass` to obtain a token) and are additionally scoped to a single seller:
+
+1. The request must carry an `x-seller-id` header (or a seller selected in the session via `POST /vendor/sellers/select`).
+2. Middleware verifies the authenticated member belongs to that seller and populates the request's seller context — every query and mutation on the surface is automatically filtered to that seller.
+3. The member's RBAC roles are resolved for the selected seller.
+
+A handful of vendor routes are public by design: seller registration (`POST /vendor/sellers`), invite acceptance (`POST /vendor/members/invites/accept`), `GET /vendor/stores`, and `GET /vendor/feature-flags`.
+
+### Store
+
+Store routes are public. Customer authentication (session or bearer) is **required** for `/store/order-groups` and **optional** for `/store/offers`, `/store/products`, and `/store/search` (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.
+
+## Pagination
+
+List endpoints use offset pagination with two query parameters:
+
+```
+GET /admin/sellers?limit=20&offset=40
+```
+
+| Parameter | Description | Default |
+| --- | --- | --- |
+| `limit` | Maximum number of records to return | 50 for most routes (some use 10, 20, or 200) |
+| `offset` | Number of records to skip | 0 |
+
+Every list response carries the paging envelope alongside the records:
+
+```json
+{
+  "sellers": [ ... ],
+  "count": 133,
+  "offset": 40,
+  "limit": 20
+}
+```
+
+`count` is the total number of records matching the filters, so `offset + limit < count` means more pages exist.
+
+## Field selection
+
+List and detail endpoints accept a `fields` query parameter to control which fields and relations are returned:
+
+```
+GET /vendor/products?fields=id,title,+variants.sku,-description
+```
+
+- `+field` adds a field or relation **on top of** the route's defaults.
+- `-field` removes one from the defaults.
+- A bare `field` (no prefix) **replaces** the default set entirely.
+
+<Warning>
+  Mixing one unprefixed field into an otherwise-prefixed list switches the
+  whole parameter to replace mode and silently drops the route defaults.
+  Prefix every entry with `+` or `-` when you mean to merge.
+</Warning>
+
+## Filtering and ordering
+
+List endpoints accept entity-specific filter parameters (documented per route group), a free-text `q` search parameter where the entity has searchable fields, and `order` for sorting (`order=-created_at` for descending).
+
+## Errors
+
+Errors follow Medusa's format:
+
+```json
+{
+  "type": "invalid_data",
+  "message": "Seller with handle already exists"
+}
+```
+
+Common types: `invalid_data` (400), `unauthorized` (401), `not_allowed` (403), `not_found` (404). The typed client throws these as `ClientError`.
+
+## Webhooks
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `POST` | `/hooks/payout` | Payout provider webhook receiver. The registered provider (e.g. Stripe Connect) verifies the signature and resolves the event into a payout action. |
+
+## Next steps
+
+<CardGroup cols={3}>
+  <Card title="Admin API" href="/rc/references/api/admin" />
+  <Card title="Vendor API" href="/rc/references/api/vendor" />
+  <Card title="Store API" href="/rc/references/api/store" />
+</CardGroup>

package/content/references/api/store/carts/add-line-item.mdx

@@ -0,0 +1,115 @@
+---
+title: "Add Line Item"
+api: "POST /store/carts/{id}/line-items"
+description: "Add a seller offer to the cart as a line item."
+---
+
+Adds an item to the cart by offer — Mercur resolves the offer's variant and stamps the `offer_id` on the line item so the cart can later split into per-seller orders.
+
+<Note>
+  Unlike vanilla Medusa, this route takes an `offer_id` instead of a `variant_id`; an unknown offer returns a `404`.
+</Note>
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The cart's ID.
+</ParamField>
+
+## Body parameters
+
+<ParamField body="offer_id" type="string" required>
+  ID of the offer to add.
+</ParamField>
+
+<ParamField body="quantity" type="number" required>
+  Quantity to add; must be a positive integer.
+</ParamField>
+
+<ParamField body="unit_price" type="number">
+  Custom unit price overriding the offer's calculated price.
+</ParamField>
+
+<ParamField body="compare_at_unit_price" type="number">
+  Compare-at unit price shown as the original price.
+</ParamField>
+
+<ParamField body="metadata" type="object">
+  Custom key-value data stored on the line item; `offer_id` is merged in automatically.
+</ParamField>
+
+<ParamField body="additional_data" type="object">
+  Data passed to the add-to-cart workflow's hooks.
+</ParamField>
+
+## Response
+
+<ResponseField name="cart" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The cart's ID.</ResponseField>
+    <ResponseField name="currency_code" type="string">The cart's currency.</ResponseField>
+    <ResponseField name="region_id" type="string">The cart's region.</ResponseField>
+    <ResponseField name="email" type="string | null">The customer's email.</ResponseField>
+    <ResponseField name="items" type="object[]">Line items, each carrying `offer_id` in its `metadata`.</ResponseField>
+    <ResponseField name="shipping_methods" type="object[]">Selected shipping methods.</ResponseField>
+    <ResponseField name="promotions" type="object[]">Applied promotions.</ResponseField>
+    <ResponseField name="shipping_address" type="object | null">The shipping address.</ResponseField>
+    <ResponseField name="billing_address" type="object | null">The billing address.</ResponseField>
+    <ResponseField name="payment_collection" type="object | null">The cart's payment collection with its sessions.</ResponseField>
+    <ResponseField name="total" type="number">Cart total including tax and shipping.</ResponseField>
+    <ResponseField name="subtotal" type="number">Cart subtotal.</ResponseField>
+    <ResponseField name="tax_total" type="number">Total tax amount.</ResponseField>
+    <ResponseField name="discount_total" type="number">Total discount amount.</ResponseField>
+    <ResponseField name="shipping_total" type="number">Total shipping amount.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/store/carts/cart_01JB2KB1CD/line-items' \
+  -H 'Content-Type: application/json' \
+  -H 'x-publishable-api-key: pk_01JB2K3XYZ' \
+  -d '{"offer_id": "offer_01JB2K6G5H", "quantity": 1}'
+```
+
+```ts JS Client
+const { cart } = await client.store.carts.$id.lineItems.mutate({
+  $id: "cart_01JB2KB1CD",
+  offer_id: "offer_01JB2K6G5H",
+  quantity: 1,
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "cart": {
+    "id": "cart_01JB2KB1CD",
+    "currency_code": "eur",
+    "region_id": "reg_01JB2K4S1T",
+    "email": null,
+    "items": [
+      {
+        "id": "cali_01JB2KB3EF",
+        "title": "M",
+        "product_title": "Linen Shirt",
+        "quantity": 1,
+        "unit_price": 4500,
+        "metadata": { "offer_id": "offer_01JB2K6G5H" }
+      }
+    ],
+    "shipping_methods": [],
+    "promotions": [],
+    "shipping_address": null,
+    "billing_address": null,
+    "payment_collection": null,
+    "total": 4500,
+    "subtotal": 4500,
+    "tax_total": 0,
+    "discount_total": 0,
+    "shipping_total": 0
+  }
+}
+```
+</ResponseExample>

package/content/references/api/store/carts/add-shipping-methods.mdx

@@ -0,0 +1,84 @@
+---
+title: "Add Shipping Method"
+api: "POST /store/carts/{id}/shipping-methods"
+description: "Add a seller shipping option to the cart."
+---
+
+Adds the chosen shipping option to the cart through Mercur's seller-aware workflow, so each seller's items can carry their own shipping method.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The cart's ID.
+</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">
+  Comma-separated fields and relations to include on the returned cart; prefix with `+`/`-` to add to or remove from the defaults.
+</ParamField>
+
+## Body parameters
+
+<ParamField body="option_id" type="string" required>
+  ID of the shipping option to add.
+</ParamField>
+
+<ParamField body="data" type="object">
+  Provider-specific data forwarded to the fulfillment provider.
+</ParamField>
+
+<ParamField body="additional_data" type="object">
+  Data passed to the workflow's hooks.
+</ParamField>
+
+## Response
+
+<ResponseField name="cart" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The cart's ID.</ResponseField>
+    <ResponseField name="currency_code" type="string">The cart's currency.</ResponseField>
+    <ResponseField name="items" type="object[]">Line items in the cart.</ResponseField>
+    <ResponseField name="shipping_methods" type="object[]">Shipping methods with `shipping_option_id`, `amount`, and tax lines.</ResponseField>
+    <ResponseField name="shipping_total" type="number">Total shipping amount.</ResponseField>
+    <ResponseField name="total" type="number">Cart total including tax and shipping.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/store/carts/cart_01JB2KB1CD/shipping-methods' \
+  -H 'Content-Type: application/json' \
+  -H 'x-publishable-api-key: pk_01JB2K3XYZ' \
+  -d '{"option_id": "so_01JB2KC4GH"}'
+```
+
+```ts JS Client
+const { cart } = await client.store.carts.$id.shippingMethods.mutate({
+  $id: "cart_01JB2KB1CD",
+  option_id: "so_01JB2KC4GH",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "cart": {
+    "id": "cart_01JB2KB1CD",
+    "currency_code": "eur",
+    "items": [{ "id": "cali_01JB2KB3EF", "quantity": 1, "unit_price": 4500 }],
+    "shipping_methods": [
+      {
+        "shipping_option_id": "so_01JB2KC4GH",
+        "amount": 900,
+        "is_tax_inclusive": false,
+        "tax_lines": []
+      }
+    ],
+    "shipping_total": 900,
+    "total": 5400
+  }
+}
+```
+</ResponseExample>

package/content/references/api/store/carts/apply-promotions.mdx

@@ -0,0 +1,83 @@
+---
+title: "Apply Promotions"
+api: "POST /store/carts/{id}/promotions"
+description: "Apply promotion codes to the cart."
+---
+
+Applies promotion codes through Mercur's seller-aware workflow so seller-scoped promotions only adjust that seller's items; sending an empty array replaces (clears) the applied codes.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The cart's ID.
+</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">
+  Comma-separated fields and relations to include on the returned cart; prefix with `+`/`-` to add to or remove from the defaults.
+</ParamField>
+
+## Body parameters
+
+<ParamField body="promo_codes" type="string[]" required>
+  Promotion codes to add; an empty array removes all applied codes.
+</ParamField>
+
+## Response
+
+<ResponseField name="cart" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The cart's ID.</ResponseField>
+    <ResponseField name="promotions" type="object[]">Applied promotions with `code` and `application_method`.</ResponseField>
+    <ResponseField name="items" type="object[]">Line items with their promotion `adjustments`.</ResponseField>
+    <ResponseField name="discount_total" type="number">Total discount amount.</ResponseField>
+    <ResponseField name="total" type="number">Cart total after discounts.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/store/carts/cart_01JB2KB1CD/promotions' \
+  -H 'Content-Type: application/json' \
+  -H 'x-publishable-api-key: pk_01JB2K3XYZ' \
+  -d '{"promo_codes": ["SUMMER10"]}'
+```
+
+```ts JS Client
+const { cart } = await client.store.carts.$id.promotions.mutate({
+  $id: "cart_01JB2KB1CD",
+  promo_codes: ["SUMMER10"],
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "cart": {
+    "id": "cart_01JB2KB1CD",
+    "promotions": [
+      {
+        "id": "promo_01JB2KD5JK",
+        "code": "SUMMER10",
+        "is_automatic": false,
+        "application_method": { "type": "percentage", "value": 10, "currency_code": "eur" }
+      }
+    ],
+    "items": [
+      {
+        "id": "cali_01JB2KB3EF",
+        "quantity": 1,
+        "unit_price": 4500,
+        "adjustments": [
+          { "id": "caadj_01JB2KD6LM", "code": "SUMMER10", "promotion_id": "promo_01JB2KD5JK", "amount": 450 }
+        ]
+      }
+    ],
+    "discount_total": 450,
+    "total": 4950
+  }
+}
+```
+</ResponseExample>