Primeros pasos

De cero a tu primera llamada en cinco minutos.

1. Habilitá la API en tu cuenta

La API se habilita por cuenta. Pedísela a Kicket en kicket@kicket.club desde el mail del dueño. En una cadena se habilita en la casa matriz y vale para todas sus sucursales.

2. Creá la credencial

Entrá a Kicket con la cuenta del dueño (en una cadena, la de la casa matriz).
Andá a Integraciones › API de Kicket y tocá Nueva credencial.
Ponele un nombre que diga qué sistema la usa («ERP de la cadena»), elegí el entorno (Producción o Prueba) y los permisos que necesita. Los datos personales de los clientes (customers:read) vienen apagados: prendelos sólo si tu sistema los necesita.
Copiá el client_secret o bajá el archivo kicket-api.env. El secreto se muestra una sola vez: Kicket guarda sólo su huella y no lo puede volver a mostrar. Si lo perdés, rotalo.

El archivo trae las tres variables que usan todos los ejemplos de esta guía:

kicket-api.env

KICKET_API_URL=https://kicket.club/api/v1
KICKET_CLIENT_ID=kc_live_8Fq2zLp4N7mR1wY6vB3k
KICKET_CLIENT_SECRET=kk_live_…

El secreto va en el servidor de tu sistema (una variable de entorno, un gestor de secretos), nunca en una página web, una app ni un repositorio. Ver Buenas prácticas.

3. Pedí el token y hacé la primera llamada

Se canjea la credencial por un token en POST /oauth/token y con ese token se llama a la API. La primera llamada, GET /, dice con qué cuenta y en qué entorno estás hablando: si ves el nombre de tu comercio, quedó bien conectado.

set -a; source kicket-api.env; set +a

# 1. El token (con jq para quedarte sólo con access_token)
TOKEN=$(curl -s -X POST "$KICKET_API_URL/oauth/token" \
  -u "$KICKET_CLIENT_ID:$KICKET_CLIENT_SECRET" \
  -d grant_type=client_credentials | jq -r .access_token)

# 2. La primera llamada: con qué cuenta y en qué entorno estás hablando
curl -s "$KICKET_API_URL" -H "Authorization: Bearer $TOKEN"

La respuesta:

Respuesta de GET /

{
  "object": "api",
  "version": "1",
  "docs_url": "https://kicket.club/desarrolladores",
  "openapi_url": "https://kicket.club/api/v1/openapi.json",
  "account": {
    "id": "65f1c0a2b7e4d91a3c5e7f10",
    "name": "Café Modelo"
  },
  "environment": "live"
}

El token dura una hora. Guardalo y reusalo: no pidas uno por cada llamada (el endpoint de token tiene su propio límite). También podés probar la conexión sin escribir código, con Probar conexión en el panel.

4. Traé tus ventas

Con el permiso sales:read, las ventas de una jornada (de 06:00 a 06:00 de cada sucursal). Cada venta trae sus renglones y sus pagos.

curl -s "$KICKET_API_URL/sales?business_date=2026-10-27&limit=50" \
  -H "Authorization: Bearer $TOKEN"

Qué sigue

Para tener tu base al día sin perder nada, seguí la receta de sincronización.
Si querés enterarte apenas se cobra una venta, configurá un webhook.
Para cuadrar tus números con los de Kicket, mirá Conciliación.
Importá el OpenAPI en Postman o generá un cliente tipado.