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"
    }
}