- Platform Overview
- Resources and Guides
-
POS Integration
-
Getting Started
-
Core Concepts
-
Integration SDK
-
Certification
-
- Order Ahead
-
Provider Enablement
-
Provider Enablement
-
Endpoints
-
Developer Endpoints
-
-
API Reference
-
Getting Started
-
v15
-
- Access Tokens
- Campaigns
- Credit Cards
- Users
- Credit
- Locations
- Payment Methods
- QR Codes
- Progress Adjustments
- Orders
- Rewards
- Gift Cards
-
-
v14
-
- Credit
- Access Tokens
- Campaigns
- Categories
- Credit Cards
- Interstitials
- Locations
- Loyalty
- Orders
- Payment Tokens
- Support Tickets
- Users
-
-
Interstitials .: Get
API Reference / v15
Get an Order’s Interstitial
This endpoint retrieves information about interstitials for orders. Interstitials are essentially “receipt notifications” for orders and should be displayed on a customer’s device immediately following the order.
To view an interstitial, you must have a user access token with the create_orders
or
read_qr_code
permission.
Request Endpoint
GET /v15/orders/:uuid/interstitial
Authorization Required – User Token in Header
Authorization: token user="1131-a1fcf99331b51e92b6377920c915367a540523181985a203555bdcc37f0c86"
cURL Example
curl -v https://sandbox.thelevelup.com/v15/orders/f7943600849501323c1552668b2aa48c/interstitial \
-H Accept:application/json \
-H Content-Type:application/json \
-H 'Authorization:token user="1131-a1fcf99331b51e92b6377920c915367a540523181985a203555bdcc37f0c86"'
Example Response
Success
HTTP/1.1 200 OK
{
"interstitial": {
"action": {
# See possible actions below
},
"callout_text": "text",
"description_html": "Lorem ipsum minorus dinosaurus.",
"image_url": "url_to_image", (client attaches query params)
"title": "title",
"type": "type" (one of: "claim", "feedback", "share", "url", "no_action")
}
}
NOTE: New types can be added at any time, so make sure to ignore any types that your app does not recognize.
Response Parameters
Param | Type | Description |
---|---|---|
action |
Object | Type-specific action parameters for the interstitial. See below for details. |
callout_text |
String | Short text that asks the user to take the relevant action. |
description_html |
String | A description for the content of the interstitial that may contain HTML tags. |
image_url |
String | The URL for the image associated with the interstitial. |
title |
String | The title for the interstitial. |
type |
String | The type of the interstitial. |
Actions
Depending on the interstitial type, the action object might look like any one of these:
claim
{
"action": {
"code": "ABC123"
}
}
feedback
{
"action": {
"question_text": "How was your experience?"
}
}
share
{
"action": {
"message_for_email_subject": "...",
"message_for_email_body": "...",
"message_for_twitter": "...",
"share_url_facebook": "...",
"share_url_twitter": "...",
"share_url_email": "..."
}
}
url
{
"action": {
"url": "http://example.com"
}
}
no_action
{
"action": null
}
Errors
If no interstitial is available for the order
HTTP/1.1 404 Not Found
[
{
"error": {
"code": "not_found",
"message": "Interstitial not found.",
"object": "interstitial",
"property": "id"
}
}
]