# Toast POS

Step-by-step instructions for connecting the integration.

### First step

Integration is possible with four types of loyalty cards:

1. [Reward card](https://docs.boomerangme.cards/cards-creation/reward)
2. [Stamp card](https://docs.boomerangme.cards/cards-creation/stamp)
3. [Discount card](https://docs.boomerangme.cards/cards-creation/discount)
4. [Cashback card](https://docs.boomerangme.cards/cards-creation/cashback)

What you must have in order to connect the integration:

* An account in our service
* A customised loyalty card (cashback card, discount or reward card) or all three types of cards. You will be able to test all three types and choose the one you like best.
* **Restaurant Management Suite** must be connected in order to use this integration. A detailed video on how to do it.&#x20;

{% embed url="<https://youtu.be/rvyWMljrbjY>" %}

If you already have all of these, go to Toast Marketplace and connect the integration **Boomerang**.

<https://pos.toasttab.com/integrations/boomerang>

Next, Toast Integrations Support team will be able to configure the loyalty.

### Second step

​Need to find out **Restaurant ID**.

The restaurant guid is not visible to customers. Please reach out to your Onboarding Consultant or the Customer Care team to retrieve your location's unique GUID number.

### Third step

Go to the integration section, select Toast from the list, and click “Connect.”

Select a card template and enter your Restaurant ID. Your integration is now connected.<br>

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FeyrmpYvtnwmS8wCRqoBl%2FScreenshot%20at%20Aug%2025%2011-28-59.png?alt=media&#x26;token=a11e0dfe-3707-48f4-bb10-7241867a6341" alt=""><figcaption></figcaption></figure>

After connecting the integration to reward or stamp templates, you will have access to advanced settings for receiving and using rewards.

**Reward card**:&#x20;

1\. You can set up points for certain items on your menu. To do this, select the Products type. Choose how many items will earn points and how many points will be awarded.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F20klhEZiGl2KoC3wkc9K%2FScreenshot%20at%20Aug%2025%2017-37-55.png?alt=media&#x26;token=438702d5-a9be-4932-8f6f-a6aa7b86236e" alt=""><figcaption></figcaption></figure>

2\. Advanced settings for “Item $” and “Item %” rewards. You can set up the reward so that the customer can only use it for certain items from your menu. You can also set a limit and a period of use for the limit. For example, in the screenshot, the reward is set up so that it can be used twice a month and gives a $10 discount on ribs.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FmHOh9AOeIGJKVHQqCIHu%2FScreenshot%20at%20Aug%2025%2017-43-46.png?alt=media&#x26;token=ded868ac-dd4e-48aa-974a-ef95bf0e3805" alt=""><figcaption></figcaption></figure>

3\. Set up the application of the discount (reward) for all eligible items on the customer's receipt or for only one item on the receipt.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FW0FyTEZ9KhakKZMMEOnf%2FScreenshot%20at%20Aug%2025%2017-45-10.png?alt=media&#x26;token=c4151c97-0a62-4e02-b21e-9e07146343f4" alt=""><figcaption></figcaption></figure>

**Stamp card**:

1\. You can set up stamps for certain items on your menu. To do this, select the Products accrual type. Select the number of items for which stamps will be accrued. And how many stamps will be accrued.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2Fr51o1s4iqxQFOvwqK9LK%2FScreenshot%20at%20Aug%2025%2017-47-46.png?alt=media&#x26;token=c1f80562-7756-43f0-bd97-bd1e76521c6f" alt=""><figcaption></figcaption></figure>

2\. Advanced settings for “Item $” and “Item %” rewards. You can set up the reward so that the customer can only use it for certain items from your menu.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FSnJLPmfqjmvhRE481z7O%2FScreenshot%20at%20Aug%2025%2018-16-49.png?alt=media&#x26;token=fbbf8cee-9f53-4f28-9fbe-5371a5ee344a" alt=""><figcaption></figcaption></figure>

3\. Set up the reward to apply to all eligible items on the customer's receipt or to only one item on the receipt.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F11DhbzYwfSC6Ine3xZJp%2FScreenshot%20at%20Aug%2025%2018-17-56.png?alt=media&#x26;token=6ebc58c8-3ac7-4b27-bb7b-9a398cbbb104" alt=""><figcaption></figcaption></figure>

For discount and cashback cards, the new template settings do not appear.&#x20;

For new customers in Toast, cards are not automatically issued with the first order.

Therefore, we recommend that you distribute cards in your establishments via QR.

### Fourth step<br>

Now let's see how the integration works:

1\. You need to place an order in Toast.

2\. Find the "Rewards" block, find and click on it: "Look up customer"\
❗️**Note.** If you do not see the search client button. Contact Toast technical support. They will help you set up this button for you.<br>

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FGsjVXdDtDlGmde3QLHvZ%2FScreenshot%20at%20Aug%2025%2018-20-54.png?alt=media&#x26;token=8e7c166c-30b9-41d7-a317-04164c25ebf4" alt=""><figcaption></figcaption></figure>

3.Find the customer by their loyalty card number<br>

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F6A5CbTkLyvBVzLm6IOan%2FScreenshot%20at%20Aug%2025%2018-23-46.png?alt=media&#x26;token=c55a0c54-1cad-49f8-aac1-4cab763fdd10" alt=""><figcaption></figcaption></figure>

or find the customer by name, email, or phone number. Click "Lookup"<br>

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F6IBmHqkJUysAvlbzzUQM%2FScreenshot%20at%20Aug%2025%2018-25-51.png?alt=media&#x26;token=40584c9e-de96-4178-bb18-743d443ae377" alt=""><figcaption></figcaption></figure>

3\. Select an available reward (discount) and apply it to the receipt. If you do not want to use the reward and want to accumulate points/stamps, skip this step.&#x20;

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2Fqo0la4N8uuqnnZZjlgvd%2FScreenshot%20at%20Aug%2025%2018-26-22.png?alt=media&#x26;token=0e51d3cd-32ff-4f06-95b4-b898a413be71" alt=""><figcaption></figcaption></figure>

4\. Pay for the order.&#x20;

5\. Check the change in the balance on the customer's card in your Boomerang account.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FUBlVChc7UIrWbipZIs3W%2FScreenshot%20at%20Aug%2025%2018-31-04.png?alt=media&#x26;token=36e7f516-7fb5-4033-b5d0-199e5473de17" alt=""><figcaption></figcaption></figure>

In this case, we used a 200-point reward, and the receipt also included a product for which 10 points were awarded.

✅ If you don't see available rewards with a client in Toast. You need to do the following:\
You need to add more items to the cart to be able to apply the discount. The amount in the cart must be greater than the applied discount.

✅ The user counter in the integration will always be 0 - this is normal, this is not an error. Since there is no user synchronization in the integration with Toast. All users on our side are always 0.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FLAGaoVqJesrOoGc2YMno%2Fimage.png?alt=media&#x26;token=f999dcb6-6cc7-4f35-bebe-e1e90ff9a65c" alt=""><figcaption></figcaption></figure>

You can upload clients on our side and specify in the file how many points each client has. Then issue them a card. But you need to do this after integrating the card.

I recommend trying and uploading a small number of clients (for example, 5 people).

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FqeVm1sgRwMBB4R5e0R1D%2FScreenshot%20at%20Aug%2022%2016-27-31.png?alt=media&#x26;token=2a47556e-f075-415d-86f3-2b004b1134d7" alt=""><figcaption></figcaption></figure>

Integration with Toast POS is available only for clients located in the United States.
