Yhdistä korttisi
kaikkeen, mitä käytät.

Yksinkertainen API leimojen ja pisteiden kerryttämiseen kassajärjestelmästä, verkkokaupasta tai Zapierista, ja reaaliaikaiset ilmoitukset, kun ohjelmassasi tapahtuu jotain.

Aloitus

API-avaimesi löytyy hallintapaneelista kohdasta Integraatiot. Lähetä se jokaisessa pyynnössä otsakkeella:

Authorization: Bearer fdz_tu_clave

Kaikki osoitteet alkavat https://fidelizando.io/api/v1, vastaanottavat JSONia ja vastaavat JSONilla, jossa on "ok": true tai "ok": false ja "error" espanjaksi. Asiakkaan löytämiseen käy hänen email, hänen telefono tai kortin codigo.

Osoitteet

GET/yo

Tarkistaa, että avain toimii, ja kertoo yrityksen ja ohjelmatyypin. Tätä Zapier käyttää yhteyden testaamiseen.

Vastaus
{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Leimakortti" }
}
POST/clientes

Lisää asiakkaan ja luo hänelle kortin (tervetuliaislahjan kera, jos se on käytössä). Jos asiakas on jo olemassa, palauttaa hänen korttinsa. consentimiento on pakollinen: se vahvistaa, että asiakas on hyväksynyt tietosuojaselosteesi.

{
  "nombre": "Aino Virtanen",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}
Vastaus
{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Aino Virtanen",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Sinulta puuttuu 3: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}
POST/sumar

Kerryttää korttia. Leimoissa cantidad leimaa (1, jos et lähetä sitä). Pisteissä ohjelmasi mukaan importe vastaavat pisteet. Noudattaa rajojasi, kuten päivän enimmäisleimamäärää.

{
  "email": "lucia@ejemplo.com",
  "importe": 12.50,
  "concepto": "Ticket 1043"
}
Vastaus
{
  "ok": true,
  "sumado": 1,
  "premio_listo": false,
  "tarjeta": { … }
}
GET/tarjetas?email=lucia@ejemplo.com

Näyttää kortin saldon ja tilan.

Vastaus
{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Aino Virtanen",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Sinulta puuttuu 3: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}
POST/canjear

Lunastaa palkinnon, jos saldo riittää. Pisteissä premio on palkinnon sijainti luettelossasi (0 on ensimmäinen).

{
  "codigo": "F5TGSLQRZE"
}
Vastaus
{
  "ok": true,
  "premio": "Ilmainen kahvi",
  "tarjeta": { … }
}

Verkkokaupat

Shopify ja WooCommerce eivät salli otsakkeita, joten avain kulkee osoitteessa. Jokainen maksettu tilaus kerryttää ostajan korttia (sähköpostin perusteella) kerran, vaikka kauppa toistaisi ilmoituksen. Tarkat osoitteet avaimineen ovat hallintapaneelissasi.

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

Ilmoitukset (webhookit)

Lisää hallintapaneeliisi osoite https://, niin lähetämme POST-pyynnön JSONilla aina, kun jotain tapahtuu. Jos palvelimesi ei vastaa 2xx-koodilla, yritämme uudelleen enintään 5 kertaa.

TapahtumaMilloin
cliente.altaAsiakas hankkii kortin (sovelluksessasi, tiskillä tai API:n kautta).
tarjeta.sumaLeimoja tai pisteitä kertyy, myös lahjat (tervetuliainen, syntymäpäivä, ystävät, raaputa ja voita).
tarjeta.canjePalkinto lunastetaan.
{
  "evento": "tarjeta.suma",
  "fecha": "2026-10-23T12:36:08+02:00",
  "codigo": "F5TGSLQRZE",
  "tipo": "suma",
  "cantidad": 1,
  "saldo": 7,
  "concepto": "Ticket 1043"
}

Zapier, Make ja n8n

  1. Ilmoitusten vastaanotto: ”Webhooks by Zapier → Catch Hook” (Makessa ”Custom webhook”). Kopioi sen osoite hallintapaneeliisi.
  2. Kerryttäminen tai asiakkaan lisääminen: ”Webhooks by Zapier → POST” osoitteeseen https://fidelizando.io/api/v1/sumar tai /clientes, otsakkeella Authorization: Bearer ja avaimellasi.
  3. Näin liität Squaren, Holdedin, Odoon, Revon, CRM:si tai Google-taulukon: jokainen myynti kerryttää asiakkaasi korttia.

Tarvitsetko jotain muuta? Kirjoita meille osoitteeseen hola@fidelizando.io.