API en webhooks van Fidelizando

Aan de slag

Je API-sleutel staat in je dashboard, bij Integraties. Stuur hem bij elk verzoek mee in de header:

Authorization: Bearer fdz_tu_clave

Alle adressen beginnen met https://fidelizando.io/api/v1, ontvangen JSON en antwoorden met JSON met "ok": true of "ok": false en een "error" in het Spaans. Om een klant te vinden kun je zijn email, zijn telefono of de codigo van zijn kaart gebruiken.

Adressen

GET/yo

Controleert of de sleutel werkt en geeft de zaak en het soort programma terug. Zapier gebruikt deze om de verbinding te testen.

Antwoord

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

POST/clientes

Meldt een klant aan en maakt zijn kaart aan (met het welkomstcadeau als je dat aan hebt staan). Bestond hij al, dan krijg je zijn kaart terug. consentimiento is verplicht: het bevestigt dat de klant je privacybeleid heeft geaccepteerd.

{
  "nombre": "Sanne de Vries",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}

Antwoord

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Sanne de Vries",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Nog 3 te gaan voor: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Schrijft bij op de kaart. Bij stempels cantidad stempels (1 als je niets meestuurt). Bij punten het aantal dat volgens je programma hoort bij het importe. Houdt rekening met je limieten, zoals het maximale aantal stempels per dag.

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

Antwoord

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

GET/tarjetas?email=lucia@ejemplo.com

Vraagt het saldo en de status van een kaart op.

Antwoord

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Sanne de Vries",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Nog 3 te gaan voor: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Wisselt de beloning in als het saldo voldoende is. Bij punten is premio de positie van de beloning in je catalogus (0 is de eerste).

{
  "codigo": "F5TGSLQRZE"
}

Antwoord

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

Webwinkels

Shopify en WooCommerce laten geen headers toe, dus de sleutel staat in het adres. Elke betaalde bestelling telt één keer mee op de kaart van de koper (via zijn e-mailadres), ook als de winkel de melding herhaalt. De exacte adressen, met je sleutel, staan in je dashboard.

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

Meldingen (webhooks)

Zet in je dashboard een adres https:// en we sturen je elke keer dat er iets gebeurt een POST met JSON. Antwoordt je server niet met een 2xx-code, dan proberen we het tot 5 keer opnieuw.

Gebeurtenis	Wanneer
`cliente.alta`	Een klant maakt de kaart aan (in je app, aan de toonbank of via de API).
`tarjeta.suma`	Er komen stempels of punten bij, ook cadeaus (welkom, verjaardag, vrienden, kraskaart).
`tarjeta.canje`	Er wordt een beloning ingewisseld.

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

Zapier, Make en n8n

Meldingen ontvangen: ‘Webhooks by Zapier → Catch Hook’ (in Make ‘Custom webhook’). Kopieer het adres naar je dashboard.
Bijschrijven of aanmelden: ‘Webhooks by Zapier → POST’ naar https://fidelizando.io/api/v1/sumar of /clientes, met de header Authorization: Bearer en je sleutel.
Zo koppel je Square, Holded, Odoo, Revo, je CRM of een Google-spreadsheet: elke verkoop telt mee op de kaart van je klant.

Heb je nog iets nodig? Mail ons op hola@fidelizando.io.