API i webhooki Fidelizando

Pierwsze kroki

Twój klucz API znajdziesz w panelu, w Integracjach. Wysyłaj go w każdym zapytaniu w nagłówku:

Authorization: Bearer fdz_tu_clave

Wszystkie adresy zaczynają się od https://fidelizando.io/api/v1, przyjmują JSON i odpowiadają JSON-em z "ok": true lub "ok": false oraz "error" po hiszpańsku. Klienta znajdziesz po jego email, jego telefono albo po codigo jego karty.

Adresy

GET/yo

Sprawdza, czy klucz działa, i zwraca firmę oraz rodzaj programu. Z niego korzysta Zapier, żeby przetestować połączenie.

Odpowiedź

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Karta z pieczątkami" }
}

POST/clientes

Zapisuje klienta i tworzy mu kartę (z prezentem powitalnym, jeśli go masz). Jeśli klient już istniał, zwraca jego kartę. consentimiento jest obowiązkowe: potwierdza, że klient zaakceptował twoją politykę prywatności.

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

Odpowiedź

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

POST/sumar

Dodaje na kartę. Przy pieczątkach cantidad pieczątek (1, jeśli nie podasz). Przy punktach tyle, ile wynika z importe według twojego programu. Uwzględnia twoje limity, np. maksymalną liczbę pieczątek dziennie.

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

Odpowiedź

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

GET/tarjetas?email=lucia@ejemplo.com

Sprawdza saldo i stan karty.

Odpowiedź

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

POST/canjear

Wydaje nagrodę, jeśli saldo wystarcza. Przy punktach premio to pozycja nagrody w twoim katalogu (0 to pierwsza).

{
  "codigo": "F5TGSLQRZE"
}

Odpowiedź

{
  "ok": true,
  "premio": "Kawa gratis",
  "tarjeta": { … }
}

Sklepy internetowe

Shopify i WooCommerce nie pozwalają dodawać nagłówków, więc klucz jest w adresie. Każde opłacone zamówienie liczy się raz na karcie kupującego (po jego e-mailu), nawet jeśli sklep powtórzy powiadomienie. Dokładne adresy z twoim kluczem znajdziesz w panelu.

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

Powiadomienia (webhooki)

Podaj w panelu adres https://, a za każdym razem, gdy coś się wydarzy, wyślemy ci POST z JSON-em. Jeśli twój serwer nie odpowie kodem 2xx, ponowimy próbę do 5 razy.

Zdarzenie	Kiedy
`cliente.alta`	Klient zakłada kartę (w twojej aplikacji, przy kasie albo przez API).
`tarjeta.suma`	Dodano pieczątki lub punkty, również prezenty (powitanie, urodziny, znajomi, zdrapka).
`tarjeta.canje`	Odebrano nagrodę.

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

Odbieranie powiadomień: „Webhooks by Zapier → Catch Hook” (w Make „Custom webhook”). Skopiuj jego adres do panelu.
Dodawanie lub zapis: „Webhooks by Zapier → POST” na https://fidelizando.io/api/v1/sumar lub /clientes, z nagłówkiem Authorization: Bearer i twoim kluczem.
Tak połączysz Square, Holded, Odoo, Revo, swój CRM albo arkusz Google: każda sprzedaż dodaje punkty na kartę klienta.

Potrzebujesz czegoś więcej? Napisz na hola@fidelizando.io.