API in webhooki Fidelizando: povežite kartico

Začetek

Vaš ključ API je na nadzorni plošči, v razdelku Integracije. Pošljite ga z vsako zahtevo v glavi:

Authorization: Bearer fdz_tu_clave

Vsi naslovi se začnejo z https://fidelizando.io/api/v1, sprejemajo JSON in odgovarjajo z JSON-om z "ok": true ali "ok": false in "error" v španščini. Stranko najdete po njenem email, njenem telefono ali po codigo njene kartice.

Naslovi

GET/yo

Preveri, ali ključ deluje, in vrne podjetje ter vrsto programa. Z njim Zapier preizkusi povezavo.

Odgovor

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Kartica z žigi" }
}

POST/clientes

Registrira stranko in ji ustvari kartico (z darilom dobrodošlice, če ga imate vklopljenega). Če je že obstajala, vrne njeno kartico. consentimiento je obvezen: potrjuje, da je sprejela vašo politiko zasebnosti.

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

Odgovor

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Ana Novak",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Do nagrade c manjka še: 3afé gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Doda na kartico. Pri žigih cantidad žigov (1, če ga ne pošljete). Pri točkah toliko, kolikor ustreza znesku importe po vašem programu. Upošteva vaše omejitve, na primer največ žigov na dan.

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

Preveri stanje in status kartice.

Odgovor

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Ana Novak",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Do nagrade c manjka še: 3afé gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Unovči nagrado, če je stanja dovolj. Pri točkah premio je mesto nagrade v vašem katalogu (0 je prva).

{
  "codigo": "F5TGSLQRZE"
}

Odgovor

{
  "ok": true,
  "premio": "Brezplačna kava",
  "tarjeta": { … }
}

Spletne trgovine

Shopify in WooCommerce ne dovolita lastnih glav, zato je ključ v naslovu. Vsako plačano naročilo se na kupčevo kartico (po e-pošti) doda enkrat, tudi če trgovina obvestilo ponovi. Natančni naslovi z vašim ključem so na nadzorni plošči.

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

Obvestila (webhooki)

Na nadzorni plošči vnesite naslov https:// in poslali vam bomo POST z JSON-om vsakič, ko se kaj zgodi. Če vaš strežnik ne odgovori s kodo 2xx, poskusimo do 5-krat.

Dogodek	Kdaj
`cliente.alta`	Stranka pridobi kartico (v vaši aplikaciji, na pultu ali prek API-ja).
`tarjeta.suma`	Dodajo se žigi ali točke, tudi darila (dobrodošlica, rojstni dan, prijatelji, praskaj in zadeni).
`tarjeta.canje`	Unovči 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 in n8n

Prejemanje obvestil: »Webhooks by Zapier → Catch Hook« (v Make »Custom webhook«). Njegov naslov kopirajte na nadzorno ploščo.
Dodajanje ali registracija: »Webhooks by Zapier → POST« na https://fidelizando.io/api/v1/sumar ali /clientes, z glavo Authorization: Bearer in vašim ključem.
Tako povežete Square, Holded, Odoo, Revo, svoj CRM ali Googlovo preglednico: vsaka prodaja se doda na kartico vaše stranke.

Potrebujete še kaj? Pišite nam na hola@fidelizando.io.