Prijunkite kortelę
prie visko, ką naudojate.

Paprasta API spaudams ir taškams pridėti iš kasos, internetinės parduotuvės ar Zapier, ir pranešimai realiuoju laiku, kai jūsų programoje kas nors nutinka.

Pradžia

Jūsų API raktas yra valdymo skydelyje, skiltyje Integracijos. Siųskite jį su kiekviena užklausa antraštėje:

Authorization: Bearer fdz_tu_clave

Visi adresai prasideda https://fidelizando.io/api/v1, priima JSON ir atsako JSON su "ok": true arba "ok": false ir "error" ispanų kalba. Klientą galima rasti pagal jo email, jo telefono arba kortelės codigo.

Adresai

GET/yo

Patikrina, ar raktas veikia, ir grąžina verslą bei programos tipą. Ją naudoja Zapier ryšiui patikrinti.

Atsakymas
{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Spaudų kortelė" }
}
POST/clientes

Užregistruoja klientą ir sukuria jam kortelę (su pasveikinimo dovana, jei ją įjungėte). Jei klientas jau buvo, grąžina jo kortelę. consentimiento privalomas: patvirtina, kad klientas sutiko su jūsų privatumo politika.

{
  "nombre": "Ieva Petraitė",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}
Atsakymas
{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Ieva Petraitė",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Liko 3 iki: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}
POST/sumar

Prideda prie kortelės. Spaudų atveju cantidad spaudai (1, jei nesiunčiate). Taškų atveju tiek, kiek atitinka importe pagal jūsų programą. Laikomasi jūsų apribojimų, pavyzdžiui, didžiausio spaudų skaičiaus per dieną.

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

Parodo kortelės likutį ir būseną.

Atsakymas
{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Ieva Petraitė",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Liko 3 iki: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}
POST/canjear

Išduoda prizą, jei likučio pakanka. Taškų atveju premio yra prizo vieta jūsų kataloge (0 yra pirmas).

{
  "codigo": "F5TGSLQRZE"
}
Atsakymas
{
  "ok": true,
  "premio": "Nemokama kava",
  "tarjeta": { … }
}

Internetinės parduotuvės

Shopify ir WooCommerce neleidžia pridėti antraščių, todėl raktas yra adrese. Kiekvienas apmokėtas užsakymas pirkėjo kortelei (pagal el. paštą) pridedamas vieną kartą, net jei parduotuvė pranešimą pakartoja. Tikslūs adresai su jūsų raktu yra valdymo skydelyje.

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

Pranešimai (webhook)

Valdymo skydelyje nurodykite adresą https:// ir kiekvieną kartą, kai kas nors nutiks, atsiųsime POST su JSON. Jei jūsų serveris neatsako 2xx kodu, bandome iki 5 kartų.

ĮvykisKada
cliente.altaKlientas gauna kortelę (jūsų programėlėje, prie prekystalio ar per API).
tarjeta.sumaPridedami spaudai ar taškai, taip pat dovanos (pasveikinimas, gimtadienis, draugai, nutrink ir laimėk).
tarjeta.canjeAtsiimamas prizas.
{
  "evento": "tarjeta.suma",
  "fecha": "2026-10-23T12:36:08+02:00",
  "codigo": "F5TGSLQRZE",
  "tipo": "suma",
  "cantidad": 1,
  "saldo": 7,
  "concepto": "Ticket 1043"
}

Zapier, Make ir n8n

  1. Pranešimų gavimas: „Webhooks by Zapier → Catch Hook“ (Make platformoje „Custom webhook“). Nukopijuokite jo adresą į valdymo skydelį.
  2. Pridėjimas arba registracija: „Webhooks by Zapier → POST“ į https://fidelizando.io/api/v1/sumar arba /clientes, su antrašte Authorization: Bearer ir jūsų raktu.
  3. Taip prijungiate Square, Holded, Odoo, Revo, savo CRM ar Google skaičiuoklę: kiekvienas pardavimas pridedamas prie kliento kortelės.

Reikia ko nors daugiau? Rašykite mums hola@fidelizando.io.