Skip to main content
Skip table of contents

Toast

1. About

Toast is a cloud-based restaurant management software company providing an all-in-one point of sale system built on the Android operating system.

Launched
August 2022

Article Last Updated
July 28, 2025

Category
POS

2. Integration Summary

Feature

Supported

Not Supported

Ordering Channels

  • Toast Online Ordering

  • Guest Facing Display

Spendgo Loyalty Features

  • Accrue points for loyalty claimed orders

  • Claim receipt from the Spendgo Member portal to accrue points for orders not claimed at the store

  • Redeem Spendgo offers/rewards

  • Combine Spendgo rewards with non-Spendgo rewards

  • Loyalty Reversal on order void/refund (Full void/refund only, Spendgo does not support partial refunds)

Base Program Types

  • Points Banking

  • Shop with points

Basket Level Rewards/Offers Types

  • $ Discount (Rebate)

  • % Discount (Discount)

  • Bonus Points

Item Based Rewards/Offers Types

  • BOGO

  • Free Item

  • $ Discount

  • % Discount

  • Bonus Points

  • Price Adjustment

Rewards shown for selection

  • Upon looking up the Member after creating the order, only the rewards applicable to the order are shown.

  • All available rewards can be looked up by looking up the Member without creating the order. The rewards listed at this stage are not redeemable.

  • If the order changes, the rewards are not validated automatically. Rewards re-lookup is needed if the order changes.

Discount code setup

A discount code is only needed if using an online ordering or third party in-store or payment platform integration which requires discount codes (such as Olo and Bbot)

  • For setting up the discount code in Toast, refer to Toast documentation - Configuring Open Discounts from Toast Central (Payments > Comps and promos > Discounts and promo codes)

    • Please  Name/Label the Discount  Spendgo Loyalty Discount 

    • This Discount Code will be used to process all loyalty discounts and is passed in the API between Toast /Spendgo when a reward is applied to an order.  

    • Settings should be as follows:

      • Require manage permission for reward permission: no

      • Open $-off 

      • Apply to Entire Check

      • Do not allow the discount to be used with other discounts (Spendgo does not support discount stacking)

      • Availability - leave blank (should be all days/ times)

      • Do not create with a promo code

      • Advanced Setting → Permission Level → Manager

    • Save and Publish to all locations

    Once you have created/saved/published the Discount for all stores, within your Toast Admin it displays the discount name and number. 

    Please then click on Discount code to edit - to locate the Discount Code GUID found in the URL.

image-20240522-181420.png

Online and In-Store Ordering Platforms

 


3. Things to Know

Impact of "Use Toast Order GUID as Spendgo Order Id" Setting on Spendgo Order Handling with Toast Order Updates:

Upon merchant request, the Spendgo Integration team can enable the 'Use Toast Order GUID as Spendgo Order Id' integration setting. When enabled, this setting prevents orders from being voided in Spendgo if a closed order is updated in Toast (e.g., when an order is reopened to add a tip). The table below illustrates the difference between the default behavior and enabling this setting.

Feature

Default Setting

When "Use Toast Order GUID as Spendgo Order Id" is Enabled

Spendgo Order ID

All orders show in Spendgo Dashboard with the guest-facing Toast order number.

All orders show in Spendgo Dashboard with the Toast internal ID (Toast order GUID).

When a closed order in Toast is reopened and updated

  1. Order gets voided in Spendgo and shows with amount and points as 0 in the Dashboard.

  2. It looks as if the order got refunded from Toast. There is no way to distinguish between the real refund v/s the order showing as voided because if the update.

  1. The original order shows as voided (amount and points as 0).

  2. A new, updated order with a different Toast GUID shows with the updated amount and points. Please note that this also has few other implications

    • Reporting: The orders will get counted twice.

    • Campaigns that are targeted to audiences based on conditions such as visit count or average order amount may not work accurately.

Receipt Claims from Member Portal

“voided” (refunded or updated) orders are not available for receipt claim. However all other guest orders can be claimed.

Orders cannot be claimed from the member portal. Members will need to contact Spendgo support with their receipt to claim an order.

Processing of the order Refunds

  • Refunds are supported only for the same day orders.

  • Please refer to the below table what happens when the order is refunded.

Action

Loyalty Processing

Order is fully refunded

Loyalty on the order is revered.

  • Points accrued on the order is reversed

  • Any Spendgo Reward applied to the order is added back to the Member’s balance

Order is partially refunded

Partial loyalty reversal is not supported in Spendgo. Partial refund is also treated same way as the full refund.

In order to keep the loyalty on the partial refund to be processed correctly, it is recommended to fully refund the order and create a new order with the updated order details.

  • Stacking of multiple Spendgo rewards are not supported

    • Please note that the Toast UI allows applying multiple Spendgo rewards to an order but if you try to place the order with multiple rewards applied, an error message is displayed and the applied rewards are removed. A reward will have to be re-applied before placing the order.

image-20250110-053446.png
  • Handling of Combo Menu items: When a combo menu item comprising of other items in the menu is created,

    • The combo item price is attached with the main combo item and all sub items prices are all rolled up into the combo.

    • The item based reward can be created based on the Combo item name.

    • Individual items within the combo and their prices do not come into Spendgo from Toast separately and hence do not show up in the Dashboard receipt.

    • If an item based reward is defined on a menu item, the reward is applicable only when the item is on the order individually, not when it is part of the Combo.

  • Handling of priced modifiers

    • The price of any priced modifier is not rolled up into the price of the main item. The main item and the modifier prices come into Spendgo from Toast separately.

    • Toast does not allow any priced modifier to be added to the item free of cost.

  • Double counting of transactions when Spendgo integration is enabled both in StoreFront and Toast POS at the location.

    • The order sent by Storefront and Toast have different orders IDs and hence gets created as separate orders in Spendgo. This is the default behavior.

    • As of now, only Member orders are supported in the Storefront integration. When the same orders come through from Toast, it comes in as a Guest orders. So, even thought order is counted and shows in the Spendgo Dashboard twice, this does not result in double awarding of points to the Member (Unless the Member actually also goes into the Member portal and make a loyalty claim on the Toast receipt).

    • However, since the orders are counted twice - this causes over-reporting of sales and orders counts.

  • Discount Code:

When the location specific discount code set up in Toast, If the discount code is not correctly mapped in Olo, it will result in the below error showing up when the Order is placed from Olo.

image-20240723-175756.png

This error needs to be reported to Olo.

  • Order ID Format:

    • By default, Toast orders show up with a short (1-4 digits) ID. The short IDs are not unique to Toast. However, you can identify it as a Toast order by opening the Receipt View and looking up the “ReferenceID” in the GUID format, as shown below.

    • If the Use Toast Order GUID as Spendgo Order Id is set then all orders show with the Toast GUID.

image-20240208-003219.png
image-20240208-003535.png

4. Integration Setup

4.1 Requirements

  • Ensure Toast and Spendgo accounts are fully set up. A Spendgo Customer Success Manager will inform you when your Spendgo account is ready to enable loyalty with Toast.

  • If migrating from Toast Loyalty or any other third party loyalty vendors to Spendgo Loyalty, ensure all locations in the Toast Loyalty group are ready to migrate. 

    • Toast does not allow different locations within the Loyalty group to have different loyalty vendors.

  • Ensure that there are no unpublished changes in the Toast Admin Portal.

image-20240123-002309.png
image-20240123-002326.png
  • If using Olo or Bbot for online ordering:

    • Ensure that the Toast integration is enabled on Olo or Bbot.

    • Ensure that the discount code is setup in Toast and shared with Olo and Spendgo.

  • If you have a requirement such as reopening closed order in Toast to make an update to the order (such as adding a tip to the order) review if enabling the “Use Toast Order GUID as Spendgo Order Id” is required. Please refer to Section 2 above for more details on this setting.

4.2 How to Enable the Integration

  1. As part of the Account setup or when ready to enable the integration, Spendgo Integration team sets up the Loyalty POS API credentials in Spendgo.

    1. Spendgo integration team enables the “Use Toast Order GUID as Spendgo Order Id” from the Spendgo admin portal, if required.

  2. Once Spendgo confirms the account is setup, Merchant sends an email request to Toast and Spendgo to enable the integration using the email template below.

To:

integrations-support@toasttab.com

Cc:

csm@spendgo.com, integrations@spendgo.com

Subject:

Authorization to Enable Spendgo Loyalty Integration

I grant Toast permission to grant Spendgo with API access to my Toast instance for the following locations:

(list location names as they appear in Toast)

4.3 If Disabling the Integration

Send an email request to Toast and Spendgo to disable the integration using the email template below:

To:

integrations-support@toasttab.com

Cc:

csm@spendgo.com, integrations@spendgo.com

Subject:

Authorization to Disable Spendgo Loyalty Integration

I grant Toast permission to revoke Spendgo with API access to my Toast instance for the following locations:

(list location names as they appear in Toast)

  1. Toast Integration Support team enables/disables the integration and informs the Merchant and Spendgo (integrations@spendgo.com, csm@spendgo.com) the Toast GUID of the locations that are enabled/disabled.

    1. When the email is sent to integrations@spendgo.com, it automatically creates a Toast Central ticket. Spendgo is copied on the ticket but has no access to the ticket to track all the updates happening on the Ticket.

    2. image-20240408-191815.png
    3. The integration team takes up to 5 business days to work on the ticket. Please note Toast cannot provide a specific time window for enabling the integration and this may happen any time during the day. If switching to Spendgo from Toast or other third party Loyalty, plan accordingly.

  2. If enabling the integration the Merchant maps the Toast GUID to the location from the Spendgo Dashboard. If it is being disabled remove the mapping.

Settings → Stores → Manage Edit

image-20240322-172251.png
  1. If this is Lab or the first location, Spendgo CSM co-ordinates with the Merchant to run some tests to confirm the integration and the rewards are working as expected.

4.4 Quick validation steps after enabling the integration:

  1. Once the integration is enabled, it enabled the “Rewards” button on the POS. This is first step to validate that the integration is enabled.

  2. Once the integration is enabled, the order data starts flowing from Toast to Spendgo, but the Loyalty is not processed in Spendgo unless the Toast GUID is correctly mapped to Spendgo Store location.

    1. If the integration is enabled and location is mapped, the guest orders should start appearing in Spendgo Dashboard.

    2. If the guest orders are not showing in the Dashboard,

      1. Confirm that the “Rewards” button is enabled in the POS. If not, update the Toast Central ticket to let the Toast Integration support team know.

      2. If the Rewards button is enabled but no orders are showing in the Dashboard,

        1. Confirm that the location is open and receiving orders.

        2. If the orders are being placed on the POS but it is not showing up in Spendgo Dashboard,

          1. Confirm that there are no unpublished changes in Toast Admin Portal.

          2. Update the Toast Central ticket and also let Spendgo Integrations and CSM (integrations@spendgo.com, csm@spendgo.com) know by email.


5. Loyalty Flow

5.1 POS Flow

A “Reward” button will show in the Toast POS when Spendgo Loyalty is enabled.

5.1.1 Looking Up the Loyalty Member

The below screenshots are created from the mobile phone and the actual layout on the POS may vary slightly.

Option 1: Employee looks up Member by phone number on the POS

  1. After ringing in the items and before payment, if the Member wants to make a loyalty claim, bring up the Loyalty Lookup window by clicking on “Rewards” → “Lookup Customer”

image-20240123-002450.png

Option 1A: Enter the 10 Member’s 10 digit Phone number in the “Key In or Scan” field and then tap “Done”

image-20250721-192639.png

OR

Option 1B: Tap on the “Lookup” button and enter the Member’s 10 digit Phone number in the “Search Phone #” field and then tap “Done” and then review the returned Member and tap on the listed Member and tap “Done”

image-20240123-002542.png
image-20240123-002623.png
  1. If a Member for the entered 10 digit phone number does not exist in the Spendgo network, a “Starter” Member is created and displayed. Starter Members can begin earning points immediately. 

    1. For full membership benefits, such as eligibility for certain rewards or rewards redemption, brands may require the Member to complete registration.

image-20240123-002657.png

3b. If a non 10 digit number then an error message is displayed. Phone number will have to corrected in order to complete the lookup.

image-20250729-064101.png
image-20250729-064142.png
  1. Review the Member details, click on the listed Member, and click “Done.”

Option 2: Member scans a QR Code in a Mobile Pass or App

If a QR Code is made available to a Member in the Mobile App or via a Mobile Pass, the Member can scan the QR Code to make the loyalty claim.

Previously we required the QR code to contain the Member’s 10 digit Phone number for the Option 2A and the Spendgo Member ID for the Option 2B below. As of 07/29/2025, both options 2A and 2B require the QR code to contain Phone number.

2A) Scan using the barcode reader device

  1. After ringing in the items and before payment, if the Member wants to make a loyalty claim, bring up the Loyalty Lookup window by clicking on “Rewards” → “Lookup Customer” and then scan the QR Code.

image-20240326-213531.png

  1. It will present the Member detail window, as shown above.

  2. Click on the listed Member, then click “Done.”

2B) Scan using the POS Device's Camera-

  1. After ringing in the items and before payment, if the Member wants to make a loyalty claim, bring up the Loyalty lookup window by clicking on “Rewards” → “Lookup Customer” and click on “Scan” to bring up the scanner, then ask the Member to scan.

image-20240123-002734.png
  1. Click on the listed Member, then click “Done.”

5.1.2 . Applying the Spendgo Reward

  1. Once the Member is located, any reward available to the Member to apply on the order is listed in alphabetical order. Only rewards that can be applied to the transaction will appear in the list.

    1. If it is an Item Level reward, the qualifying item must be present in the cart at this step to appear as a redemption option. 

    2. If the Member wants to apply any of the rewards, click on “Redeem.”

    3. Only one Spendgo reward can be applied per order.

image-20240123-002804.png
  1. The reward is applied to the order and the updated order is displayed.

image-20240123-002854.png
  1. Please note that even though Spendgo doesn’t support applying multiple rewards to the order, Toast UI does allow adding more than one reward to the order. However when trying to close the order, Toast notices that the Spendgo is returning an error and so removes the applied rewards and keeps the order open. Reward will have to be looked up and applied again.

image-20240403-193028.png
  1. Complete the payment and close out the transaction.

5.1.3 . Removing an applied reward:

If the Reward needs to be removed click on the applied reward. In the Discounts panel the applied reward is highlighted. Click on the reward to remove it.

image-20240403-194712.png

5.1.4. Adding additional non-spendgo discounts along with the Spendgo Rewards

An order can have additional non-spendgo discount(s) added to the order along with a Spendgo reward. To add additional discount, follow the regular steps for adding non spendgo discount. i.e once order has items, click on the “Discount” button to bring up the discount panel and then select discount(s) to be applied.

image-20240403-205042.png

Here is how the order looks after applying a Spendgo reward and an additional discount.

image-20240403-205700.png

5.1.5. Updating an Order after applying the reward:

The order can be updated after applying the reward. However when new items are added or removed, or because the order subtotal has changed, it is possible that either the applied reward is no more applicable or order qualifies for some different reward(s). So, before or after updating the order, remove the applied reward and after the order is updated do a fresh rewards look up.

5.1.6 Switching/Changing the reward:

If a reward needs to be changed, remove the applied reward and do a fresh rewards lookup.

5.1.7. Switching the Loyalty Member

Please note that once the Loyalty member is looked up, the Member is attached to the order. Order can be completed without applying any reward and the order is counted as a loyalty order and the order accrues loyalty points. There is no way to remove the Loyalty Member from the order once attached. However, if the Member needs to be changed, bring up the look up screen and click in the “Switch Customer” and re-enter the phone number.

image-20240403-200413.png

5.1.8 Viewing all rewards available to the member

Please note that when the rewards are looked up after adding items to the reward, only the rewards applicable to the order listed. There may be some rewards that is available to the Member but does not show up because the order does not meet the requirements to qualify for some of the available rewards. If the Member wants to know all available rewards, it can be looked up by following the rewards look up flow (Step 5.1.1) without ringing any item in the order. In this scenario the rewards listed for viewing only and cannot be applied.

image-20241220-202503.png

The listed rewards do not include:

  1. Any store specific reward that does not apply to the location the Member is at.

  2. Any Point Banking reward defined at higher points tier than the Member’s current points balance. For example if Member’s points balance is less than 100, only the Point Banking rewards defined at points tier less than 100 are shown. If the Member points balance is zero, then no Points Banking reward is shown.

Even though the rewards can be looked up without adding items to the reward, it should be for looking up the rewards only. For applying the reward the rewards need to be look up again after adding items to the order.

5.1.9 Processing Voids/Refunds:

Spendgo does not support partial loyalty reversal or partial voids/refunds on a completed order. If a partial void/refund is processed on an order, any loyalty points or rewards are reversed as if it is a fully voided/refunded order. If a partial void/refund is needed, it is recommended to fully refund the order and begin a new order. 

  1. Select the Closed Check to Void/Refund.

image-20240123-002938.png
  1. Click on the available options (3 dots on the top right); select “Void Order” and click on the “Void” button. 

image-20240118-170014.png
  1. Click “Void” on the “Confirm Void” window, then click “Done.”

image-20240118-170127.png

5.2 Kiosk Flow

  1. On the Kiosk device, the Member taps the Start button and then adds items to the order.

  2. Member taps on the “Rewards” button.

image-20240730-011138.png

  1. The Member can select the “Phone number” as a look up type and then enter the Phone number on the lookup screen.

image-20240730-011349.png
  1. If there is a Mobile App available with the QR code, then the The Member can also choose the “Scan QR code” method.

The QR code should contain the Member’s 10 digit Phone number

4. The Member will be presented with the rewards that are available to the Member for the order. A reward of choice can be applied to the order.

image-20240730-012052.png
image-20240730-012122.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.