Loyalty integration implementation

You integrate your loyalty program with the Toast platform by implementing an API that handles REST HTTPS requests that the Toast platform sends to it. The Toast loyalty integration API specification describes the required functionality of a REST web service that will handle Toast platform loyalty program transactions. For more information, see reference documentation in the loyalty integration API reference documentation.

When a Toast POS location employee handles a sale transaction, the employee can use a Rewards function to find the guest's loyalty account or guests can enter their own loyalty program identifiers using a guest-facing display or a kiosk device. Once the Toast platform has the account for the guest, it exchanges information about the guest's check with your loyalty program service to present rewards offers and perform other operations. For information about the API requests that the Toast platform sends for loyalty program transactions, see Transaction types.

In your implementation of the Toast loyalty integration API, you create a single HTTPS REST endpoint, named in any way you choose. For example: https://myapi.mycompany.com/myendpointname. The Toast platform sends requests to that single endpoint (host name and path) for all loyalty program transactions. You can identify the requests for specific transaction types using the Toast-Transaction-Type HTTP header parameter for each request that you receive.