> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commercy.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Armá apps para Commercy con la API pública, OAuth y webhooks.

Las apps de Commercy se conectan a la tienda de un comerciante a través de la API pública y de los webhooks. Cada app se instala con OAuth 2.0 (authorization code con PKCE): el comerciante ve en una pantalla de consentimiento qué permisos (scopes) pide tu app y puede aceptar o rechazar la instalación.

La API pública es una API REST en JSON, versionada por fecha en la URL. Según los scopes que tenga tu app, podés consultar y modificar datos de la tienda como sucursales, productos, precios, stock, ventas y clientes. Con los webhooks recibís un aviso cuando algo cambia en una tienda donde está instalada tu app, para no tener que consultar la API todo el tiempo.

Antes de aparecer en la Tienda de apps de Commercy, cada app pasa por una revisión manual del equipo, que responde en hasta 10 días hábiles. Commercy no cobra comisión por las apps: 0 %. Todo lo que probás en borrador funciona en tu propia tienda y en tus tiendas demo, sin necesidad de un plan pago.

## Empezá

<CardGroup cols={2}>
  <Card title="Primeros pasos" icon="rocket" href="/quickstart">
    Creá tu app, instalala en una tienda y hacé tu primer request en minutos.
  </Card>

  <Card title="Desarrollá con IA" icon="wand-magic-sparkles" href="/ia">
    Cómo darle esta documentación a Claude, Codex o Cursor para armar tu app, con un prompt listo.
  </Card>
</CardGroup>

## Explorá

<CardGroup cols={2}>
  <Card title="Autenticación OAuth" icon="key" href="/oauth">
    Authorization code con PKCE, tokens de acceso, refresh rotativo y revocación.
  </Card>

  <Card title="Scopes y permisos" icon="shield-halved" href="/scopes">
    Qué datos puede ver y modificar tu app, y cómo se piden.
  </Card>

  <Card title="Referencia de la API" icon="code" href="/api">
    Endpoints, convenciones, paginación e idempotencia de la API pública v1.
  </Card>

  <Card title="Webhooks" icon="bell" href="/webhooks">
    Eventos, formato del cuerpo, reintentos y verificación de la firma.
  </Card>

  <Card title="Errores" icon="triangle-exclamation" href="/errores">
    Formato de error de la API, códigos y qué hacer con cada uno.
  </Card>

  <Card title="Límites de uso" icon="gauge-high" href="/rate-limits">
    Cuántas requests podés hacer, cómo leer los headers y cómo reintentar.
  </Card>

  <Card title="Revisión y publicación" icon="circle-check" href="/revision">
    Cómo revisamos las apps, el checklist y los términos del programa.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.