Checkout validation

Ensuring accurate date and time slot capture during checkout is crucial for seamless order fulfillment. Due to various factors including theme configurations, theme settings, conflicts with other applications, and mobile connection speeds the date and time information could potentially be missing or invalid.

To eliminate these occasional issues and improve the reliability of your customer orders, we've introduced the checkout validation feature. Enabling this function will automatically verify the presence and validity of selected date and time slots. If a required date or time slot is missing, or if it fails to meet your configuration (such as cutoff or preparation times), an error message will be displayed, preventing the customer from completing the checkout until valid selections are made. This ensures all orders are placed with precise scheduling information, reducing errors and improving operational efficiency.

The following checks are performed:

• If a date or time slot was expected on the order, is it missing?
• Is the date or time slot selected date currently available?

How to activate the checkout validation

1. In Buunto, go to Settings > Validation and advanced settings

   
   
2. In the Validation card, check Enable Date and Time slot validation during checkout then click Save.

3. Then click the Add checkout rule this will take you to Shopify's admin panel in Settings > Checkout.

   
   
4. Scroll all the way at the bottom of this screen to find the Checkout rules card, then click Add rule.

5. Then click on Date and Time slot validation, under Buunto – Delivery Date Picker.

6. In the next screen, if Allow all customers to complete the checkout is checked, the error message will show if the validation fails, but it will still allow customers to complete their checkout. You can optionally uncheck it to block customers from completing their checkout with an invalid or missing date/time slot selection. It's up to you depending on how crucial this is for your business.

7. Click Save.

8. After saving, don't forget to click Turn on.

9. Please test the checkout thoroughly by making test order. This feature might prevent customers from completing their orders if something is wrong.

Modify the wording of the errors (optional)

This feature comes with a default wording but don't hesitate to customise it if needed.

For that, in Buunto, go to Settings > Text and languages > English (or other language), search for the Checkout validation section.

You can modify the messages above appropriately and click Save.

Shopify size limit

Shopify imposes a 10,000 character limit on the data that checkout functions can read. The checkout validation relies on two pieces of data stored in Shopify metafields: your widget settings and your product context maps (built from collection and tag filters in custom settings).

If either of these exceeds the limit, the validation will not run at checkout — even if the checkbox is enabled.

When this happens, Buunto displays a warning banner in Settings > Validation and advanced settings:

How to reduce the size

• Too many custom settings: Each custom setting adds to the widget settings payload. Try removing unused or redundant custom settings.
• Large collection or tag filters: Custom settings that filter by many collections or tags generate large product context maps. Check that all the collections or tags used as filters are actually needed, and avoid filtering by very large collections (for example, "All products").

Draft orders

If you use Shopify's draft order feature, you may notice the checkout validation displaying a message about a missing date.

This is a known Shopify platform limitation - Shopify does not provide a way for apps to tell whether a checkout comes from a draft order or from your online store. Because of this, the validation cannot be skipped for draft orders only.

You can safely ignore this message when creating draft orders, as it is informational and does not block the order from being created.

New hidden property

After activating this feature you might notice a new internal property attached to your order items or as order attribute.

This property is called __buunto_selection    and contains information that is only meant meant to be read by our checkout validation script.

It shouldn't be visible to your customers, however it will show in Shopify admin's order page. You can simply ignore it.