API a webhooky: propojte věrnostní kartu

Začínáme

Váš API klíč najdete v panelu v části Integrace. Posílejte ho v každém požadavku v hlavičce:

Authorization: Bearer fdz_tu_clave

Všechny adresy začínají https://fidelizando.io/api/v1, přijímají JSON a odpovídají JSON s "ok": true nebo "ok": false a "error" ve španělštině. Zákazníka najdete podle email, telefono nebo codigo jeho karty.

Adresy

GET/yo

Ověří, že klíč funguje, a vrátí podnik a typ programu. Tuto adresu používá Zapier k otestování spojení.

Odpověď

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Razítková karta" }
}

POST/clientes

Zaregistruje zákazníka a vytvoří mu kartu (s uvítacím dárkem, pokud ho máte zapnutý). Pokud už existoval, vrátí jeho kartu. consentimiento je povinné: potvrzuje, že souhlasil s vašimi zásadami ochrany osobních údajů.

{
  "nombre": "Lucie Novotná",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}

Odpověď

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Lucie Novotná",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Do odměny c zbývá: 3afé gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Připíše na kartu. U razítek cantidad razítek (1, pokud ho nepošlete). U bodů tolik, kolik odpovídá importe podle vašeho programu. Dodržuje vaše limity, například maximum razítek za den.

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

Odpověď

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

GET/tarjetas?email=lucia@ejemplo.com

Zjistí zůstatek a stav karty.

Odpověď

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Lucie Novotná",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Do odměny c zbývá: 3afé gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Uplatní odměnu, pokud je zůstatek dostatečný. U bodů premio je pozice odměny ve vašem katalogu (0 je první).

{
  "codigo": "F5TGSLQRZE"
}

Odpověď

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

E-shopy

Shopify a WooCommerce neumožňují nastavit hlavičky, proto je klíč v adrese. Každá zaplacená objednávka se kupujícímu připíše na kartu jen jednou (podle e-mailu), i když obchod upozornění zopakuje. Přesné adresy s vaším klíčem najdete v panelu.

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

Upozornění (webhooky)

Zadejte v panelu adresu https:// a pokaždé, když se něco stane, vám pošleme POST s JSON. Pokud váš server neodpoví kódem 2xx, zkusíme to až 5krát znovu.

Událost	Kdy
`cliente.alta`	Zákazník si pořídí kartu (ve vaší aplikaci, u pultu nebo přes API).
`tarjeta.suma`	Připíší se razítka nebo body, včetně dárků (uvítání, narozeniny, přátelé, stírej a vyhraj).
`tarjeta.canje`	Uplatní se odměna.

{
  "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

Příjem upozornění: «Webhooks by Zapier → Catch Hook» (v Make «Custom webhook»). Jeho adresu zkopírujte do panelu.
Připsání nebo registrace: «Webhooks by Zapier → POST» na https://fidelizando.io/api/v1/sumar nebo /clientes s hlavičkou Authorization: Bearer a vaším klíčem.
Takto propojíte Square, Holded, Odoo, Revo, své CRM nebo tabulku Google: každý prodej se připíše na kartu zákazníka.

Potřebujete něco dalšího? Napište nám na hola@fidelizando.io.