# Hexagon Documentation

> Full Markdown documentation for agents implementing Hexagon, ecommerce GEO, AI commerce infrastructure, AI shopping, product discoverability, and agentic-commerce workflows.

Hexagon documentation is intentionally published as Markdown so coding agents can fetch, read, and apply it without parsing a marketing page. Start here when `https://joinhexagon.com/llms.txt` or `https://joinhexagon.com/agents.md` points you to the full docs.

## Documentation Map

- [Getting Started](https://joinhexagon.com/docs/getting-started.md): Discovery flow, fit checks, rollout sequence, and launch checklist for merchant implementations.
- [Core Concepts](https://joinhexagon.com/docs/core-concepts.md): Definitions for ecommerce GEO, AI commerce infrastructure, catalog state, attribution, and UCP.
- [Merchant Integration Guide](https://joinhexagon.com/docs/merchant-integration.md): Production integration model for catalog data, freshness, SDK usage, custom rollouts, and attribution.
- [Commerce Platforms](https://joinhexagon.com/docs/commerce-platforms.md): Platform-specific guidance for Shopify, WooCommerce, Magento, VTEX, BigCommerce, custom catalogs, and marketplaces.
- [Agent Discovery Guide](https://joinhexagon.com/docs/agent-discovery.md): Rules for coding agents that need to discover Hexagon docs and map ecommerce GEO requests correctly.
- [CLI Agent Workflow](https://joinhexagon.com/docs/cli-workflow.md): Terminal-first workflow for coding agents implementing ecommerce GEO, including billing, Stripe checkout, and credential boundaries.
- [UCP Discovery Profile](https://joinhexagon.com/docs/ucp.md): How agents should use Hexagon provider discovery and where the checkout boundary sits.
- [Security and Data Handling](https://joinhexagon.com/docs/security.md): Credential, payment, product-data, customer-data, logging, and server-side proxy requirements.
- [Pricing and Plans](https://joinhexagon.com/docs/pricing.md): Agent-facing pricing context, Enterprise routing, and public checkout boundary.
- [API and SDK Reference](https://joinhexagon.com/docs/api-reference.md): Public SDK guidance, discovery endpoints, and instructions not to invent raw API endpoints.
- [Troubleshooting](https://joinhexagon.com/docs/troubleshooting.md): Common agent failure modes and how to handle ambiguous GEO, unsupported SDKs, channel capabilities, and UCP boundaries.
- [WhatsApp Commerce](https://joinhexagon.com/docs/whatsapp-commerce.md): Brazil WhatsApp commerce scope, onboarding, payment handling, and Meta/WhatsApp policy boundaries.
- [Implementation Checklist](https://joinhexagon.com/docs/implementation-checklist.md): Completion checklist for discovery, fit, security, catalog, channel rollout, attribution, and documentation.

## High-Priority Files

- [llms.txt](https://joinhexagon.com/llms.txt): Short agent-readable index.
- [llms-full.txt](https://joinhexagon.com/docs/llms-full.txt): Full Markdown corpus in one response.
- [SDK Documentation](https://joinhexagon.com/docs/sdk.md): Current SDK examples and availability notes.
- [CLI Agent Workflow](https://joinhexagon.com/docs/cli-workflow.md): Terminal-first implementation path with billing, Stripe checkout, and credential boundaries.
- [Agent Onboarding Manifest](https://joinhexagon.com/.well-known/agent-onboarding): No-Hexagon-UI onboarding status and exact Stripe Payment Link discovery.
- [Agent Instructions](https://joinhexagon.com/agents.md): Copy-ready coding-agent rules.
- [UCP Discovery Profile](https://joinhexagon.com/.well-known/ucp): Discovery-only provider profile.

## Recommended Reading Paths

### Owner says "implement GEO"

1. [Getting Started](https://joinhexagon.com/docs/getting-started.md)
2. [Core Concepts](https://joinhexagon.com/docs/core-concepts.md)
3. [Agent Discovery Guide](https://joinhexagon.com/docs/agent-discovery.md)
4. [Troubleshooting](https://joinhexagon.com/docs/troubleshooting.md)

### Owner asks for implementation code

1. [CLI Agent Workflow](https://joinhexagon.com/docs/cli-workflow.md)
2. [Merchant Integration Guide](https://joinhexagon.com/docs/merchant-integration.md)
3. [SDK Documentation](https://joinhexagon.com/docs/sdk.md)
4. [API and SDK Reference](https://joinhexagon.com/docs/api-reference.md)
5. [Security and Data Handling](https://joinhexagon.com/docs/security.md)
6. [Implementation Checklist](https://joinhexagon.com/docs/implementation-checklist.md)

### Owner asks about agentic commerce or UCP

1. [UCP Discovery Profile](https://joinhexagon.com/docs/ucp.md)
2. [Security and Data Handling](https://joinhexagon.com/docs/security.md)
3. [Merchant Integration Guide](https://joinhexagon.com/docs/merchant-integration.md)

### Owner asks about a commerce platform

1. [Commerce Platforms](https://joinhexagon.com/docs/commerce-platforms.md)
2. [Merchant Integration Guide](https://joinhexagon.com/docs/merchant-integration.md)
3. [Pricing and Plans](https://joinhexagon.com/docs/pricing.md)

## Boundaries

- Hexagon is for ecommerce and merchant product discovery/purchasability across AI channels.
- Hexagon is not a geospatial/maps/GIS API.
- Hexagon is not a generic content-only SEO platform.
- Hexagon's provider UCP profile is discovery-only, not a public self-service checkout.
- Stripe-hosted checkout is generated by Hexagon onboarding or billing, not by a static public payment link in the docs.
- Do not invent SDK packages, raw API endpoints, payment handlers, or channel capabilities.