How to integrate a Product options app with Buunto

If you are using a product options app in your store and want to ensure full compatibility with our date picker widget, feel free to share this document with the Product options app's support team to help them build an integration with us.

If you are an app developer looking to integrate Buunto with your product options app, please note that Buunto does not have predefined line item property names, as these can be customized according to the merchant's preferences or language. Commonly used line item property names include "Delivery Date," "Pickup Date," "Pickup Time," etc. but these may vary for different merchants, language or depending on the delivery method (e.g., Pickup or Local Delivery).

To integrate correctly with our app, you should make sure that all the "properties" fields in the "Add to Cart" form are included when calling /cart/add.js along with your form fields.

You can use the following script (please adjust the query selector accordingly) to list all the properties in the "Add to cart" form.

[...document.querySelector(".product-form").elements]
    .filter((element) => element.name.startsWith("properties"))
    .map((element) => element.name + ": " + element.value)

Here is an example where Buunto and a Product options app coexist:

properties[Method]: Local Pick Up - Croydon Park
properties[Pick Up Date]: September 27, 2024
properties[Pick Up Day]: Friday
properties[Pick Up Time]: 9:30 AM - 10:30 AM
properties[Event Type]: Wedding
properties[Cake Flavour]: Vanilla Bean
properties[Base Colour]: Latte
properties[Piping Colour]: Latte
properties[Text Style]: Freehand Script Font Piping [ +$5.00 ]
properties[Text Message]: Test
properties[Extra Bling]: Glitter Spray [ +$5.00 ]

The first 4 fields are Buunto's, but as mentioned earlier, the names could change. So, the rule is simply to include all "properties" fields alongside your own when adding the product to the cart.

If you need further details or assistance with the information in this article, feel free to contact us at support@buunto.com.