Item Level Discounts

Resources and Guides

POS and Online Ordering integrations can take advantage of LevelUp item-level discounts and promotions. This allows merchants to run item-level campaigns (“$2 off your next burger at Bob’s Burgers”).

The steps to implementing merchant-funded item-level discounts are as follows:

  1. Use the proposed order endpoint to POST the check details (including items)
  2. Receive the total amount of discount available for that user on that check
  3. Apply the discount to the check
  4. Complete the order, making sure to include the applied_discount_amount parameter and the items on the check.

Note that add-ons, modifiers and sub-items should be passed as “child items”. Child items are simply nested items. They should include all applicable parameters. For example:

"item": {
  "charged_price_amount": 299,
  "description": "Shredded potatoes griddled to perfection",
  "name": "Hashbrowns",
  "quantity": 1,
  "sku": "01abc192",
  "category": "Breakfast Sides",
  "standard_price_amount": 299,
  "children": [{
    "item": {
      "charged_price_amount": 0,
      "name": "Special Instructions",
      "description": "Scattered"
      }
    },
    {
    "item": {
      "charged_price_amount": 50,
      "name": "Onions",
      "description": "Smothered"
      }
    },
    {
    "item": {
      "charged_price_amount": 100,
      "name": "Cheese",
      "quantity": 2,
      "description": "Covered"
      }
    },
    {
    "item": {
      "charged_price_amount": 50,
      "name": "Ham",
      "description": "Chunked"
      }
    }
  ]
}
},
{
"item": {
  "charged_price_amount": 398,
  "description": "12oz Can of Coca-Cola",
  "name": "Can Coke",
  "quantity": 2,
  "sku": "291soo01",
  "category": "Drinks",
  "standard_price_amount": 398,
  "upc": "04963406"
}

Third party campaigns can be supported by simply passing item data to the order creation endpoint. We’ll take care of the rest!