Fidelizandos API och webhooks

Kom igång

Din API-nyckel finns i panelen under Integrationer. Skicka den med varje anrop i rubriken:

Authorization: Bearer fdz_tu_clave

Alla adresser börjar med https://fidelizando.io/api/v1, tar emot JSON och svarar med JSON med "ok": true eller "ok": false och ett "error" på spanska. För att hitta en kund kan du använda kundens email, kundens telefono eller kortets codigo.

Adresser

GET/yo

Kontrollerar att nyckeln fungerar och returnerar företaget och typen av program. Zapier använder den för att testa kopplingen.

Svar

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

POST/clientes

Registrerar en kund och skapar kortet (med välkomstgåvan om du har den påslagen). Om kunden redan fanns returneras kortet. consentimiento är obligatoriskt: det bekräftar att kunden har godkänt din integritetspolicy.

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

Svar

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

POST/sumar

Lägger till på kortet. För stämplar cantidad stämplar (1 om du inte skickar något). För poäng det antal som motsvarar importe enligt ditt program. Respekterar dina gränser, som max antal stämplar per dag.

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

Visar saldot och statusen för ett kort.

Svar

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

POST/canjear

Löser in belöningen om saldot räcker. För poäng är premio belöningens plats i din katalog (0 är den första).

{
  "codigo": "F5TGSLQRZE"
}

Svar

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

Webbutiker

Shopify och WooCommerce tillåter inga rubriker, så nyckeln ligger i adressen. Varje betald order räknas en gång på köparens kort (via e-posten), även om butiken skickar aviseringen flera gånger. De exakta adresserna, med din nyckel, finns i panelen.

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

Aviseringar (webhooks)

Ange en adress i panelen https:// så skickar vi en POST med JSON varje gång något händer. Om din server inte svarar med en 2xx-kod försöker vi igen upp till 5 gånger.

Händelse	När
`cliente.alta`	En kund skaffar kortet (i din app, vid disken eller via API:t).
`tarjeta.suma`	Stämplar eller poäng läggs till, även presenter (välkomst, födelsedag, vänner, skraplott).
`tarjeta.canje`	En belöning löses in.

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

Zapier, Make och n8n

Ta emot aviseringar: ”Webhooks by Zapier → Catch Hook” (i Make ”Custom webhook”). Kopiera adressen till din panel.
Lägga till eller registrera: ”Webhooks by Zapier → POST” till https://fidelizando.io/api/v1/sumar eller /clientes, med rubriken Authorization: Bearer och din nyckel.
Så kopplar du Square, Holded, Odoo, Revo, ditt CRM eller ett Google-kalkylark: varje försäljning läggs på kundens kort.

Behöver du något mer? Skriv till hola@fidelizando.io.