Location Based Products

📘 Introduction

The CSQ Based Location 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 multiple-product-option 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:

Fetch countries, categories, states, and municipalities or deliver locations.

Select the desired product.

Create a shopping cart.

Finalize the purchase.

🔁 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).

📊 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.