This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

Sandbox environment

The sandbox environment is intended for partner development and testing of Toast API integrations in a realistic setting. As with production, sandbox environment public APIs are versioned and fully functional. The sandbox environment has mock back-end payment processing.

You need the hostname of the sandbox environment to send REST requests to sandbox API services. You receive the hostname for the sandbox environment from the Toast technical partnership team when you begin to build your integration. When your integration is approved to go live, you receive the hostname for the production environment.

The sandbox environment is always available from 9 a.m. to 6 p.m. Eastern Time (UTC -5:00/-4:00). Outside of those hours, the sandbox environment might be unavailable to complete upgrades and other maintenance activities.

You can download a version of the Toast POS app installer (an Android APK installer file) that is configured to connect to the sandbox environment. The sandbox APK link changes periodically when the sandbox environment is upgraded.

Use one of the links below to download the Toast POS app installer. Use the installer version that is compatible with the Toast restaurants you are testing your integration with. You can find the Toast POS app version for a restaurant in the Required app version for [restaurant] value at the bottom of the Toast administration back-end for the restaurant.