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
- Type: stringFormat: uuidgroup
_cart _uuid requiredUUID of the group cart session
Headers
- Type: stringApplicationrequired
White Label Application Key
- Type: stringApi
- Version requiredThe release version your integration was built against — see Versioning in API Basics.
- Type: stringDevice
- U U I D requiredThe identifier of the device and/or client app that sent the request
- Type: stringContent
- Type requiredRequired even on requests with no body
- Type: stringAuthorizationrequired
Bearer token of the signed-in customer
- Type: stringFormat: uuidX
- M T - Idempotency - Key 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.
- Type: stringDlc
- Authorization Punchh customer token, on a brand integrated with Punchh.
Authorizationdoes 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
- Type: objectcustomer
_info The host's contact details for the order.
- Type: objectpayment
_info Properties: 2The
payment_init_hashfrom the group payment initialization, plus whatever the payment method produced.
Responses
- 200
The order, with
is_grouptrue and the participant roster attached. - 400
1203nothing to pay ·1204not the host ·1220the checkout is stale - 404
Unknown group cart.
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": ""
}
}'
