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.

Testing your gift card API implementation

The reference implementation repository includes a set of test API requests in a Postman™ collection. You can use these test requests to simulate the API requests that the Toast platform sends to your integration. For more information, see Reference gift card API implementation.


You can send real requests from the Toast platform using the sandbox testing environment. The Toast technical partnership team can configure a test restaurant that uses your implementation and a restaurant employee account that you can use to sign into a POS device to simulate gift card transactions. Your implementation must verify incoming JWTs with the sandbox public key when receiving requests from the sandbox environment. For more information about the public key, see Gift card integration authentication.

In addition, Toast offers an integration verification tool that you can use to test your API implementation. The following sections describe this tool.