Cart Transfer Venue

Moves an existing cart to a different store, so a customer whose chosen store turns out to be closed, or who cannot be delivered to, does not have to rebuild their basket.

Pass order_type as well when it is changing at the same time. For a Dine-in (FS) table that is order type 1 with order_type.properties.table_id set to the table's UUID, taken from the area's tables — not a table number.

Every price_id in the cart changes. Prices belong to a store, so the response comes back with a new price_id on every line. Use the products from this response for the next update or checkout — replaying an older cart payload will fail, because those price ids do not exist at the new store.

Items the new store does not carry are dropped, so compare the returned cart against what the customer had and tell them what is missing.

Path Parameters

cart_id
Type: string
required

Body

required

application/json

venue_id
Type: stringFormat: uuid
required

UUID of the store to move the cart to.
order_type
Type: object

Send this when the order type changes as part of the move.

Properties: 2

Responses

200

The cart at its new store, with new price_id values throughout.
400

The new store cannot take this cart — it does not offer the order type, or it cannot deliver to the address.
404

Cart with provided ID could not be found.

post/cart/{cart_id}/transfer-venue

curl 'https://api-public-demo.menu.app/api/cart/{cart_id}/transfer-venue' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "venue_id": "8d2f2c42-2f1e-4a3c-9a1e-2c4c9f0d7f11"
}'

No Body

The cart at its new store, with new price_id values throughout.