FAQs

Orders

1. What are the possible scenarios for a response when placing an order?

• SUCCESS: Vouchers will be returned instantly.
• FAILED: The order has failed.
• PROCESSING: Hubble will provide a callback when the order reaches a terminal state. Alternatively, the client can poll the “Get Orders” API at reasonable intervals to check if the order is in terminal state.

2. What should be done in case of a timeout?

In the event of a timeout, the client should retrieve the order by the reference ID to verify if the order was successfully created.

3. How can you ensure that an order is idempotent?

To ensure idempotency, the reference ID passed with the order acts as an idempotency key. Using this reference ID ensures that there is only one order in the system for that ID, preventing duplicate orders.

Brands

4. How will product changes be communicated?

Clients can subscribe to the “Brand Updated Callback” to receive notifications about product updates. However, only changes to the following fields are communicated through webhooks:

{
  "id": "brand_id",
  "denominationType": "FIXED/FLEXIBLE",
  "status": "ACTIVE/INACTIVE",
  "denominations": [100, 1000, 5000],
  "amountRestrictions": {
    "minOrderAmount": 100,
    "maxOrderAmount": 5000,
    "minVoucherAmount": 100,
    "maxVoucherAmount": 5000,
    "maxVouchersPerOrder": 5,
    "maxVouchersPerDenomination": 1,
    "maxDenominationsPerOrder": 1
  }
}

For other updates such as new brand additions, asset changes, or other metadata updates, we recommend implementing a regular synchronization process (e.g., once per day) with the Get Brands API.

For more details, see the Webhooks documentation.

5. What’s the difference between tags and categories for brands?

In the brand APIs:

• Categories: Represent a strict classification system used to group brands for specific use cases, such as displaying brands in a particular section of an app (e.g., “Popular Brands”, “Food & Beverage”).
• Tags: Are flexible, descriptive keywords used to improve brand searchability. They allow for more granular and varied filtering based on user queries (e.g., “Pizza”, “FastFood”, “Online Shopping”).

In short, use categories for structured grouping and tags for flexible searching.

6. What are the available brand categories?

The following is a list of available categories as of July 2025:

PHARMACY, ENTERTAINMENT, QUICK_COMMERCE, DIWALI_SPECIAL, OFFLINE_BRANDS, TRAVEL_AND_TRANSPORT, FURNISHING, ACCESSORIES, GROCERY, WATCHES, EMERGING_BRANDS, NEW_BRANDS, LUXURY, ONE_STOP_SHOPS, APPLE, BEAUTY, HOTELS, MUSIC, SOFTWARE, HAND_BAGS, HOME_DECOR, GAMING, OTT, JEWELLERY, ELECTRONICS, BILL_PAYMENTS, FITNESS, FOOD, FASHION, RAKHI_SPECIAL, HOT_DEALS, KIDS, FOOTWARE

Please note that this list is subject to change as categories are added or removed over time.

Discounts

7. Why doesn’t the API return discount percentage information?

Discount percentages are managed outside of the API system. These are determined by business arrangements and may vary based on specific partnerships. For discount-related inquiries, please contact the Hubble business team for details.