Pieslēdziet karti
visam, ko izmantojat.

Vienkārša API zīmogu un punktu pievienošanai no kases, interneta veikala vai Zapier, un paziņojumi reāllaikā, kad jūsu programmā kaut kas notiek.

Sākums

Jūsu API atslēga ir vadības panelī, sadaļā Integrācijas. Sūtiet to ar katru pieprasījumu galvenē:

Authorization: Bearer fdz_tu_clave

Visas adreses sākas ar https://fidelizando.io/api/v1, pieņem JSON un atbild ar JSON ar "ok": true vai "ok": false un "error" spāņu valodā. Klientu var atrast pēc viņa email, viņa telefono vai kartes codigo.

Adreses

GET/yo

Pārbauda, vai atslēga darbojas, un atgriež uzņēmumu un programmas veidu. To izmanto Zapier savienojuma pārbaudei.

Atbilde
{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Zīmogu karte" }
}
POST/clientes

Reģistrē klientu un izveido viņam karti (ar sveiciena dāvanu, ja tā ir ieslēgta). Ja klients jau bija, atgriež viņa karti. consentimiento ir obligāts: apstiprina, ka klients piekritis jūsu privātuma politikai.

{
  "nombre": "Anna Bērziņa",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}
Atbilde
{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Anna Bērziņa",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Trūkst 3 līdz: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}
POST/sumar

Pieskaita kartei. Zīmogu gadījumā cantidad zīmogi (1, ja nesūtāt). Punktu gadījumā tik, cik atbilst importe atbilstoši jūsu programmai. Ievēro jūsu ierobežojumus, piemēram, maksimālo zīmogu skaitu dienā.

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

Parāda kartes atlikumu un statusu.

Atbilde
{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Anna Bērziņa",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Trūkst 3 līdz: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}
POST/canjear

Izsniedz balvu, ja atlikums ir pietiekams. Punktu gadījumā premio ir balvas vieta jūsu katalogā (0 ir pirmā).

{
  "codigo": "F5TGSLQRZE"
}
Atbilde
{
  "ok": true,
  "premio": "Bezmaksas kafija",
  "tarjeta": { … }
}

Interneta veikali

Shopify un WooCommerce neļauj pievienot galvenes, tāpēc atslēga ir adresē. Katrs apmaksāts pasūtījums pircēja kartei (pēc e-pasta) tiek pieskaitīts vienreiz, pat ja veikals paziņojumu atkārto. Precīzas adreses ar jūsu atslēgu ir vadības panelī.

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

Paziņojumi (webhook)

Vadības panelī norādiet adresi https://, un katru reizi, kad kaut kas notiks, nosūtīsim POST ar JSON. Ja jūsu serveris neatbild ar 2xx kodu, mēģinām līdz 5 reizēm.

NotikumsKad
cliente.altaKlients iegūst karti (jūsu lietotnē, pie letes vai caur API).
tarjeta.sumaTiek pieskaitīti zīmogi vai punkti, arī dāvanas (sveiciens, dzimšanas diena, draugi, nokasi un laimē).
tarjeta.canjeTiek izmantota balva.
{
  "evento": "tarjeta.suma",
  "fecha": "2026-10-23T12:36:08+02:00",
  "codigo": "F5TGSLQRZE",
  "tipo": "suma",
  "cantidad": 1,
  "saldo": 7,
  "concepto": "Ticket 1043"
}

Zapier, Make un n8n

  1. Paziņojumu saņemšana: „Webhooks by Zapier → Catch Hook“ (Make platformā „Custom webhook“). Iekopējiet tā adresi vadības panelī.
  2. Pieskaitīšana vai reģistrācija: „Webhooks by Zapier → POST“ uz https://fidelizando.io/api/v1/sumar vai /clientes, ar galveni Authorization: Bearer un jūsu atslēgu.
  3. Tā pieslēdzat Square, Holded, Odoo, Revo, savu CRM vai Google izklājlapu: katrs pirkums tiek pieskaitīts klienta kartei.

Vajag vēl kaut ko? Rakstiet mums hola@fidelizando.io.