Skipcart webhooks enable the partner to be informed at each step throughout the order process.
Each webhook payload contains a single event (event_status) that is associated to a particular order status (order_status). As events are triggered on the Skipcart side, order stauses will also update accordingly.
A comprehensive list of all possible events can be found in the table below.
Event Status | Event Description | Correlating Order Status | Event Frequency | Webhook is Called/Frequency |
|---|---|---|---|---|
new | New order created in Skipcart system, either by Partner API or | new | Once | No |
cancelled | Order is cancelled by partner | cancelled | Once | No |
queued | Driver nearby completing another delivery has indicated they want to accept another delivery before completing their current one | queued | Once | No |
confirmed | Order is assigned to a specific driver (new orders & rejected | confirmed | Once | Yes |
enroute_to_pickup | Driver is on the way to store for pickup | confirmed | Every 30 seconds | Yes |
geofence_at_pickup | Driver enters the pickup location geofence | confirmed | Every 30 seconds | Yes |
arrived_at_store | Driver arrives at store for pickup and confirms arrival in Skipcart app | confirmed | Once | Yes |
partner_rejected | Partner rejects driver partner for delivery and new driver to be identified | new | Once | No |
pickup_not_ready | Driver is at the store for pickup but the order is not ready | new | Once | No |
out_for_delivery | Store pickup has been completed and order is enroute to customer destination | out_for_delivery | Once | Yes |
enroute_to_delivery | Store pickup has been completed and order is enroute to customer destination | out_for_delivery | Every 30 seconds | Yes |
delivered | Order is delivered to customer | delivered | Once | Yes |
customer_refused | Customer refuses to accept the order | out_for_delivery | Once | No |
order_expired | Order timed out. Default delivery window is 60 minutes. | out_for_delivery | Once | No |
return_started | Event is triggered when order_expired or customer_refused events occur to notify partner of pending return | out_for_delivery | Once | Yes |
return_enroute_to_store | Driver enroute to store to complete return | out_for_delivery | Every 30 seconds | Yes |
geofence_at_return | Driver enters the store to complete return | out_for_delivery | Every 30 seconds | Every 30 seconds |
return_at_store | Driver reached store to complete return | out_for_delivery | Once | Yes |
return_delivered | Order is returned to store and store representative acknowledges return on driver's Skipcart app | delivered | Once | Yes |
schedule_failed | Skipcart systems could not return the schedule (reason code included in response) | schedule_failed | Once | No (Quote Partners) |
delivery_proof_uploaded | Delivery proofs are uploaded to Skipcart. This occurs at a separate interval than delivered and return_delivered events to allow time for images to be received | delivered | Once | Yes |
driver_cancelled_pickup | Driver has accepted an order and subsequently cancels it before out_for_delivery event | new | Once | Yes |
skipcart_cancelled | If there are no drivers to deliver an order by the delivery window + 30 additional minutes, Skipcart automatically cancels the order | cancelled | Once | Yes |
retailer_cancelled | Partner/merchant cancels the order | cancelled | Once | No |
geofence_customer_dropoff | When driver arrives at customer dropoff location, this event triggers automatically once driver enters the geofence (supresses enroute_to_delivery event when triggered) | out_for_delivery | Every 30 seconds when within geofence | Yes |
at_dropoff | Driver arrives at customer door/entrance and marks 'Complete Delivery' in Skipcart app. Also triggers signature capture in the Skipcart driver app. | out_for_delivery | Once | Yes |
close_order | Customer is unavailable or refuses the delivery. Will return a reason code in response. | close_order | Once | Yes |