API и webhooks на Fidelizando

Начало

API ключът ви е в панела, в Интеграции. Изпращайте го с всяка заявка в заглавката:

Authorization: Bearer fdz_tu_clave

Всички адреси започват с https://fidelizando.io/api/v1, приемат JSON и отговарят с JSON с "ok": true или "ok": false и "error" на испански. За да намерите клиент, става неговият email, неговият telefono или codigo на картата му.

Адреси

GET/yo

Проверява дали ключът работи и връща бизнеса и вида програма. Това използва Zapier, за да тества връзката.

Отговор

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Карта с печати" }
}

POST/clientes

Регистрира клиент и му създава карта (с подаръка за добре дошли, ако е включен). Ако вече съществува, връща картата му. consentimiento е задължително: потвърждава, че е приел политиката ви за поверителност.

{
  "nombre": "Мария Петрова",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}

Отговор

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Мария Петрова",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Остават ви 3 до: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Добавя към картата. При печати cantidad печата (1, ако не го изпратите). При точки тези, които съответстват на importe според програмата ви. Спазва ограниченията ви, например максималния брой печати на ден.

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

Отговор

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

GET/tarjetas?email=lucia@ejemplo.com

Проверява баланса и състоянието на карта.

Отговор

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Мария Петрова",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Остават ви 3 до: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Осребрява наградата, ако балансът стига. При точки premio е позицията на наградата в каталога ви (0 е първата).

{
  "codigo": "F5TGSLQRZE"
}

Отговор

{
  "ok": true,
  "premio": "Безплатно кафе",
  "tarjeta": { … }
}

Онлайн магазини

Shopify и WooCommerce не позволяват заглавки, затова ключът е в адреса. Всяка платена поръчка се добавя веднъж към картата на купувача (по имейла му), дори ако магазинът повтори известието. Точните адреси с вашия ключ са в панела ви.

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

Известия (webhooks)

Въведете в панела си адрес https:// и ще ви изпращаме POST с JSON всеки път, когато се случи нещо. Ако сървърът ви не отговори с код 2xx, опитваме отново до 5 пъти.

Събитие	Кога
`cliente.alta`	Клиент си създава карта (в приложението ви, на щанда или през API).
`tarjeta.suma`	Добавят се печати или точки, включително подаръци (добре дошли, рожден ден, приятели, изтрий и спечели).
`tarjeta.canje`	Осребрява се награда.

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

Zapier, Make и n8n

Получаване на известия: „Webhooks by Zapier → Catch Hook“ (в Make „Custom webhook“). Копирайте адреса му в панела си.
Добавяне или регистрация: „Webhooks by Zapier → POST“ към https://fidelizando.io/api/v1/sumar или /clientes, със заглавката Authorization: Bearer и вашия ключ.
Така свързвате Square, Holded, Odoo, Revo, своя CRM или таблица в Google: всяка продажба се добавя към картата на клиента ви.

Трябва ви нещо друго? Пишете ни на hola@fidelizando.io.