Order Create
The Order endpoint creates the order from the cart content
Path Parameters
- Type: stringcart
_id required
Headers
- Type: stringApplicationrequired
The
keyattribute of the application instance that sent the request - 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 device and/or client app that sent the request
- 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
- Properties: 6Type: objectcustomer
_info - Type: objectpayment
_info Properties: 6Required whenever the cart still has an amount left to pay. Pass the hash you received from the Payment Initialization call, so we can match the order to the payment you already started, together with whatever the payment method you initialized with produced.
- Type: array of objectsplit
_payment _info Properties: 6Pay with several methods at once, in the order the legs were initialized. At most four legs, and the amounts must add up to the amount due. Requires
is_split_payment_enabledon the brand.
Responses
- application/json
- 400
- Bad Request
- Cart not verified for checkout
- Cart payment initialization missing
- Cart contains unavailable products
- Venue ID=:venue_id, :venue_name is closed
- 404
Cart with provided ID could not be found.
curl 'https://api-public-demo.menu.app/api/cart/{cart_id}/order' \
--request POST \
--header 'Application: ' \
--header 'Api-Version: ' \
--header 'Device-UUID: ' \
--header 'X-MT-Idempotency-Key: f6fc2cb1-7338-44f7-9c05-1c3a9f0a6c8e' \
--header 'Content-Type: application/json' \
--data '{
"customer_info": {
"first_name": "Alex",
"last_name": "Rivera",
"email": "alex.rivera@example.com",
"phone_number": "+13125550143"
},
"payment_info": {
"payment_init_hash": "032878b199f90e13e1bdce036e00f157",
"one_time_token": "30910032626134340597000708770932",
"billing_zip_code": "60601"
}
}'
{
"status": "string",
"code": 1,
"data": {
"order": {
"id": 1,
"code": "string",
"uuid": "string",
"is_group": true,
"is_reorder": true,
"participants": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"display_name": "string",
"role": "string"
}
],
"type_id": 1,
"reference_type": "string",
"init_hash": "string",
"external_reference": null,
"external_code": null,
"external_channel_id": null,
"application_id": 1,
"application_info": {
"id": 1,
"key": "string",
"name": "string",
"uuid": "string",
"type_id": 1,
"brand_id": 1,
"created_at": "string",
"updated_at": "string",
"is_dpa_signed": 1,
"reference_type": "string"
},
"venue_id": 1,
"venue_info": {
"id": 1,
"name": "string",
"address": "string",
"city": "string",
"zip": "string",
"latitude": 1,
"longitude": 1,
"phone": "string",
"delivery_travel_type": "string",
"use_pos_order_number": true,
"timezone": {
"name": "string",
"offset": "string"
},
"tax_number": "string",
"pickup_time": 1,
"image": null,
"country": {
"id": 1,
"name": "string",
"code": "string",
"calling_code": "string",
"currency_settings": {
"currency_space": true,
"decimal_separator": "string",
"thousands_separator": "string",
"symbol_position": "string"
}
},
"currency": {
"id": 1,
"code": "string",
"code_numeric": "string",
"symbol": "string",
"rounding_unit": 1,
"rounding_unit_tip": 1
},
"dispatch_legacy": true
},
"singular_point_id": 1,
"singular_point_info": {
"id": 1,
"input": {
"id": 1,
"name": "string",
"singular_point_id": 1
},
"input_id": 1,
"area_info": {
"id": 1,
"name": "string",
"pos_id": null,
"type_id": 1,
"reference_type": "string"
},
"parent_id": 1,
"created_at": null,
"input_type": "string",
"table_info": {
"id": 1,
"number": "string",
"pos_id": null
},
"parent_type": "string"
},
"pos_ticket_id": "string",
"pos_ticket_code": "string",
"customer_account_id": 1,
"customer_account_info": {
"id": 1,
"uuid": "string",
"email": "string",
"state": 1,
"locale": "string",
"type_id": 1,
"brand_id": 1,
"v2_token": null,
"confirmed": 1,
"last_name": "string",
"created_at": "string",
"first_name": "string",
"updated_at": "string",
"customer_id": null,
"demographics": [
{}
],
"phone_number": "string",
"is_dpa_signed": 1,
"discount_cards": [
{}
],
"reference_type": "string",
"optin_status_pn": 1,
"optin_status_sms": 1,
"optin_status_email": 1,
"created_by_application_id": 1,
"optin_status_sms_internal": 1
},
"order_type": 1,
"order_type_info": {
"id": 1,
"uuid": "string",
"state": 1,
"tip_max": null,
"type_id": 1,
"venue_id": 1,
"created_at": "string",
"updated_at": "string",
"tip_default": null,
"is_dpa_signed": 1,
"reference_type": "string",
"external_channel_only": 1
},
"order_type_properties": {
"type_id": 1,
"table_id": "string"
},
"order_additional_info": {
"pos_wait_until_paid": true
},
"is_scheduled": true,
"trigger_type": 1,
"status": "string",
"status_changed_by": "string",
"payment_status": "string",
"fraud_detection_status": null,
"fiscal_status": null,
"fiscalization_number": null,
"tablet_status": "string",
"delivery_status": null,
"is_test": true,
"calculation_method": "string",
"subtotal": 1,
"discount": 1,
"subsidy": 1,
"external_payment_amount": 1,
"discount_info": null,
"service_charge": 1,
"service_charge_rate": 1,
"service_charge_tax_rate": 1,
"delivery_fee_tax_rate": 1,
"delivery_fee": 1,
"delivery_fee_tax": 1,
"minimal_order_amount": 1,
"minimum_surcharge": 1,
"minimum_surcharge_tax": 1,
"tip": 1,
"tip_rate": 1,
"total": 1,
"tax": 1,
"tax_exemption": 1,
"tax_rates": [
{}
],
"tax_rates_exemption": [
{}
],
"refunded": 1,
"products": [
{
"pos_id": null,
"name": "string",
"translations": {
"name": null
},
"price": 1,
"quantity": 1,
"subtotal": 1,
"tax": 1,
"tax_rates": [
{}
],
"comment": "string",
"image": {
"thumbnail_small": "string",
"thumbnail_medium": "string",
"fullsize": "string"
},
"product_groups": [
{
"group_type": 1,
"pos_id": null,
"name": "string",
"translations": {
"name": null
},
"subtotal": 1,
"tax": 1,
"tax_rates": [
{}
],
"image": {
"thumbnail_small": "string",
"thumbnail_medium": "string",
"fullsize": "string"
},
"products": [
{
"pos_id": null,
"name": "string",
"translations": {
"name": null
},
"price": 1,
"quantity": 1,
"subtotal": 1,
"tax": 1,
"tax_rates": [
{}
],
"comment": "string",
"image": {
"thumbnail_small": "string",
"thumbnail_medium": "string",
"fullsize": "string"
}
}
]
}
]
}
],
"payments": [
{
"id": 1,
"payment_method_id": 1,
"payment_processor_type_id": 1,
"payment_processor_id": null,
"total": 1,
"pos_receipt_id": "string",
"stored_payment_method_vault": null
}
],
"refunds": [
{}
],
"pickup_code": null,
"preparation_time": 1,
"additional_delivery_info": null,
"delivery_delay_time": null,
"is_customer_arrived": true,
"is_status_fired": true,
"cancellation_reason_id": null,
"delivery_job": {},
"regret_cancel_until": null,
"send_at": "string",
"pickup_at": null,
"ready_at": null,
"arriving_at": null,
"delivery_at": null,
"created_at": "string",
"updated_at": "string"
}
}
}