API et webhooks : connectez votre carte

Pour commencer

Votre clé d’API se trouve dans votre tableau de bord, rubrique Intégrations. Envoyez-la à chaque requête dans l’en-tête :

Authorization: Bearer fdz_tu_clave

Toutes les adresses commencent par https://fidelizando.io/api/v1, reçoivent du JSON et répondent en JSON avec "ok": true ou "ok": false et un "error" en espagnol. Pour retrouver un client, vous pouvez utiliser son email, son telefono ou le codigo de sa carte.

Adresses

GET/yo

Vérifie que la clé fonctionne et renvoie le commerce et le type de programme. C’est celle qu’utilise Zapier pour tester la connexion.

Réponse

{
  "ok": true,
  "negocio": { "nombre": "Café Martina", "slug": "cafe-martina" },
  "programa": { "tipo": "sellos", "nombre": "Carte à tampons" }
}

POST/clientes

Inscrit un client et crée sa carte (avec le cadeau de bienvenue s’il est activé). S’il existe déjà, renvoie sa carte. consentimiento est obligatoire : il confirme que le client a accepté votre politique de confidentialité.

{
  "nombre": "Léa Martin",
  "email": "lucia@ejemplo.com",
  "consentimiento": true,
  "marketing": false
}

Réponse

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Léa Martin",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Te faltan 3 para: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/sumar

Crédite la carte. Pour les tampons, cantidad tampons (1 si vous ne l’envoyez pas). Pour les points, ceux qui correspondent au importe selon votre programme. Vos limites s’appliquent, comme le maximum de tampons par jour.

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

Réponse

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

GET/tarjetas?email=lucia@ejemplo.com

Consulte le solde et l’état d’une carte.

Réponse

{
  "ok": true,
  "tarjeta": {
    "codigo": "F5TGSLQRZE",
    "nombre": "Léa Martin",
    "email": "lucia@ejemplo.com",
    "programa": "sellos",
    "saldo": 6,
    "estado": "Te faltan 3 para: café gratis",
    "visitas": 6,
    "app": "https://fidelizando.io/c/cafe-martina"
  }
}

POST/canjear

Utilise la récompense si le solde est suffisant. Pour les points, premio est la position de la récompense dans votre catalogue (0 pour la première).

{
  "codigo": "F5TGSLQRZE"
}

Réponse

{
  "ok": true,
  "premio": "Café offert",
  "tarjeta": { … }
}

Boutiques en ligne

Shopify et WooCommerce ne permettent pas d’ajouter des en-têtes, la clé va donc dans l’adresse. Chaque commande payée crédite une seule fois la carte de l’acheteur (par son e-mail), même si la boutique renvoie la notification. Les adresses exactes, avec votre clé, sont dans votre tableau de bord.

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

Webhooks

Indiquez dans votre tableau de bord une adresse https:// et nous vous enverrons un POST en JSON à chaque événement. Si votre serveur ne répond pas avec un code 2xx, nous réessayons jusqu’à 5 fois.

Événement	Quand
`cliente.alta`	Un client prend la carte (dans votre appli, au comptoir ou par l’API).
`tarjeta.suma`	Des tampons ou des points sont ajoutés, cadeaux compris (bienvenue, anniversaire, parrainage, grattez et gagnez).
`tarjeta.canje`	Une récompense est utilisée.

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

Zapier, Make et n8n

Recevoir les webhooks : « Webhooks by Zapier → Catch Hook » (dans Make, « Custom webhook »). Copiez son adresse dans votre tableau de bord.
Créditer ou inscrire : « Webhooks by Zapier → POST » vers https://fidelizando.io/api/v1/sumar ou /clientes, avec l’en-tête Authorization: Bearer et votre clé.
C’est ainsi que vous connectez Square, Holded, Odoo, Revo, votre CRM ou une feuille Google : chaque vente crédite la carte de votre client.

Besoin d’autre chose ? Écrivez-nous à hola@fidelizando.io.