Adjusting the "Pickup Time" to a later time

Questions
1

Hello!

We are using the Square Create Payment Link API to let folks order food for pickup throughout the day at a restaurant. In the Create Payment Link API, we supply a pickup time which was a time chosen by the customer.

We have a situation where the restaurant gets overwhelmed with orders during certain times of the day (e.g. lunch rush). The kitchen can get backed up to a point where they are unable to fulfill the order at the desired pickup time.

Is there any way (either on the POS, Square Seller Dashboard, APIs, anything really) where it would allow the kitchen to update to a new anticipated pickup time? To say something like, “hey we won’t be ready at 11:30am as you requested but you can pickup at 11:45am”

I think ultimately, I want to know if theres a way to make an update to the pickup_at field in a fulfillment to a new value - then, my application could read the value in the field and display it to the user.

I was trying to use the Orders Update Order PUT request but was struggling to figure out if it’s possible to do so using that API.

Thank you for any help!

2

:wave: I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:

Additional Documentation

Order-Ahead Application Use Case
Order-Ahead Sample Application
https://developer.squareup.com/docs/orders-api/quick-start/start

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.

3

Yes, you can update the pickup_at field in a fulfillment using the UpdateOrder endpoint of the Orders API. In the request, you would provide the Order object with the updated pickup_at timestamp in the pickup_details field of the Fulfillment object. This would allow you to adjust the pickup time for the order. After the update, your application can retrieve the updated order and display the new pickup time to the user. Please note that these fields can only be set while the order fulfillment state is PROPOSED.

This answer was reviewed by @Bryan-Square.