Ningú apunta res a mà
El moment de sumar punts és el del cobrament, i allà qui mana és el TPV. Si ho fa ell, no s’oblida mai.
11TPV · cites
Que el teu TPV sumi els punts per tu
Una API REST per connectar la teva caixa, la teva agenda o la teva botiga en línia. Els punts se sumen en tancar el tiquet i la fitxa del client s’actualitza sola.
Autenticació
X-API-Key a la capçalera
Webhooks
signats amb HMAC-SHA256
Reintents
3, amb espera creixent
Què es guanya en connectar-ho
La fitxa està sempre al dia
Cada tiquet actualitza visites i saldo, així que les regles d’inactivitat funcionen amb dades reals.
El teu sistema s’assabenta del que passa
Els webhooks avisen quan algú desa una targeta, suma punts o bescanvia un premi, perquè ho reflecteixis on vulguis.
Com s’integra
Clau, crida i webhook.
-
1
Agafes la teva clau
Al panell, a Configuració → API. Viatja a la capçalera X-API-Key i no ha de sortir mai del servidor.
-
2
Crides en tancar el tiquet
POST /points/add amb els punts i el concepte. Hi ha endpoints per a targetes, notificacions, recompenses i imatges.
-
3
Escoltes els webhooks
Registres una URL HTTPS i reps card.added, points.added, reward.redeemed i card.deleted, signats perquè els puguis verificar.
OSA
Benvingut/da
Nom
Marta
Punts
240
Últim missatge
+20 punts. Gràcies per la teva visita.
OSA
Punts ›
TPV · cites
Preguntes
Està inclosa en tots els plans?
Sí, també en el gratuït.
On és la documentació?
A la pàgina de documentació, amb els endpoints, els exemples i una col·lecció de Postman per descarregar.
Com verifico que un webhook és vostre?
Cada enviament porta la capçalera X-Elune-Signature amb una signatura HMAC-SHA256. Si no quadra, descarta la petició.
Què passa si el meu servidor està caigut?
Es reintenta fins a tres vegades amb espera creixent. Si segueix sense respondre, aquell esdeveniment es perd, així que convé registrar el que arriba.
La teva targeta, llesta avui.
La dissenyes tu a l'assistent o te la deixem llesta en 24 h. Gratis fins a 20 targetes actives, amb tots els mòduls oberts.