Complete Cart

POST

store

carts

{id}

complete

curl -X POST 'http://localhost:9000/store/carts/cart_01JB2KB1CD/complete' \
  -H 'x-publishable-api-key: pk_01JB2K3XYZ'

const result = await client.store.carts.$id.complete.mutate({ $id: "cart_01JB2KB1CD" })
if (result.type === "order_group") {
  console.log(result.order_group.id)
}

{
  "type": "order_group",
  "order_group": {
    "id": "og_01JB2KE7NP",
    "customer_id": "cus_01JB2KE8QR",
    "cart_id": "cart_01JB2KB1CD",
    "seller_count": 2,
    "total": 9900,
    "created_at": "2026-05-01T10:05:00.000Z",
    "updated_at": "2026-05-01T10:05:00.000Z"
  }
}

{
  "type": "cart",
  "cart": { "id": "cart_01JB2KB1CD", "total": 9900 },
  "error": {
    "message": "Payment authorization failed",
    "name": "Error",
    "type": "payment_authorization_error"
  }
}

Completes the cart with Mercur’s split-order workflow: items are grouped by seller, one order is created per seller, and all orders are attached to a single order group returned to the shopper.

On payment errors that need customer action (authorization failed or requires more), the route still returns 200 with type: "cart", the refreshed cart, and an error object; any other failure is thrown as an error response.

Path parameters

string

required

The cart’s ID.

Query parameters

string

Comma-separated fields to include on the returned order group; prefix with +/- to add to or remove from the defaults.

Response

string

order_group on success, cart when payment requires further action.

object

Present when type is order_group.

Show properties

string

The order group’s ID.

string

ID of the purchasing customer.

string

ID of the completed cart.

number

Number of per-seller orders created.

number

Combined total across all child orders.

string

Creation timestamp.

string

Last update timestamp.

object

Present when type is cart; the refreshed cart with items, totals, and payment collection.

object

Present when type is cart.

Show properties

string

The payment error message.

string

The error name.

string

One of payment_authorization_error or payment_requires_more_error.

curl -X POST 'http://localhost:9000/store/carts/cart_01JB2KB1CD/complete' \
  -H 'x-publishable-api-key: pk_01JB2K3XYZ'

const result = await client.store.carts.$id.complete.mutate({ $id: "cart_01JB2KB1CD" })
if (result.type === "order_group") {
  console.log(result.order_group.id)
}

{
  "type": "order_group",
  "order_group": {
    "id": "og_01JB2KE7NP",
    "customer_id": "cus_01JB2KE8QR",
    "cart_id": "cart_01JB2KB1CD",
    "seller_count": 2,
    "total": 9900,
    "created_at": "2026-05-01T10:05:00.000Z",
    "updated_at": "2026-05-01T10:05:00.000Z"
  }
}

{
  "type": "cart",
  "cart": { "id": "cart_01JB2KB1CD", "total": 9900 },
  "error": {
    "message": "Payment authorization failed",
    "name": "Error",
    "type": "payment_authorization_error"
  }
}

curl -X POST 'http://localhost:9000/store/carts/cart_01JB2KB1CD/complete' \
  -H 'x-publishable-api-key: pk_01JB2K3XYZ'

const result = await client.store.carts.$id.complete.mutate({ $id: "cart_01JB2KB1CD" })
if (result.type === "order_group") {
  console.log(result.order_group.id)
}

{
  "type": "order_group",
  "order_group": {
    "id": "og_01JB2KE7NP",
    "customer_id": "cus_01JB2KE8QR",
    "cart_id": "cart_01JB2KB1CD",
    "seller_count": 2,
    "total": 9900,
    "created_at": "2026-05-01T10:05:00.000Z",
    "updated_at": "2026-05-01T10:05:00.000Z"
  }
}

{
  "type": "cart",
  "cart": { "id": "cart_01JB2KB1CD", "total": 9900 },
  "error": {
    "message": "Payment authorization failed",
    "name": "Error",
    "type": "payment_authorization_error"
  }
}

Overview

Panel extensions

Admin API

Vendor API

Store API

Configuration

Path parameters

Query parameters

Response

​Path parameters

​Query parameters

​Response

Path parameters

Query parameters

Response