DATE:
AUTHOR:
The Toast - API team
Tender API

Tender API will use orders API check object

DATE:
AUTHOR: The Toast - API team

On 2025-06-23, the tender API will change the way it represents Toast POS checks in requests it makes to your integration. On 2025-06-23, the Check object in some tender API requests will reflect Toast POS checks in the same way that the orders API represents guest checks. This will fix some current problems with tender API Check object information.

This change to the tender API behavior will affect the information about guest checks that you receive from the integration. For example:

  • The appliedServiceCharges array in the tender API Check object will include an AppliedServiceCharge object for each service charge on the check. Currently, the array is empty even when a check includes service charges.

  • The totalAmount value in the tender API Check object will correctly include the total price of the check, including taxes and discounts. Currently, this value is always null.

  • The amount value in the tender API Check object will correctly include the check price after discounts but before tax. Currently the amount value includes the check price after discounts and after taxes.

  • The modifiers array in the tender API Selection object will include a Selection object for each modifier for a menu item selection. Currently, the array is empty even when a menu item selection includes modifiers.

This change does not affect all tender API request types. Some request types already use the orders API check object behavior, some request types will change the check behavior on 2025-06-23, and one type will not change the check behavior. The following table describes which request types are changing check behavior and when the changes will happen.

The change to the tender API Check object is currently deployed in the Toast API sandbox environment. Verify that your tender API integration handles the updated guest check information in the sandbox environment before the change is deployed in the production environment on 2025-06-23.

For more information about the tender API, see Tender provider integrations overview.

Powered by LaunchNotes