Group Cart Update My Cart

​

Replaces the caller's slice — the group equivalent of PUT /cart/{cart_id}. Send the whole slice, not a delta.

It only works while the session is open and the participant is not ready: a ready participant gets 1212 and has to reopen first. Guests are held to max_amount_per_participant if the host set one, and going over returns 1211.

Discounts and donations belong to the order as a whole, so only the host's slice may carry them; a guest sending them gets 1204.

Path Parameters

  • UUID of the group cart session

Headers

  • White Label Application Key

  • The release version your integration was built against — see Versioning in API Basics.

  • Required even on requests with no body

  • The participant_access_token returned when this participant joined or created the session

  • Bearer token of the signed-in customer. Omit it for an anonymous guest

  • Punchh customer token, on a brand integrated with Punchh. Authorization does not authenticate you to Punchh. Send it on every cart call for a signed-in registered customer — any cart with items triggers a loyalty calculation, with or without a discount — and for a guest only when the cart carries a reward, offer, credit or promo code. Omitting it falls back to the token stored for that customer at sign-in, which may be stale.

    Declared optional because it is conditional, not because it is safe to leave out. It applies only to a Punchh brand, so marking it required would be wrong for every brand without the integration. See Use Rewards, Offers, Customer Credits, and Promo Codes.

Body·

required
application/json
  • Properties: 4

Responses

  • The updated slice, including metadata.group_session.

  • 1204 discounts or donations sent by a guest · 1206 the session is locked or expired · 1211 over the per-guest cap · 1212 mark yourself not ready first · 1218 conflicts with a restored manager discount

  • The participant token is missing.

  • Validation failed.

Request Example for put/group-cart/{group_cart_uuid}/my-cart
curl https://api-public-demo.menu.app/api/group-cart/7c9e6679-f1e4-40b3-a2c5-e8f1a0b9d4c3/my-cart \
  --request PUT \
  --header 'Application: ' \
  --header 'Api-Version: ' \
  --header 'Content-Type: application/json' \
  --header 'X-Mt-Group-Participant-Token: ' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "cart": {
    "products": [
      {}
    ],
    "tip": {
      "amount": 1,
      "type": 1
    },
    "discounts": [
      {}
    ],
    "donations": [
      {}
    ]
  }
}'
No Body