Developers y partners

Creá apps para Commercy, sin comisión.

Llegá a comercios argentinos que ya facturan en ARCA y venden con Commercy, online y en el local. Crear y probar tu app es gratis, y no cobramos comisión: le cobrás directo al comercio.

Tres formas de conectar

Según quién lo use. Mismo comercio, tres puertas.

Un comercio instala una app, tu software habla con la API y una persona le habla a su asistente de IA. Las tres operan sobre las ventas, el catálogo y los clientes del comercio, con los permisos que el dueño autoriza.

  • Sin programar

    Apps del marketplace

    Para el comerciante. Instala la app desde la Tienda de apps, ve los permisos que pide y la acepta con un clic. Vos la publicás una vez.

    Ver la Tienda de apps /apps
  • Tu software

    API REST, OAuth y webhooks

    Para tu servidor. Leé y escribí productos, precios, stock, ventas y clientes del comercio que te autoriza, y recibí avisos firmados cuando algo cambia.

    Referencia de la API docs/api-reference
  • Una persona

    MCP con Claude o ChatGPT

    Para el dueño que ya usa un asistente de IA. Lo conecta a su cuenta, pregunta por ventas y stock, y confirma los cambios. Es del plan Ultra.

    Ver asistentes de IA /asistentes-de-ia
01 Autorización con OAuth

Pedí lo mínimo. El dueño ve exactamente eso.

OAuth 2.0 con PKCE: tu app pide scopes y Commercy le muestra al dueño de la tienda, en lenguaje llano, qué va a poder ver y qué va a poder cambiar. Cada permiso de más se revisa y baja la tasa de instalación.

Autenticación OAuth
// Pedí lo mínimo: el comerciante ve cada permiso.const scopes = [ // read_shops va siempre incluido , , , // sensible: se justifica en la revisión]const url = new URL( "https://api.commercy.com.ar/oauth/apps/authorize")url.search = new URLSearchParams({ client_id: "app_7d41c2…", redirect_uri: "https://miapp.example.com/callback", response_type: "code", state, code_challenge, code_challenge_method: "S256", scope: scopes.join(" "),})
PKCE
S256 · confidencial
code
60 s
access
1 hora
refresh
90 días, un uso
app.commercy.com.ar/apps/authorizerol Admin

Ventas al día quiere conectarse con Kiosco del Parque

App de Estudio Nodo

¿Le das acceso a esto?

Va a poder ver

  • Tus ventasCon nombre, email, teléfono y dirección del comprador12.906
  • Tus productosVariantes, categorías y marcas1.482
  • Tus sucursalesNombre, dirección y horarios3
  • Tu stockDe cada sucursal

Va a poder cambiar

  • Ajustar tu stockSumar o restar unidades en cada sucursal

Después te llevamos a miapp.example.com

Tocá los scopes del código y mirá su pantalla

02 API REST versionada

Mirá el request. Con la respuesta que de verdad vuelve.

JSON en pesos argentinos, ids como texto, paginación por cursor y la versión por fecha en la URL (hoy 2026-10), que se mantiene al menos 12 meses después de que sale la siguiente. Elegí un endpoint, enviá y probá también qué pasa cuando algo falla.

Referencia de la API
GETapi.commercy.com.ar/api/public/2026-10/products
Request scope read_products
curl "https://api.commercy.com.ar/api/public/2026-10/products?limit=1&updated_since=2026-11-09T00:00:00.000Z" \ -H "Authorization: Bearer $ACCESS_TOKEN"
Response 200 OK
HTTP/1.1 200 OKX-Request-Id: 0b6f6d3e-6c0e-4c0b-9a5a-6a8f6d1c2a10X-RateLimit-Limit: 40X-RateLimit-Remaining: 39X-RateLimit-Reset: 1Content-Type: application/json
{ "data": [ { "id": "6710c0d1e4a1f20012ab3500", "name": "Yerba mate Playadito 1 kg", "slug": "yerba-mate-playadito-1-kg", "description": null, "short_description": null, "sku": "YER-PLA-1K", "barcode": "7791234500017", "type": "simple", "images": [], "category_ids": ["6710a1b2e4a1f20012ab3410"], "brand_ids": [], "tags": ["almacén"], "shop_ids": ["6710b3c2e4a1f20012ab34cf"], "visibility": "PUBLIC", "is_active": true, "price": 4950, "currency": "ARS", "has_variants": false, "variant_axes": [], "variants": [], "iva_rate": 21, "weight": { "value": 1000, "unit": "g" }, "created_at": "2026-03-02T14:10:00.000Z", "updated_at": "2026-11-09T09:42:00.000Z" } ], "next_cursor": "eyJrIjoiNjcxMGIz…"}

Se ordenan por fecha de modificación: guardá la última que viste y pedí sólo lo nuevo con updated_since. Mientras next_cursor no sea null, hay más páginas.

Elegí un endpoint y enviá

03 Webhooks firmados

Te avisamos cuando cambia algo. Y firmamos cada aviso.

Cada entrega lleva una firma HMAC-SHA256 sobre el cuerpo crudo y el timestamp. Verificala en tiempo constante, rechazá lo que no coincida y deduplicá por el id del evento.

  • Los 4 webhooks de desinstalación y privacidad se entregan siempre
  • Al menos una vez y sin orden garantizado
  • Si no respondés 2xx, 13 intentos en unas 44 horas
Webhooks y verificación
POST /webhooks/commercyEsperando más eventos…
Lo que llega
X-Commercy-Event: order.createdX-Commercy-Event-Id: evt_01JC8K2M4QZ7R3T9X5B6N1V0ADX-Commercy-Delivery: dlv_01JC8K01…X-Commercy-Store: 6710b3c2e4a1f20012ab34ceX-Commercy-Timestamp: 1794225600X-Commercy-Signature: v1=1d9df1dc56844a91…{"id":"evt_01JC8K2M4QZ7R3T9X5B6N1V0AD","type":"order.created","created_at":"2026-11-09T12:00:00.000Z","store_id":"6710b3c2e4a1f20012ab34ce","data":{"id":"6710d1e0e4a1f20012ab3600","order_number":"A-000123","status":"pending","source":"storefront","shop_id":"6710b3c2e4a1f20012ab34cf","seller_shop_ids":["6710b3c2e4a1f20012ab34cf"],"customer":{"id":"6710e2f1e4a1f20012ab3700","name":"Lucía Fernández","email":"lucia@example.com","phone":"+5491155551111"},"line_items":[{"product_id":"6710c0d1e4a1f20012ab3500","variant_id":null,"sku":"YER-PLA-1K","name":"Yerba mate Playadito 1 kg","quantity":2,"unit_price":4950,"total":9900,"is_custom":false},{"product_id":"6710c0d1e4a1f20012ab3544","variant_id":null,"sku":"FER-BRA-750","name":"Fernet Branca 750 cc","quantity":1,"unit_price":8800,"total":8800,"is_custom":false}],"total":18700,"discount":0,"currency":"ARS","payment":{"gateway":"mercadopago","status":"pending"},"shipping":null,"created_at":"2026-11-09T12:00:00.000Z","updated_at":"2026-11-09T12:00:00.000Z"},"meta":{"status":"pending"}}

Tu verificación

  1. Leés el cuerpo crudo, antes de parsear el JSON.
  2. Calculás HMAC-SHA256(secreto, "1794225600.cuerpo") con tu secreto whsec_ejemplo_0123456789abcdef.
  3. Calculando…calculada—recibidav1=1d9df1dc5684…
  4. El timestamp está a 2 s de tu reloj; tolerás hasta 5 minutos.

···Verificando la firma…

Tocá una entrega y alterá el cuerpo

04 Desarrollá con IA

Dale la documentación a tu asistente. Y que arranque con un plan.

Toda la documentación en un solo archivo, lista para pasarle como contexto a Claude, Codex o Cursor antes de escribir una línea de código. Pedí los scopes mínimos y probá siempre en una tienda demo.

Si preferís partir de algo que ya funciona, commercy-app-examples reúne varias apps en Node para copiar y adaptar: un tablero de ventas con OAuth con PKCE y webhooks firmados, una app de envíos, una de cobros, un arranque de webhooks y scripts para la tienda online.

llms-full.txt Ver el repositorio en GitHub
prompt-de-arranque.md
Vas a construir una app de Commercy. Antes de escribir código, leé la documentacióncompleta en https://docs.commercy.com.ar/llms-full.txt y seguí sus reglas para asistentes de IA. Qué quiero construir: [descripción de la app, por ejemplo "sincronizar el stock con mi ERP"].Scopes que necesita (los mínimos): [por ejemplo read_products, write_stock].Stack: [lenguaje y framework del servidor]. Reglas:- Usá sólo los endpoints documentados; si algo no está en la documentación, preguntame.- OAuth con PKCE (S256) en el servidor, con el refresh token rotativo de un solo uso.- Los secretos (client secret, secreto de webhook, tokens) van en variables de entorno, nunca en el código.- Implementá los 4 webhooks obligatorios y verificá la firma con el cuerpo crudo y el timestamp.- Mandá Idempotency-Key en las escrituras y respetá Retry-After ante un 429. Empezá con un plan corto de los pasos y esperá mi OK antes de implementar.

markdown15 líneas3 campos para completar

Completá lo resaltado y pegalo en tu asistente

05 Publicar

Probás gratis. Cobrás directo, sin comisión.

Creás y probás tu app en tu propia tienda o en hasta 3 tiendas demo con datos ficticios, sin plan pago. Commercy la revisa en hasta 10 días hábiles y, si la aprueba, aparece en la Tienda de apps. Si es para un solo cliente, la publicás como no listada.

Primeros pasos en la documentación
ventas-al-diastatus: "draft"
demos
hasta 3
revisión
≤ 10 días hábiles
comisión
0 %
dev.commercy.com.arportal de developers
Ventas al díaEstudio NodoBorrador

Credenciales

client_id
app_7d41c2…
client secret
cs_…se muestra una sola vez
Redirect URI
http://localhost:3000/callbacken borrador podés usar localhost

Tocá un paso

Por qué Commercy

Un marketplace nuevo, con las reglas claras.

Sin comisión, con documentación abierta y con comercios que ya operan sobre el sistema.

  • 0 %comisión de Commercy

    0 % de comisión

    Si tu app es paga, el cobro es directo entre vos y el comerciante, fuera de Commercy. Nosotros no cobramos comisión.

  • 3tiendas demo, sin plan pago

    Crear y probar es gratis

    Registrate, creá tu app y probala en tu propia tienda o en hasta 3 tiendas demo con datos ficticios. No hace falta un plan pago.

  • ARCAfactura electrónica

    Comercios que ya facturan y venden

    Tu app llega a comercios argentinos que facturan en ARCA y venden online y en el local, sobre el mismo stock.

  • 2026-10≥ 12 meses de convivencia

    API versionada por fecha

    La versión va en la URL (hoy 2026-10) y se mantiene al menos 12 meses después de que sale la siguiente.

Comparación

Cómo se ve frente al programa de Tiendanube.

Datos públicos de Tiendanube a octubre de 2026. Su ecosistema es hoy más grande que el nuestro: el nuestro recién abre.

TemaCommercyTiendanubea octubre de 2026
Programa de socios
Comisión sobre tu app0 %. Le cobrás directo al comercioRevenue share para apps de pagos y envíos; el porcentaje no es público
Apps de cobroGuía pública con todos los endpoints; la habilitación como medio de pago la hace soporte tras tu pedidoGuía pública de Payment Provider; la Payments API no viene habilitada por defecto, hay que contactarlos, y auditan la app
Apps de envíoGuía pública: cotización en el checkout, alta y cancelación de envíos y seguimientoGuía pública de Shipping Carrier, con un callback_url para la cotización
RevisiónRevisión manual con checklist público, en hasta 10 días hábiles. Pedimos diagrama de secuencia y video de demoHomologación con diagrama de secuencia y video demo; NubeSDK obligatorio desde el 05/06/2026 para apps que inyectan scripts
Tecnología y alcance
IntegraciónAPI REST versionada por fecha, OAuth 2.0 con PKCE y webhooks firmados con HMACAPI REST, OAuth2 y webhooks
Catálogo de appsEl marketplace abre el 25 de octubre de 2026Más de 700 apps, según su propia tienda de apps

Fuentes de Tiendanube, consultadas en octubre de 2026: programa de socios tecnológicos, API, Payment Provider, Shipping Carrier, requisitos de homologación y tienda de aplicaciones.

Preguntas

Lo que preguntan los developers.

¿Otra duda? Escribinos por WhatsApp y te respondemos.

Hablar por WhatsApp
¿Cuánto cuesta crear una app?

Nada. Podés crearla y probarla en tu propia tienda y en hasta 3 tiendas demo sin necesidad de un plan pago.

¿Commercy cobra comisión?

No: es 0 %. Si tu app es paga, el cobro es directo entre vos y el comerciante, fuera de Commercy. En la ficha informás el modelo (gratis, pago o freemium) y el precio, sólo a modo informativo.

¿Cómo autentica mi app?

Con OAuth 2.0, authorization code más PKCE (S256), como cliente confidencial: el client secret vive en tu servidor. El access token dura 1 hora y el refresh token, 90 días y de un solo uso.

¿Cuánto tarda la revisión?

Hasta 10 días hábiles desde que la enviás. El checklist es público en la documentación y, si hay algo para corregir, te dejamos el motivo en el portal.

¿Qué comercios pueden instalar mi app?

Los que tengan un plan que incluya apps. Si un comercio baja de plan, la instalación sigue, pero la API y los webhooks no obligatorios quedan en pausa hasta que vuelva a uno que las incluya.

¿Puedo hacer una app solo para un cliente?

Sí. Las apps no listadas quedan publicadas pero no aparecen en la Tienda: se comparte el link de su ficha y el comercio la instala por el flujo normal.

¿Puedo desarrollarla con un asistente de IA?

Sí. Toda la documentación está en un solo archivo de texto, pensado para pasárselo como contexto a Claude, Codex o Cursor. Probá igual todo en una tienda demo antes de enviar a revisión.

¿Qué tengo que cumplir como partner?

Usar los datos del comercio sólo para la función de tu app, responder a los 4 webhooks obligatorios, guardar las credenciales de forma segura y responder por el soporte de tu app. Los términos completos están en la documentación.

Developers y partners

Tu app, frente a comercios que ya venden con Commercy.

Creá tu cuenta de developer, armá la app en una tienda demo y mandala a revisión cuando esté lista.

Crear y probar es gratis · 0 % de comisión