Fidelizando API i webhookovi

Početak

Vaš API ključ nalazi se u nadzornoj ploči, pod Integracije. Šaljite ga u svakom zahtjevu u zaglavlju:

Authorization: Bearer fdz_tu_clave

Sve adrese počinju s https://fidelizando.io/api/v1, primaju JSON i odgovaraju JSON-om s "ok": true ili "ok": false i "error" na španjolskom. Za pronalazak kupca vrijedi njegov email, njegov telefono ili codigo njegove kartice.

Adrese

GET/yo

Provjerava radi li ključ i vraća poduzeće i vrstu programa. Nju koristi Zapier za testiranje veze.

Odgovor

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Kartica s pečatima" }
}

POST/clientes

Registrira kupca i izrađuje mu karticu (s poklonom dobrodošlice ako ga imate uključenog). Ako već postoji, vraća njegovu karticu. consentimiento je obavezno: potvrđuje da je prihvatio vaša pravila privatnosti.

{
  "nombre": "Lucija Horvat",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}

Odgovor

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Lucija Horvat",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Nedostaje vam 3 do: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Dodaje na karticu. Kod pečata cantidad pečata (1 ako ga ne pošaljete). Kod bodova, one koji odgovaraju iznosu importe prema vašem programu. Poštuje vaša ograničenja, poput najvećeg broja pečata dnevno.

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

Odgovor

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

GET/tarjetas?email=lucia@ejemplo.com

Provjerava stanje i status kartice.

Odgovor

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Lucija Horvat",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Nedostaje vam 3 do: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Iskorištava nagradu ako je stanje dovoljno. Kod bodova premio je pozicija nagrade u vašem katalogu (0 je prva).

{
  "codigo": "F5TGSLQRZE"
}

Odgovor

{
  "ok": true,
  "premio": "Besplatna kava",
  "tarjeta": { … }
}

Web trgovine

Shopify i WooCommerce ne dopuštaju zaglavlja, pa je ključ u adresi. Svaka plaćena narudžba jednom se dodaje na karticu kupca (prema e-pošti), čak i ako trgovina ponovi obavijest. Točne adrese s vašim ključem nalaze se u nadzornoj ploči.

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

Obavijesti (webhookovi)

U nadzornu ploču unesite adresu https:// i poslat ćemo vam POST s JSON-om svaki put kad se nešto dogodi. Ako vaš poslužitelj ne odgovori kodom 2xx, pokušavamo ponovno do 5 puta.

Događaj	Kada
`cliente.alta`	Kupac izradi karticu (u vašoj aplikaciji, na pultu ili preko API-ja).
`tarjeta.suma`	Dodaju se pečati ili bodovi, uključujući poklone (dobrodošlica, rođendan, prijatelji, ogrebi i osvoji).
`tarjeta.canje`	Iskoristi se nagrada.

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

Zapier, Make i n8n

Primanje obavijesti: „Webhooks by Zapier → Catch Hook“ (u Makeu „Custom webhook“). Kopirajte njegovu adresu u nadzornu ploču.
Dodavanje ili registracija: „Webhooks by Zapier → POST“ na https://fidelizando.io/api/v1/sumar ili /clientes, sa zaglavljem Authorization: Bearer i vašim ključem.
Tako povezujete Square, Holded, Odoo, Revo, svoj CRM ili Google tablicu: svaka prodaja dodaje se na karticu vašeg kupca.

Trebate još nešto? Pišite nam na hola@fidelizando.io.