Conecta tu tarjeta
con todo lo que usas.

Una API sencilla para sumar sellos y puntos desde tu TPV, tu tienda online o Zapier, y avisos en tiempo real cuando pasa algo en tu programa.

Empezar

Tu clave de API está en tu panel, en Integraciones. Mándala en cada petición con la cabecera:

Authorization: Bearer fdz_tu_clave

Todas las direcciones empiezan por https://fidelizando.io/api/v1, reciben JSON y responden JSON con "ok": true o "ok": false y un "error" en español. Para encontrar a un cliente vale su email, su telefono o el codigo de su tarjeta.

Direcciones

GET/yo

Comprueba que la clave funciona y te dice el negocio y el tipo de programa. Es la que usa Zapier para probar la conexión.

Respuesta
{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Tarjeta de sellos" }
}
POST/clientes

Da de alta a un cliente y le crea la tarjeta (con el regalo de bienvenida si lo tienes activo). Si ya existía, devuelve su tarjeta. consentimiento es obligatorio: confirma que ha aceptado tu política de privacidad.

{
  "nombre": "Lucía Martín",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}
Respuesta
{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Lucía Martín",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Te faltan 3 para: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}
POST/sumar

Suma a la tarjeta. En sellos, cantidad sellos (1 si no la mandas). En puntos, los que correspondan al importe según tu programa. Respeta tus límites, como el máximo de sellos al día.

{
  "email": "lucia@ejemplo.com",
  "importe": 12.50,
  "concepto": "Ticket 1043"
}
Respuesta
{
  "ok": true,
  "sumado": 1,
  "premio_listo": false,
  "tarjeta": { … }
}
GET/tarjetas?email=lucia@ejemplo.com

Consulta el saldo y el estado de una tarjeta.

Respuesta
{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Lucía Martín",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Te faltan 3 para: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}
POST/canjear

Canjea el premio si tiene saldo suficiente. En puntos, premio es la posición del premio en tu catálogo (0 el primero).

{
  "codigo": "F5TGSLQRZE"
}
Respuesta
{
  "ok": true,
  "premio": "Café gratis",
  "tarjeta": { … }
}

Tiendas online

Shopify y WooCommerce no dejan poner cabeceras, así que la clave va en la dirección. Cada pedido pagado suma una vez a la tarjeta del comprador (por su email), aunque la tienda repita el aviso. Las direcciones exactas, con tu clave, están en tu panel.

https://fidelizando.io/api/v1/tiendas/shopify?clave=fdz_tu_clave
https://fidelizando.io/api/v1/tiendas/woocommerce?clave=fdz_tu_clave

Avisos (webhooks)

Pon en tu panel una dirección https:// y te mandaremos un POST con JSON cada vez que pase algo. Si tu servidor no contesta con un código 2xx, lo reintentamos hasta 5 veces.

EventoCuándo
cliente.altaUn cliente se hace la tarjeta (en tu app, en el mostrador o por la API).
tarjeta.sumaSe suman sellos o puntos, también los regalos (bienvenida, cumpleaños, amigos, rasca y gana).
tarjeta.canjeSe canjea un premio.
{
  "evento": "tarjeta.suma",
  "fecha": "2026-10-23T12:36:08+02:00",
  "codigo": "F5TGSLQRZE",
  "tipo": "suma",
  "cantidad": 1,
  "saldo": 7,
  "concepto": "Ticket 1043"
}

Zapier, Make y n8n

  1. Recibir avisos: «Webhooks by Zapier → Catch Hook» (en Make, «Custom webhook»). Copia su dirección en tu panel.
  2. Sumar o dar de alta: «Webhooks by Zapier → POST» a https://fidelizando.io/api/v1/sumar o /clientes, con la cabecera Authorization: Bearer y tu clave.
  3. Así conectas Square, Holded, Odoo, Revo, tu CRM o una hoja de Google: cada venta suma a la tarjeta de tu cliente.

¿Necesitas algo más? Escríbenos a hola@fidelizando.io.