API και webhooks: σύνδεσε την κάρτα σου

Σύνδεσε την κάρτα σου
με ό,τι χρησιμοποιείς.

Ένα απλό API για να προσθέτεις σφραγίδες και πόντους από το POS, το ηλεκτρονικό κατάστημα ή το Zapier, και ειδοποιήσεις σε πραγματικό χρόνο όταν συμβαίνει κάτι στο πρόγραμμά σου.

Ξεκίνα

Το κλειδί 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 δεν επιτρέπουν κεφαλίδες, οπότε το κλειδί μπαίνει στη διεύθυνση. Κάθε πληρωμένη παραγγελία προσθέτει μία φορά στην κάρτα του αγοραστή (με το email του), ακόμη κι αν το κατάστημα επαναλάβει την ειδοποίηση. Τις ακριβείς διευθύνσεις, με το κλειδί σου, τις βρίσκεις στον πίνακα.

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 κάθε φορά που συμβαίνει κάτι. Αν ο server σου δεν απαντήσει με κωδικό 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.