API a webhooky Fidelizando

Začíname

Váš API kľúč nájdete v paneli v časti Integrácie. Posielajte ho v každej požiadavke v hlavičke:

Authorization: Bearer fdz_tu_clave

Všetky adresy začínajú https://fidelizando.io/api/v1, prijímajú JSON a odpovedajú JSON-om s "ok": true alebo "ok": false a "error" v španielčine. Na nájdenie zákazníka môžete použiť jeho email, jeho telefono alebo codigo jeho karty.

Adresy

GET/yo

Overí, že kľúč funguje, a vráti podnik a typ programu. Túto adresu používa Zapier na test pripojenia.

Odpoveď

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Pečiatková karta" }
}

POST/clientes

Zaregistruje zákazníka a vytvorí mu kartu (s uvítacím darčekom, ak ho máte zapnutý). Ak už existoval, vráti jeho kartu. consentimiento je povinné: potvrdzuje, že zákazník súhlasil s vašimi zásadami ochrany súkromia.

{
  "nombre": "Lucia Horváthová",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}

Odpoveď

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Lucia Horváthová",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Chýba vám 3 do: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Pripíše na kartu. Pri pečiatkach cantidad pečiatok (1, ak ho nepošlete). Pri bodoch tie, ktoré podľa vášho programu zodpovedajú importe. Rešpektuje vaše limity, napríklad maximum pečiatok za deň.

{
  "email": "lucia@ejemplo.com",
  "importe": 12.50,
  "concepto": "Ticket 1043"
}

Odpoveď

{
  "ok": true,
  "sumado": 1,
  "premio_listo": false,
  "tarjeta": { … }
}

GET/tarjetas?email=lucia@ejemplo.com

Zistí zostatok a stav karty.

Odpoveď

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Lucia Horváthová",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Chýba vám 3 do: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Uplatní odmenu, ak je zostatok dostatočný. Pri bodoch premio je poradie odmeny vo vašom katalógu (0 je prvá).

{
  "codigo": "F5TGSLQRZE"
}

Odpoveď

{
  "ok": true,
  "premio": "Káva zadarmo",
  "tarjeta": { … }
}

E-shopy

Shopify a WooCommerce nedovoľujú pridať hlavičky, preto je kľúč v adrese. Každá zaplatená objednávka sa pripíše na kartu kupujúceho (podľa e-mailu) len raz, aj keď obchod upozornenie zopakuje. Presné adresy s vaším kľúčom nájdete v paneli.

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

Upozornenia (webhooky)

Zadajte v paneli adresu https:// a pri každej udalosti vám pošleme POST s JSON-om. Ak váš server neodpovie kódom 2xx, skúsime to až 5-krát znova.

Udalosť	Kedy
`cliente.alta`	Zákazník si vytvorí kartu (vo vašej aplikácii, pri pulte alebo cez API).
`tarjeta.suma`	Pripíšu sa pečiatky alebo body, aj darčeky (uvítanie, narodeniny, kamaráti, stieraj a vyhraj).
`tarjeta.canje`	Uplatní sa odmena.

{
  "evento": "tarjeta.suma",
  "fecha": "2026-10-23T12:36:08+02:00",
  "codigo": "F5TGSLQRZE",
  "tipo": "suma",
  "cantidad": 1,
  "saldo": 7,
  "concepto": "Ticket 1043"
}

Zapier, Make a n8n

Prijímanie upozornení: „Webhooks by Zapier → Catch Hook“ (v Make „Custom webhook“). Jeho adresu skopírujte do panela.
Pripísanie alebo registrácia: „Webhooks by Zapier → POST“ na https://fidelizando.io/api/v1/sumar alebo /clientes, s hlavičkou Authorization: Bearer a vaším kľúčom.
Takto prepojíte Square, Holded, Odoo, Revo, svoje CRM alebo tabuľku Google: každý predaj sa pripíše na kartu zákazníka.

Potrebujete niečo ďalšie? Napíšte nám na hola@fidelizando.io.