Group Cart Payment Initialization

Initializes payment for the whole group order. The host pays once for everything — there is no per-participant payment and no splitting between participants.

The request and the response are identical to the personal cart's Payment Initialization, including actions, additional_info and expires_in, so everything in Make a Payment applies unchanged.

Once a payment exists the session is frozen: unlocking, checking out again, removing participants and editing slices all return 1206. If the customer abandons the payment, cancel the session or start again.

Path Parameters

group_cart_uuid
Type: stringFormat: uuid
required

UUID of the group cart session

Headers

Application
Type: string
required

White Label Application Key
Api-Version
Type: string
required

Version of the API that the client app expects
Device-UUID
Type: string
required

The identifier of the device and/or client app that sent the request
Content-Type
Type: string
required

Required even on requests with no body
Authorization
Type: string
required

Bearer token of the signed-in customer

Body

required

application/json

payment_info
Type: object
required
Properties: 3

Responses

200

Payment initialized. Same envelope as the personal cart.
400

1203 nothing to pay · 1204 not the host · 1220 the checkout is stale, check out again
404

Unknown group cart.

post/group-cart/{group_cart_uuid}/payments/init

curl https://api-public-demo.menu.app/api/group-cart/7c9e6679-f1e4-40b3-a2c5-e8f1a0b9d4c3/payments/init \
  --request POST \
  --header 'Application: ' \
  --header 'Api-Version: 4.78.0' \
  --header 'Device-UUID: ' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: ' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "payment_info": {
    "payment_method_id": "",
    "stored_payment_method_id": "",
    "amount": 1
  }
}'

No Body

Payment initialized. Same envelope as the personal cart.