Qué es esta API

La Nuvlyx API es un conjunto de endpoints REST que le permiten al dueño de una tienda Nuvlyx integrar su sistema externo (bot de WhatsApp, ERP, panel propio, scripts de inventario) con la tienda. Es de tipo server-to-server, autenticada con un Personal Access Token (PAT) que usted mismo genera desde el panel.

Todos los endpoints están bajo el prefijo:

https://api.nuvlyx.com/api/v1/external/

Inicio rápido

1. Cree un token desde el panel

Entre a su panel de la tienda y vaya a Configuración → API Tokens → Crear token. Asigne los permisos (scopes) que su integración va a necesitar y guarde el token mostrado una sola vez.

2. Haga su primer request

curl https://api.nuvlyx.com/api/v1/external/products \
  -H "Authorization: Bearer nvl_live_TU_TOKEN"

3. Lea la respuesta

[
  {
    "id": "0f1c…",
    "name": "Suscripción 1 mes",
    "slug": "suscripcion-1-mes",
    "kind": "DIGITAL",
    "status": "ACTIVE",
    "variations": [
      { "id": "abc…", "sku": "SUB-1M", "price": "10000.00", "stockQuantity": 42 }
    ]
  }
]

Convenciones

Formato: todas las respuestas y cuerpos son JSON (UTF-8).
Fechas: ISO 8601 en UTC. Ejemplo: 2026-05-18T14:30:00.000Z.
Montos: cadenas decimales con 2 decimales en la moneda base de la tienda. Ejemplo: "10000.00".
IDs: UUID v4.
Teléfonos: formato E.164 estricto. Ejemplo: +573001234567.
Errores: HTTP estándar (401, 403, 404, 422, 500). Cuerpo: { "statusCode": ..., "message": "...", "error": "..." }.

Endpoints disponibles

Método	Ruta	Permiso
`GET`	`/external/products`	`products:read`
`GET`	`/external/products/:id`	`products:read`
`GET`	`/external/products/:id/price`	`products:read`
`GET`	`/external/orders`	`orders:read`
`GET`	`/external/orders/:id`	`orders:read`
`POST`	`/external/orders`	`orders:write`
`GET`	`/external/customers/:id`	`customers:read`
`GET`	`/external/customers/by-phone/:phone`	`customers:read`
`GET`	`/external/customers/:id/wallet`	`wallet:read`
`GET`	`/external/customers/by-phone/:phone/wallet`	`wallet:read`
`POST`	`/external/customers/:id/wallet/recharge`	`wallet:write`
`POST`	`/external/customers/by-phone/:phone/wallet/recharge`	`wallet:write`
`POST`	`/external/products`	`products:write`
`GET`	`/external/inventory/stock`	`inventory:read`
`POST`	`/external/inventory/licenses`	`inventory:write`
`GET`	`/external/webhooks`	`webhooks:manage`
`POST`	`/external/webhooks`	`webhooks:manage`
`DELETE`	`/external/webhooks/:id`	`webhooks:manage`
`GET`	`/external/webhooks/:id/deliveries`	`webhooks:manage`

Lea también: errores, rate limits, idempotencia, paginación y webhooks.

WhatsApp · powered by Mosend

Nuvlyx no envía WhatsApp directamente: delega la entrega a la organización Mosend del OWNER. Cada tienda conecta su propia cuenta de Mosend desde Configuración → WhatsApp (Mosend) en el admin. Mosend factura al OWNER directo; nosotros solo ruteamos el evento al template correcto.

Si quieres mandar WhatsApp programáticamente desde tu integración, usa la API key de Mosend del OWNER contra https://api.mosend.dev — los endpoints públicos de Nuvlyx no exponen un proxy de envío.

Docs de Mosend: developer.mosend.dev.

¿Necesita ayuda?

Escríbanos a hola@nuvlyx.com o únase a la comunidad en Telegram donde compartimos integraciones de otros revendedores y resolvemos dudas.

Nuvlyx API v1