Group Cart Order Create

​

Places the group order. One order is created for the whole group, with is_group set to true, a participants list, and participant_id on each line so you can show who ordered what.

This call is idempotent on X-MT-Idempotency-Key. Generate a UUID before the first attempt and retry with the same value rather than a new one — that is how a group avoids being charged twice.

Afterward the session is placed, the invite token is cleared and every participant is marked completed. The session cannot be reused.

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.

  • The identifier of the device and/or client app that sent the request

  • Required even on requests with no body

  • Bearer token of the signed-in customer

  • Makes this call safe to retry. Generate a UUID before the first attempt and send the same value again on every retry; we keep the result for 15 minutes and replay it rather than placing a second order.

    Declared optional because the call works without it, not because it is safe to leave out — a timed-out order that you retry without a key is how a customer gets charged twice. See Retrying safely.

  • 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
  • The host's contact details for the order.

  • The payment_init_hash from the group payment initialization, plus whatever the payment method produced.

    Properties: 2

Responses

  • The order, with is_group true and the participant roster attached.

  • 1203 nothing to pay · 1204 not the host · 1220 the checkout is stale

  • Unknown group cart.

Request Example for post/group-cart/{group_cart_uuid}/order
curl https://api-public-demo.menu.app/api/group-cart/7c9e6679-f1e4-40b3-a2c5-e8f1a0b9d4c3/order \
  --request POST \
  --header 'Application: ' \
  --header 'Api-Version: ' \
  --header 'Device-UUID: ' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: ' \
  --header 'X-MT-Idempotency-Key: f6fc2cb1-7338-44f7-9c05-1c3a9f0a6c8e' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "customer_info": {},
  "payment_info": {
    "payment_init_hash": "",
    "one_time_token": ""
  }
}'
No Body