API și webhooks: conectează-ți cardul

Începe

Cheia ta de API se află în panou, la Integrări. Trimite-o la fiecare cerere cu antetul:

Authorization: Bearer fdz_tu_clave

Toate adresele încep cu https://fidelizando.io/api/v1, primesc JSON și răspund cu JSON cu "ok": true sau "ok": false și un "error" în spaniolă. Pentru a găsi un client poți folosi email, telefono sau codigo de pe cardul lui.

Adrese

GET/yo

Verifică dacă cheia funcționează și îți spune afacerea și tipul de program. Pe aceasta o folosește Zapier ca să testeze conexiunea.

Răspuns

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Card cu ștampile" }
}

POST/clientes

Înscrie un client și îi creează cardul (cu cadoul de bun venit, dacă îl ai activ). Dacă exista deja, îi returnează cardul. consentimiento este obligatoriu: confirmă că a acceptat politica ta de confidențialitate.

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

Răspuns

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Ioana Popescu",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Îți mai lipsesc 3 pentru: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Adaugă pe card. La ștampile, cantidad ștampile (1 dacă nu o trimiți). La puncte, cele corespunzătoare pentru importe după programul tău. Respectă limitele tale, cum ar fi numărul maxim de ștampile pe zi.

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

Răspuns

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

GET/tarjetas?email=lucia@ejemplo.com

Consultă soldul și starea unui card.

Răspuns

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Ioana Popescu",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Îți mai lipsesc 3 pentru: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Acordă premiul dacă soldul e suficient. La puncte, premio este poziția premiului în catalogul tău (0 primul).

{
  "codigo": "F5TGSLQRZE"
}

Răspuns

{
  "ok": true,
  "premio": "Cafea gratuită",
  "tarjeta": { … }
}

Magazine online

Shopify și WooCommerce nu permit antete, așa că cheia merge în adresă. Fiecare comandă plătită adaugă o singură dată pe cardul cumpărătorului (după email), chiar dacă magazinul repetă notificarea. Adresele exacte, cu cheia ta, sunt în panou.

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

Notificări (webhooks)

Pune în panou o adresă https:// și îți trimitem un POST cu JSON de fiecare dată când se întâmplă ceva. Dacă serverul tău nu răspunde cu un cod 2xx, reîncercăm de până la 5 ori.

Eveniment	Când
`cliente.alta`	Un client își ia cardul (în aplicația ta, la tejghea sau prin API).
`tarjeta.suma`	Se adaugă ștampile sau puncte, inclusiv cadourile (bun venit, ziua de naștere, prieteni, răzuiește și câștigă).
`tarjeta.canje`	Se revendică un premiu.

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

Zapier, Make și n8n

Primești notificări: «Webhooks by Zapier → Catch Hook» (în Make, «Custom webhook»). Copiază adresa lui în panou.
Adaugi sau înscrii: «Webhooks by Zapier → POST» la https://fidelizando.io/api/v1/sumar sau /clientes, cu antetul Authorization: Bearer și cheia ta.
Așa conectezi Square, Holded, Odoo, Revo, CRM-ul tău sau un tabel Google: fiecare vânzare se adaugă pe cardul clientului.

Ai nevoie de altceva? Scrie-ne la hola@fidelizando.io.