Fidelizandos API og webhooks

Kom i gang

Din API-nøgle ligger i dit panel under Integrationer. Send den med hver forespørgsel i headeren:

Authorization: Bearer fdz_tu_clave

Alle adresser starter med https://fidelizando.io/api/v1, modtager JSON og svarer med JSON med "ok": true eller "ok": false og en "error" på spansk. For at finde en kunde kan du bruge kundens email, kundens telefono eller kortets codigo.

Adresser

GET/yo

Tjekker, at nøglen virker, og returnerer forretningen og typen af program. Den bruger Zapier til at teste forbindelsen.

Svar

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Stempelkort" }
}

POST/clientes

Opretter en kunde og laver kortet (med velkomstgaven, hvis du har den slået til). Fandtes kunden allerede, returneres kortet. consentimiento er obligatorisk: det bekræfter, at kunden har accepteret din privatlivspolitik.

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

Svar

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Freja Nielsen",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Du mangler 3 til: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Lægger til på kortet. Ved stempler cantidad stempler (1, hvis du ikke sender noget). Ved point det antal, der svarer til importe efter dit program. Overholder dine grænser, som maks. antal stempler om dagen.

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

Svar

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

GET/tarjetas?email=lucia@ejemplo.com

Viser saldo og status for et kort.

Svar

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Freja Nielsen",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Du mangler 3 til: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Indløser belønningen, hvis saldoen rækker. Ved point er premio belønningens plads i dit katalog (0 er den første).

{
  "codigo": "F5TGSLQRZE"
}

Svar

{
  "ok": true,
  "premio": "Gratis kaffe",
  "tarjeta": { … }
}

Webshops

Shopify og WooCommerce tillader ikke headers, så nøglen står i adressen. Hver betalt ordre tæller én gang på køberens kort (via e-mailen), også selv om butikken gentager beskeden. De præcise adresser med din nøgle ligger i dit panel.

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

Beskeder (webhooks)

Angiv en adresse i dit panel https://, så sender vi en POST med JSON, hver gang der sker noget. Svarer din server ikke med en 2xx-kode, prøver vi igen op til 5 gange.

Hændelse	Hvornår
`cliente.alta`	En kunde får kortet (i din app, ved disken eller via API’et).
`tarjeta.suma`	Der lægges stempler eller point til, også gaver (velkomst, fødselsdag, venner, skrabelod).
`tarjeta.canje`	En belønning bliver indløst.

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

Zapier, Make og n8n

Modtag beskeder: “Webhooks by Zapier → Catch Hook” (i Make “Custom webhook”). Kopiér adressen til dit panel.
Læg til eller opret: “Webhooks by Zapier → POST” til https://fidelizando.io/api/v1/sumar eller /clientes, med headeren Authorization: Bearer og din nøgle.
Sådan forbinder du Square, Holded, Odoo, Revo, dit CRM eller et Google-regneark: hvert salg lægges på din kundes kort.

Har du brug for mere? Skriv til hola@fidelizando.io.