Online Ordering Sample Payloads
Introduction
This article provides examples of online order payloads for the most common types of online ordering transactions. They are for illustrative purposes only, to demonstrate the potential structure of online order request payloads.
For a list of all Online Ordering fields and their detailed definitions, see the API Reference:
Local Order Creation
- Without Payment
- With Payment
- With Partial Payment
- With Payment and Tips
- With Item + Sub-items (Combo) and Payment
- With Item + Production Instruction and Payment
- With Discount on Item Level
- With Discount on Order Level
POST /o/op/1/order/local:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"tableNumber": 1,
"clientCount": 1,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"items": [
{
"quantity": 1,
"sku": "8"
}
],
"orderNote": "XYZ"
}
POST /o/op/1/order/local:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"tableNumber": 1,
"clientCount": 1,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"items": [
{
"quantity": 1,
"sku": "8"
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 5,
"paymentMethod": "API"
}
}
POST /o/op/1/order/local (Partial Payment):
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"tableNumber": 1,
"clientCount": 1,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"items": [
{
"quantity": 1,
"sku": "8"
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 4,
"paymentMethod": "API"
}
}
POST: /o/op/1/pay (Apply payment)
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"iKaccountIdentifier": "A80965.3",
"paymentAmount": 1.00,
"paymentMethod": "CASH",
"taskTtlInMs": 60000,
"thirdPartyPaymentReference": "Test"
}
POST /o/op/1/order/local:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"tableNumber": 1,
"clientCount": 1,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"items": [
{
"quantity": 1,
"sku": "8"
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 7.50,
"paymentMethod": "API",
"tipAmount": 2.5
}
}
POST /o/op/1/order/local:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"tableNumber": 1,
"clientCount": 1,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"items": [
{
"quantity": 1,
"sku": "18",
"subItems": [
{
"quantity": 1,
"sku": "10"
},
{
"quantity": 2,
"sku": "12"
},
{
"quantity": 1,
"sku": "13"
}
]
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 14.50,
"paymentMethod": "API",
"tipAmount": 2.5
}
}
POST /o/op/1/order/local:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"tableNumber": 1,
"clientCount": 1,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"items": [
{
"quantity": 1,
"sku": "10",
"modifiers": [
{
"modifierId": "1130976558186563"
}
]
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 12.50,
"paymentMethod": "API",
"tipAmount": 2.5
}
}
POST /o/op/1/order/local:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"tableNumber": 1,
"clientCount": 1,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"items": [
{
"quantity": 1,
"discountCode": "Staff",
"sku": "10",
"modifiers": [
{
"modifierId": "1130976558186563"
}
]
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 7.50,
"paymentMethod": "API",
"tipAmount": 2.5
}
}
POST /o/op/1/order/local:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"tableNumber": 1,
"clientCount": 1,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"items": [
{
"quantity": 1,
"discountCode": "Staff",
"sku": "10"
},
{
"quantity": 1,
"discountCode": "Staff",
"sku": "11"
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 11.00,
"paymentMethod": "API"
}
}
To-Go Order Creation
- Without Payment
- With Payments
- With Partial Payment
- With Payment and Tips
- With Item + Sub-items (Combo) and Payment
- With Item + Production Instruction and Payment
- With Discount on Item Level
- With Discount on Order Level
POST /o/op/1/order/toGo:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"collectionCode": 12345,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"deliveryAddress": {
"addressLine1": "123 Street",
"addressLine2": "Suite 200",
"city": "City Name",
"zip": "123456"
},
"items": [
{
"quantity": 1,
"sku": "8"
}
],
"orderNote": "XYZ"
}
POST /o/op/1/order/toGo:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"collectionCode": 12345,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"deliveryAddress": {
"addressLine1": "123 Street",
"addressLine2": "Suite 200",
"city": "City Name",
"zip": "123456"
},
"items": [
{
"quantity": 1,
"sku": "8"
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 5,
"paymentMethod": "API"
}
}
POST /o/op/1/order/toGo (Partial Payment):
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"collectionCode": 12345,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"deliveryAddress": {
"addressLine1": "123 Street",
"addressLine2": "Suite 200",
"city": "City Name",
"zip": "123456"
},
"items": [
{
"quantity": 1,
"sku": "8"
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 4,
"paymentMethod": "API"
}
}
POST: /o/op/1/pay (Apply payment)
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"iKaccountIdentifier": "A80965.3",
"paymentAmount": 1.00,
"paymentMethod": "CASH",
"taskTtlInMs": 60000,
"thirdPartyPaymentReference": "Test"
}
POST /o/op/1/order/toGo:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"collectionCode": 12345,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"deliveryAddress": {
"addressLine1": "123 Street",
"addressLine2": "Suite 200",
"city": "City Name",
"zip": "123456"
},
"items": [
{
"quantity": 1,
"sku": "8"
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 7.50,
"paymentMethod": "API",
"tipAmount": 2.5
}
}
POST /o/op/1/order/toGo:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"collectionCode": 12345,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"deliveryAddress": {
"addressLine1": "123 Street",
"addressLine2": "Suite 200",
"city": "City Name",
"zip": "123456"
},
"items": [
{
"quantity": 1,
"sku": "18",
"subItems": [
{
"quantity": 1,
"sku": "10"
},
{
"quantity": 2,
"sku": "12"
},
{
"quantity": 1,
"sku": "13"
}
]
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 14.50,
"paymentMethod": "API",
"tipAmount": 2.5
}
}
POST /o/op/1/order/toGo:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"collectionCode": 12345,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"deliveryAddress": {
"addressLine1": "123 Street",
"addressLine2": "Suite 200",
"city": "City Name",
"zip": "123456"
},
"items": [
{
"quantity": 1,
"sku": "10",
"modifiers": [
{
"modifierId": "1130976558186563"
}
]
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 12.50,
"paymentMethod": "API",
"tipAmount": 2.5
}
}
POST /o/op/1/order/toGo:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"collectionCode": 12345,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"deliveryAddress": {
"addressLine1": "123 Street",
"addressLine2": "Suite 200",
"city": "City Name",
"zip": "123456"
},
"items": [
{
"quantity": 1,
"discountCode": "Staff",
"sku": "10",
"modifiers": [
{
"modifierId": "1130976558186563"
}
]
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 7.50,
"paymentMethod": "API",
"tipAmount": 2.5
}
}
POST /o/op/1/order/toGo:
{
"businessLocationId": {{businessLocationId}},
"endpointId": "Sample-Endpoint-ID",
"thirdPartyReference": "Sample-Order-Reference",
"collectionCode": 12345,
"customerInfo": {
"firstName": "Lightspeed",
"lastName": "Test",
"email": "documentationtest@lightspeedhq.com",
"salutation": "Mr",
"notes": "XYZ",
"thirdPartyReference": "Sample-Customer-Reference"
},
"deliveryAddress": {
"addressLine1": "123 Street",
"addressLine2": "Suite 200",
"city": "City Name",
"zip": "123456"
},
"items": [
{
"quantity": 1,
"discountCode": "Staff",
"sku": "10"
},
{
"quantity": 1,
"discountCode": "Staff",
"sku": "11"
}
],
"orderNote": "XYZ",
"payment": {
"paymentAmount": 11.00,
"paymentMethod": "API"
}
}