📘 Introduction#
The CSQ Location-based Products API enables various B2C clients to integrate a dynamic flow for the sale of physical and non-physical products that have a similar location-based and dynamic-product-offer behavior. It is designed to support both complex products (e.g., physical goods such us groceries, requiring multiple configuration steps) and simpler ones (e.g., eSIMs that skip some steps).The flow is dynamic and adaptive: each API response may indicate the next step required to complete the operation. This makes the integration flexible and product-driven.Available endpoints allow you to:1.
Fetch countries, categories, states, and municipalities or deliver locations.
2.
Select the desired product.
🔁 Dynamic Request Flow#
The API operates with a dynamic request flow, where each response contains the next required action, enabling an adaptive step-by-step integration. Some products will require a full chain (country → category → state → municipality → product → cart → purchase), while others, such as eSIMs, may skip many steps (country → category → product → cart → purchase).Thus, this API follows a self-guided transaction model where each response includes contextual routing information (i.e., the next endpoint or method to invoke), enabling dynamic client-side navigation.📊 Typical Flow Diagram#
Note: The flow is conditional. For example, an eSIM purchase might skip all location-based steps and go directly from getCategories to getProducts.Modified at 2025-07-09 15:57:27
