Skip to main content
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á

Primeros pasos

Creá tu app, instalala en una tienda y hacé tu primer request en minutos.

Desarrollá con IA

Cómo darle esta documentación a Claude, Codex o Cursor para armar tu app, con un prompt listo.

​
Explorá

Autenticación OAuth

Authorization code con PKCE, tokens de acceso, refresh rotativo y revocación.

Scopes y permisos

Qué datos puede ver y modificar tu app, y cómo se piden.

Referencia de la API

Endpoints, convenciones, paginación e idempotencia de la API pública v1.

Webhooks

Eventos, formato del cuerpo, reintentos y verificación de la firma.

Errores

Formato de error de la API, códigos y qué hacer con cada uno.

Límites de uso

Cuántas requests podés hacer, cómo leer los headers y cómo reintentar.

Revisión y publicación

Cómo revisamos las apps, el checklist y los términos del programa.