API és webhookok: kösse össze a kártyáját

Kezdés

API-kulcsát a panelen találja, az Integrációk menüpontban. Minden kérésben küldje el ebben a fejlécben:

Authorization: Bearer fdz_tu_clave

Minden cím így kezdődik: https://fidelizando.io/api/v1, JSON-t fogadnak, és JSON-nel válaszolnak, amelyben "ok": true vagy "ok": false és egy spanyol nyelvű "error" szerepel. Az ügyfelet megtalálhatja a email, a telefono vagy a kártyája codigo alapján.

Címek

GET/yo

Ellenőrzi, hogy a kulcs működik-e, és visszaadja a vállalkozást és a program típusát. Ezt használja a Zapier a kapcsolat tesztelésére.

Válasz

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Pecsétgyűjtő kártya" }
}

POST/clientes

Felvesz egy ügyfelet, és létrehozza a kártyáját (az üdvözlő ajándékkal, ha bekapcsolta). Ha már létezett, a kártyáját adja vissza. consentimiento kötelező: megerősíti, hogy elfogadta az Ön adatvédelmi tájékoztatóját.

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

Válasz

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Nagy Lilla",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Még 3 hiányzik ehhez: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Jóváír a kártyán. Pecséteknél cantidad pecsét (1, ha nem küldi). Pontoknál annyi, amennyi a(z) importe után jár a programja szerint. Betartja a korlátait, például a napi maximális pecsétszámot.

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

Válasz

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

GET/tarjetas?email=lucia@ejemplo.com

Lekérdezi egy kártya egyenlegét és állapotát.

Válasz

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Nagy Lilla",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Még 3 hiányzik ehhez: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Beváltja a jutalmat, ha elég az egyenleg. Pontoknál a premio a jutalom helye a katalógusában (0 az első).

{
  "codigo": "F5TGSLQRZE"
}

Válasz

{
  "ok": true,
  "premio": "Ingyen kávé",
  "tarjeta": { … }
}

Webáruházak

A Shopify és a WooCommerce nem enged fejléceket, ezért a kulcs a címben szerepel. Minden kifizetett rendelés egyszer íródik jóvá a vásárló kártyáján (az e-mail-címe alapján), akkor is, ha a bolt megismétli az értesítést. A pontos címeket a kulcsával együtt a panelen találja.

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

Értesítések (webhookok)

Adjon meg a panelen egy https:// címet, és minden esemény után JSON-t tartalmazó POST-ot küldünk. Ha a szervere nem 2xx kóddal válaszol, legfeljebb 5-ször újrapróbáljuk.

Esemény	Mikor
`cliente.alta`	Egy ügyfél kártyát kér (az Ön alkalmazásában, a pultnál vagy az API-n keresztül).
`tarjeta.suma`	Pecsétek vagy pontok jóváírása, az ajándékokat is beleértve (üdvözlés, születésnap, barátok, kaparós nyeremény).
`tarjeta.canje`	Egy jutalom beváltása.

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

Zapier, Make és n8n

Értesítések fogadása: «Webhooks by Zapier → Catch Hook» (a Make-ben «Custom webhook»). Másolja a címét a panelre.
Jóváírás vagy felvétel: «Webhooks by Zapier → POST» ide: https://fidelizando.io/api/v1/sumar vagy /clientes, a Authorization: Bearer fejléccel és a kulcsával.
Így kapcsolhatja össze a Square-t, a Holdedet, az Odoót, a Revót, a CRM-jét vagy egy Google-táblázatot: minden eladás jóváíródik az ügyfél kártyáján.

Másra is szüksége van? Írjon nekünk: hola@fidelizando.io.