Submit Order

Submits a validated order to the POS system for processing. PAR calls this endpoint to submit orders after successful validation.

Status Values

placed - Order successfully created in POS system
pending - Order accepted but still processing (used only with 202 responses in exceptional cases)
errored - Submission failed (see errors array)
rejected - Order rejected

Important

Normal Operation: Return 200 OK with an immediate response, even for multiple concurrent requests. Your system should handle concurrent requests and return responses promptly.
Exceptional Cases Only: Return 202 Accepted only when order processing truly requires additional time that cannot be handled synchronously (e.g., external system integration, complex validation requiring external API calls). PAR Ordering will poll the GetOrder endpoint to retrieve the final status in these exceptional cases.

Headers

Authorization
Type: string
required

Used to authorize the request with jwt_token. It should be supplied as Bearer JWT_TOKEN_GOES_HERE.
x-pch-digest
Type: string
required
HMAC-SHA256 signature for request authentication.

How to generate: hmac("sha256", concat(uriPath, requestBody), clientSecret)

Where:

uriPath - The API endpoint path (e.g., /posnext/order/validate), without the base URL

requestBody - The JSON request body exactly as sent, with whitespace removed

clientSecret - Your shared secret provided by PAR Technology during integration setup

A 412 response indicates a signature mismatch.
Content-Type
Type: string
required

Set this header to application/json.

Body·

required

application/json

location_id
Type: string
required

Location identifier
order_details
Type: object ·
required
request_datetime
Type: string Format: date-time
required

ISO 8601 UTC datetime of the request
request_type
Type: string enum
required

Type of request
values
- validate-order
- submit-order
request_uid
Type: string
required

Unique identifier for this request
callback_url
Type: string Format: uri

URL for asynchronous callbacks
schedule_type
Type: string enum

Order scheduling type
values
- current
- future
ttl
Type: integer

Time-to-live in seconds

Responses

application/json
application/json
application/json
401

Unauthorized
application/json

post/posnext/order/submit

curl https://api.partech.com/v1/posnext/order/submit \
  --request POST \
  --header 'Authorization: Bearer JWT_TOKEN_GOES_HERE' \
  --header 'x-pch-digest: SIGNATURE_GOES_HERE' \
  --header 'Content-Type: application/json' \
  --data '{
  "request_type": "validate-order",
  "request_uid": "order-12345",
  "request_datetime": "2025-01-15T10:30:00.000Z",
  "location_id": "loc-001",
  "schedule_type": "current",
  "callback_url": "",
  "ttl": 300,
  "order_details": {
    "online_order_id": "ONL-12345",
    "pos_order_id": "POS-67890",
    "subtotal": 25.99,
    "order_total": 28.09,
    "grand_total": 30.09,
    "menu_items": [
      {
        "id": "item-001",
        "name": "Burger",
        "item_type": "Item",
        "quantity": 2,
        "price_per_unit": 12.99,
        "total_price": 25.98,
        "modifiers": []
      }
    ],
    "taxes": [
      {
        "name": "Sales Tax",
        "amount": 2.1
      }
    ],
    "payments": [
      {
        "tender_id": "tender-001",
        "payment_type": "credit_card",
        "amount": 30.09
      }
    ]
  }
}'

Show Schema

{
  "status": "validated",
  "request_uid": "order-12345",
  "request_datetime": "2026-08-31T18:54:45.938Z",
  "location_id": "loc-001",
  "completed_at": "2026-08-31T18:54:45.938Z",
  "received_at": "2026-08-31T18:54:45.938Z",
  "order_details": {
    "online_order_id": "ONL-12345",
    "pos_order_id": "POS-67890",
    "subtotal": 25.99,
    "order_total": 28.09,
    "grand_total": 30.09,
    "menu_items": [
      {
        "id": "item-001",
        "name": "Burger",
        "item_type": "Item",
        "quantity": 2,
        "price_per_unit": 12.99,
        "total_price": 25.98,
        "modifiers": []
      }
    ],
    "taxes": [
      {
        "name": "Sales Tax",
        "amount": 2.1
      }
    ],
    "payments": [
      {
        "tender_id": "tender-001",
        "payment_type": "credit_card",
        "amount": 30.09
      }
    ]
  }
}

Order submitted successfully