Overview
The Product Catalog is the discovery surface of Insurance-as-a-Service: it answers "what can my integration sell?" and "how do I build a valid selection to quote?". It consists of two read-only endpoints, scoped to the products enabled for your integration.
Concepts
| Concept | Description |
|---|---|
Product (product) | An insurance product from a partner insurer (e.g. a credit life product, a group life product). It is the unit of sale: each product sold in an order produces one policy. Addressed by product_key. |
Coverage (service) | A coverage or benefit that composes the product (e.g. death, accidental disability, funeral assistance). It can be mandatory (mandatory) or optional. Addressed by service_key. |
| Option space | The configurable limits of each coverage: maximum insured amount (maximum_insured_amount) and the typed envelopes of accepted deductibles (deductible_options) and waiting periods (waiting_period_options). A selection outside the option space is rejected at quote time. |
| Dependencies | Structural rules between coverages of the same product: include (prerequisite coverages) and exclude (mutually exclusive coverages). |
Commission band (commission_bounds) | The {minimum_rate, maximum_rate, default_rate} band of your commission per sale of that product. The commission sent in the quote and the order (commission_data) is validated against this band; when omitted, default_rate applies. |
Default configuration (default_configuration) | Default coverage values configured for your integration. When the selection omits the services list, the quote automatically fills in every configured default coverage. |
Product classification
Every product carries a regulatory and commercial classification:
| Field | Description |
|---|---|
product_category | insurance, capitalization or benefit. A product may combine coverages of different categories (e.g. insurance + assistance). |
insurance_class | The product's SUSEP line of business (e.g. credit_life). Absent for non-insurance products. In the quote and the order, the line of business is returned as the object { name, class_number, group_number }. |
regulator_registration | The product's SUSEP registration (Código SUSEP). |
Visibility and confidentiality
- Only active products enabled for your integration are visible; a product belonging to another partner (or a nonexistent one) returns
404. - The commission band returned is always yours — never another partner's.
- The insurer's internal pricing and eligibility rules are not exposed: you receive the structural limits (option space and dependencies) and the evaluation result at quote time.
Endpoints
| Endpoint | Description |
|---|---|
GET /v1/product_catalog/products | Lists the products your integration can sell. |
GET /v1/product_catalog/products/{product_key} | Details one product: coverages, option spaces, dependencies, your defaults and your commission band. |