Orders
Create order
Create a new order using the streamlined v2 payload with flat schema, customer object, and products array.
POST
/
orders
Create order
curl --request POST \
--url https://integrations.clopos.com/open-api/v2/orders \
--header 'Content-Type: application/json' \
--header 'x-token: <api-key>' \
--data '
{
"sale_type_id": 2,
"venue_id": 1,
"customer": {
"id": 9,
"phone": "+994705401040",
"address": "123 Main St",
"customer_discount_type": 1,
"name": "Rahid Akhundzada"
},
"products": [
{
"product_id": 101,
"product_name": "Pizza",
"count": 2,
"price": 8.5,
"status": "new",
"product_hash": "abc123",
"portion_size": 1,
"modifiers": [
{
"modifier_id": 501,
"modifier_name": "Extra Cheese",
"count": 1,
"price": 0.5,
"portion_size": 1
}
]
}
]
}
'const options = {
method: 'POST',
headers: {'x-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sale_type_id: 2,
venue_id: 1,
customer: {
id: 9,
phone: '+994705401040',
address: '123 Main St',
customer_discount_type: 1,
name: 'Rahid Akhundzada'
},
products: [
{
product_id: 101,
product_name: 'Pizza',
count: 2,
price: 8.5,
status: 'new',
product_hash: 'abc123',
portion_size: 1,
modifiers: [
{
modifier_id: 501,
modifier_name: 'Extra Cheese',
count: 1,
price: 0.5,
portion_size: 1
}
]
}
]
})
};
fetch('https://integrations.clopos.com/open-api/v2/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://integrations.clopos.com/open-api/v2/orders"
payload = {
"sale_type_id": 2,
"venue_id": 1,
"customer": {
"id": 9,
"phone": "+994705401040",
"address": "123 Main St",
"customer_discount_type": 1,
"name": "Rahid Akhundzada"
},
"products": [
{
"product_id": 101,
"product_name": "Pizza",
"count": 2,
"price": 8.5,
"status": "new",
"product_hash": "abc123",
"portion_size": 1,
"modifiers": [
{
"modifier_id": 501,
"modifier_name": "Extra Cheese",
"count": 1,
"price": 0.5,
"portion_size": 1
}
]
}
]
}
headers = {
"x-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"message": "Order created",
"data": {
"status": "PENDING",
"payload": {
"updated_at": "2026-01-08T06:28:23.000000Z",
"created_at": "2026-01-08T06:28:23.000000Z",
"id": 295,
"venue_id": 1
}
}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}Authorizations
JWT access token obtained from /v2/auth endpoint
Body
application/json
Order details
Sale type to use
Example:
2
Venue where the order belongs
Example:
1
Customer information for the order
Show child attributes
Show child attributes
List of products in the order
Minimum array length:
1Show child attributes
Show child attributes
Terminal ID that auto-accepts the order
Example:
1
Auto-accept the order
Auto-send to stations after acceptance
Delivery charge to apply
Example:
2.5
Free text note for the order
Example:
"Leave at the door"
Order-level discount
Show child attributes
Show child attributes
Service charge settings
Show child attributes
Show child attributes
Was this page helpful?
⌘I
Create order
curl --request POST \
--url https://integrations.clopos.com/open-api/v2/orders \
--header 'Content-Type: application/json' \
--header 'x-token: <api-key>' \
--data '
{
"sale_type_id": 2,
"venue_id": 1,
"customer": {
"id": 9,
"phone": "+994705401040",
"address": "123 Main St",
"customer_discount_type": 1,
"name": "Rahid Akhundzada"
},
"products": [
{
"product_id": 101,
"product_name": "Pizza",
"count": 2,
"price": 8.5,
"status": "new",
"product_hash": "abc123",
"portion_size": 1,
"modifiers": [
{
"modifier_id": 501,
"modifier_name": "Extra Cheese",
"count": 1,
"price": 0.5,
"portion_size": 1
}
]
}
]
}
'const options = {
method: 'POST',
headers: {'x-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sale_type_id: 2,
venue_id: 1,
customer: {
id: 9,
phone: '+994705401040',
address: '123 Main St',
customer_discount_type: 1,
name: 'Rahid Akhundzada'
},
products: [
{
product_id: 101,
product_name: 'Pizza',
count: 2,
price: 8.5,
status: 'new',
product_hash: 'abc123',
portion_size: 1,
modifiers: [
{
modifier_id: 501,
modifier_name: 'Extra Cheese',
count: 1,
price: 0.5,
portion_size: 1
}
]
}
]
})
};
fetch('https://integrations.clopos.com/open-api/v2/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://integrations.clopos.com/open-api/v2/orders"
payload = {
"sale_type_id": 2,
"venue_id": 1,
"customer": {
"id": 9,
"phone": "+994705401040",
"address": "123 Main St",
"customer_discount_type": 1,
"name": "Rahid Akhundzada"
},
"products": [
{
"product_id": 101,
"product_name": "Pizza",
"count": 2,
"price": 8.5,
"status": "new",
"product_hash": "abc123",
"portion_size": 1,
"modifiers": [
{
"modifier_id": 501,
"modifier_name": "Extra Cheese",
"count": 1,
"price": 0.5,
"portion_size": 1
}
]
}
]
}
headers = {
"x-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"message": "Order created",
"data": {
"status": "PENDING",
"payload": {
"updated_at": "2026-01-08T06:28:23.000000Z",
"created_at": "2026-01-08T06:28:23.000000Z",
"id": 295,
"venue_id": 1
}
}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}