Store – actions

This article helps you understand the API behaviour in enabling/disabling the outlet/store of a given brand on ordering platform.

Written By Ops UrbanPiper (Collaborator)

Updated at June 16th, 2020

API Document Reference - https://api-ordering-docs.urbanpiper.com/#store-actions


  1. What is the purpose of this API?
    - This API is used to enable/disable the store/outlet on the ordering platform.

  2. Is it possible to disable the multiple stores at a time in a single API call?
    - No. This API uses a location-wise request. Based on the value passed under the attribute - "location_ref_id", the request will be made to that specific store.

  3. Can the request be made specific to particular platforms?
    - Yes. By specifying the platform values under the array "platforms", the request can be made specific to the particular platforms.

  4. What all "platform" values are supported?
    • In production, supported values are — zomato, swiggy, dunzo, amazon, foodpanda, ubereats, zomatomarket, swiggystore.
    • In staging, supported value is — urbanpiper

  5. Why POS partners are asked to use "urbanpiper" and not aggregator values for "platforms" in staging?
    - The aggregators haven't shared any of their staging environment to connect our sandbox for seamless integration testing. Given that, when an API request with aggregator platforms values are being sent to UrbanPiper, the request will end up failing when the system tries to make a request to upstream. Thus, it is recommended to use "urbanpiper" as the platform value while testing this API.

  6. What is the throttle limit for this API?
    - A throttle limit is applicable to this endpoint limiting the maximum number of requests/min to 20. If you breach this threshold, the platform will respond with a 429 error response code and you will not be able to make new requests for a duration of 1 min.

  7. How to configure the "callback_url" for this API?
    • POS partners can configure the "callback_url" in the Quint dashboard under Configuration>Webhooks choosing event type as Store status change from the dropdown.
    • Or, use the Webhooks API to configure the webhook endpoints in Quint Dashboard by specifying the event - store_action mentioned in the API documentation.
    • Note: For more info - https://api-ordering-docs.urbanpiper.com/#store-actions-callback.

  8. During testing, received error - "platform not associated". What does this mean?
    - Make sure the "platforms" value set as "urbanpiper" while testing in the sandbox environment. Refer to point no. 5.

  9. Is it expected to receive a "callback" when the platform used in "urbanpiper"?
    - No. The callbacks will be triggered only for the aggregator values(zomato, swiggy, etc) passed under "platforms".

Was this article helpful?