Are you a restaurant owner? Learn how to offer delivery while saving money when you download our food guide.
Restricted Items
Flagging Age-Restricted Items
If your delivery includes age-restricted items, such as alcohol, tobacco, fireworks, and similar products, you must specify this information when creating a job in our API. Doing so will initiate an additional validation step during the delivery process.
Our couriers are trained to follow a specific ID-checking procedure to verify age at the dropoff location. If the customer does not pass the age verification, the items will be returned to the origin address. In such cases, you will receive a ‘canceled’ delivery status in the API response, with "cancellation.reason_key":"end-customer_underage"
. Once the return is completed, the order status will update to 'delivered' to confirm its return to the store.
For more information on tracking returns and understanding cancellation reasons, please refer to our API documentation.
Delivery Options for Restricted Items (UK ONLY)
When creating a job through our job creation endpoint, you can use the delivery_options
object, which includes the restricted_items
field, to specify items that require age verification. This API array allows you to indicate the specific reason for age verification with greater precision.
Please note that this feature is currently available only in the UK. If you attempt to use this field outside the UK, it will trigger an error. For operations in other countries, we recommend using the original Challenge 25 format.
An example of this field is shown below:
{
"job": {
"pickups": [
...
],
"dropoffs": [
{
... ,
"delivery_options": {
"restricted_items": ["ALCOHOL", "TOBACCO"]
}
]
}
}
The different values you can use for this field are one or more of:
“TOBACCO”, “LOTTERY”, “KNIVES”, “FIREWORKS”, “SOLVENTS”, “BUTANE”, “ALCOHOL”, “SUNBEDS”
This will display this list of restricted items included in the order directly in the driver invitation screen before accepting it, please see screenshots of the process below:
Please note, for the 'Alcohol' restricted item we included an additional step to ensure the sobriety of the customer. Please see additional screenshots below.
Challenge 25 Flag Option (all countries)
- add the 🔞 emojis in the job.dropoff.package_desctiption field of the job creation request with the text "challenge 25" inside, ie. (“🔞 Challenge 25 🔞”). Please note, that additional text can be inserted within the emojis informing the courier of the type of item for example alcohol or tobacco.
- Make sure that the payload has the emoji well copied and not converted to text
:underage
. You can copy and paste the emojis from here for ease.
Following the above steps will notify the courier that the delivery job is an “18+ delivery” directly in the courier invitation screen before accepting it. While not being able to granularly inform the courier which items the +18 delivery contains, we highly encourage adding this information to the description field as mentioned above to avoid any issues once the courier arrives at the pickup location.
-------------------------------------------------------------------------------------------------------------------------------------------------------------------