Documentación de Cupontli

Tu plataforma de cupones.
Tus propios sistemas.

Emite, distribuye y canjea cupones desde el dashboard — o construye tu propio minteo, tu propio punto de venta y tus automatizaciones sobre la API. Todo lo que hace el dashboard humano, tu código lo puede escuchar.

Developers

Integra con la API

API keys, emisión y canje de cupones, webhooks firmados y reportes. Para el equipo que construye su propia integración.

Tu primer request →

Manual de usuario

Usa el dashboard

Campañas, diseños, políticas, equipo y reportes — la guía de la aplicación web, sin escribir código.

Abrir el manual →

Quickstart

POST /v1/coupons

Emite tu primer cupón con tu api key de test:

curl https://zm265ytff1.execute-api.us-east-1.amazonaws.com/prod/v1/coupons \
  --header 'Authorization: Bearer cup_test_...' \
  --header 'Content-Type: application/json' \
  --data '{"campaignId": "01ARZ3NDEKTSV4RRFFQ69G5FAV"}'

El cupon de la respuesta es el token al portador — conviértelo en QR, link o correo. Sigue en Mintear con la API.

Guías de integración

Las cuatro rutas que cubren la promesa completa de la plataforma:

  • Mintear con la API — tu sistema decide cuándo y a quién; Cupontli emite y firma.
  • Construir tu POS — enrola dispositivos, previsualiza, valida y canjea.
  • Webhooks — recibe canjes, minteos y el ciclo de campaña en tu backend, con firma HMAC.
  • Reportes — exporta campañas e inventario en CSV para conciliar contra tus sistemas.

Cómo funciona la API

REST con cuerpos JSON. Un solo header de autenticación — Authorization: Bearer <api key> — y dos ambientes aislados por prefijo de credencial: cup_test_ para probar sin tocar datos reales y cup_live_ para producción. Los códigos HTTP transportan la categoría del resultado y todo error trae un code estable para tu manejo programático (catálogo).

La spec OpenAPI completa de la superficie de integración está disponible en openapi.yaml — impórtala a Postman/Bruno o genera un cliente.