Skipcart APIs & webhooks provide a one-stop experience to allow for seamless partner delivery experiences. Integration with Skipcart out of the box APIs can instantly position any partner or POS to offer on-demand delivery services using their existing interface.
The Basics
Skipcart offers a suite of out of the box RESTful APIs which can be tailored to partner requirements. The APIs accept and return JSON-encoded objects and utilize standard HTTP response codes. Skipcart also offers standard webhook functions for partners who do not have a predefined set of webhooks.
The table below represents the full list of available APIs which interface with Skipcart.
| API | Method | Functionality | Required? |
|---|---|---|---|
| Authentication | POST | Authenticates a user via API call | Y |
| Get Serviceable Zip Codes | POST | Retrieves a list of zip codes serviced by Skipcart, called before quoting | N Recommended for Quote Based Partners |
| Get Quote | POST | Get a quote from Skipcart for an order | Required for Quote Based Partners |
| Create Order | POST | Creates an Order in Skipcart systems | Y |
| Get Status of an Order | GET | Retrieve the status of a single order (Webhooks can be utilized alternatively) | Y |
| Delete Order | DELETE | Deletes an order from Skipcart | Y |
| Search Orders | GET | Search one or more orders in Skipcart systems | N |
| Post Order Tipping | POST | Add tip for individual order to pass to driver AFTER the order is delivered to customer | N |
| Skipcart Webhooks | POST | Update partners with status of orders as they progress; webhook events are published to a partner provided endpoint | N |
Sunny Day Process Flow
At a high level, the sunny day order flow consists of the below:
- Partner authenticates - once every 24 hours
- Partner retrieves Skipcart serviceable zip codes
- Partner requests quote from Skipcart
- Partner submits order to Skipcart to fulfill delivery
- Partner queries Skipcart to retrieve order status which is updated real time as webhooks & events are triggered
- If post order tipped is received from delivery recipient, Post Order Tipping API can be used to pass tip onto driver