Intégration caisse · POS

Le tampon que personne n'oublie de donner. Parce que c'est la caisse qui le donne.

Le scan manuel, on connaît la chanson : le coup de feu de 8h, la queue jusqu'à la porte, et la carte de fidélité qu'on zappe « pour aller plus vite ». Résultat : le client repart sans son tampon, et votre programme de fidélité ne tourne qu'à moitié. Branchez votre caisse à Habitu : à chaque encaissement, le tampon tombe tout seul dans la carte Wallet du client. Zéro geste en plus, zéro tampon oublié.

Connexion en 5 minutes · aucune installation

4 micro-étapes, puis c'est automatique.

  1. 1

    Générez votre clé API

    Dans Habitu → Paramètres → Boutique en ligne → « Générer ma clé API ». Vous obtenez une clé hbt_live_…. Copiez-la.

  2. 2

    Ouvrez les webhooks de votre caisse

    Dans votre logiciel de caisse : Réglages → Webhooks (ou « Connexions » / « API »). Créez un webhook sur l'évènement « vente encaissée ».

  3. 3

    Collez l'URL et l'en-tête

    URL https://habitu.fr/api/v1/orders/stamp, en-tête Authorization: Bearer hbt_live_…, corps JSON avec l'email (ou le téléphone) du client + le montant.

  4. 4

    Encaissez une vente test

    Le point/tampon tombe sur la carte Wallet du client, qui reçoit la mise à jour. C'est fini, chaque vente suivante est automatique.

Zéro serveur à installerPas de webhook sur votre caisse ? Même résultat en 5 min via Zapier / Make (voir plus bas).

Sans connecteur

Le scan qu'on oublie

  • · « Vous avez la carte ? » à répéter toute la journée
  • · Oublié dès qu'il y a du monde
  • · Le client de passage n'est jamais fidélisé
  • · Des données de visite incomplètes

Avec le connecteur caisse

La fidélité en pilote auto

  • Le tampon/point se crédite à l'encaissement, sans rien demander
  • Zéro friction au comptoir, même en plein rush
  • Le client reçoit sa mise à jour Wallet sur le téléphone
  • Chaque euro dépensé compte (mode Points proportionnel)

1. Votre clé API

Générée en un clic dans vos paramètres. Elle autorise votre caisse à créditer la fidélité.

2. Un webhook dans la caisse

Vous collez l'URL Habitu sur l'évènement « vente encaissée » de votre logiciel de caisse.

3. La fidélité est automatique

À chaque vente, +1 tampon (ou des points selon le montant). Le client est notifié. Vous, vous encaissez.

Étape 1, autoriser votre caisse

Récupérez votre clé API

Dans Habitu, allez dans Paramètres → Boutique en ligne et cliquez sur « Générer ma clé API ». Vous obtenez une clé du type hbt_live_…. C'est elle que votre caisse présentera à chaque vente. Gardez-la secrète.

Ouvrir mes paramètres

Étape 2, l'URL à coller dans votre caisse

Un webhook par vente encaissée

Dans les réglages « Webhooks » / « API » / « Connexions » de votre caisse, ajoutez un appel POST sur l'évènement « vente encaissée / ticket clôturé », avec l'email (ou le téléphone) du client. C'est lui qui relie l'achat à la bonne carte.

POST https://habitu.fr/api/v1/orders/stamp

curl -X POST https://habitu.fr/api/v1/orders/stamp \
  -H "Authorization: Bearer hbt_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "client@email.fr",
    "amount": 12.50,
    "orderId": "TICKET-10245"
  }'

Ce que la caisse envoie

  • email ou phone, identifie le client (au moins un)
  • amount, montant TTC payé en € (mode Points)
  • units, nombre de tampons à ajouter (optionnel, ex. par article)
  • items, détail des articles (optionnel) pour les bonus par produit
  • orderId, n° de ticket, évite les doublons

Ce que Habitu répond

  • 200, tampon/points ajoutés, solde renvoyé
  • 200 duplicate, ticket déjà crédité, pas de double
  • 404 no_card, pas encore de carte, signupUrl à montrer au client
  • 401/403, clé invalide ou abonnement résilié

C'est le même endpoint que l'intégration e-commerce, une caisse, c'est juste une « commande » encaissée au comptoir. Détails techniques complets sur la page boutique en ligne.

Étape 3, relier la vente au bon client

Comment la caisse sait qui c'est

Habitu retrouve la carte par email ou téléphone. Trois façons de l'obtenir au comptoir, du plus fluide au plus simple :

Le client a un compte caisse

Si votre caisse a déjà l'email/le téléphone du client (compte fidélité caisse, programme existant), le webhook le transmet directement. Rien à faire de plus.

Scan du QR de la carte

Le client présente sa carte Wallet, vous scannez le QR avec la caisse ou l'app Habitu : la vente est reliée en un geste. Idéal quand la caisse ne demande pas l'email.

Saisie rapide

Le client donne son email/téléphone à l'encaissement (champ « client »). Une fois relié la première fois, les ventes suivantes peuvent l'être automatiquement si la caisse mémorise le client.

Pas de caisse moderne ? Le scan QR manuel reste dispo et fonctionne parfaitement avec un système de points et de paliers.

Caisse sans webhook natif ?

Via Zapier ou Make, sans code

Beaucoup de caisses (SumUp, certaines configs Tactill) se branchent à Zapier/Make. En glisser-déposer :

  1. Déclencheur : « Nouvelle vente / paiement réussi » depuis votre caisse.
  2. Action : module « Webhooks → POST » vers https://habitu.fr/api/v1/orders/stamp.
  3. En-tête Authorization: Bearer hbt_live_… et corps JSON avec l'email/le téléphone de la vente.

Adapté à votre métier

Tampons, points, ou les deux

Mode Tampons

1 vente = 1 tampon (la 10ᵉ offerte). Pour créditer plusieurs tampons d'un coup (ex. par article), envoyez units. Simple, parfait pour la baguette ou le café.

Mode Points (conseillé en caisse)

Le montant amount est converti selon votre réglage points/€, avec des paliers de récompense (ex. 100 pts = −5 €, 250 pts = formule offerte). Chaque euro compte. Réglable dans Personnaliser.

Règles de points avancées, réglables en quelques clics

Dans Personnaliser, en mode Points, vous activez en 5 secondes :

  • Jour à points multipliés, « le mercredi, points doublés ». Une case à cocher, un jour, ×2 ou ×3. S'applique tout seul, sans rien envoyer depuis la caisse.
  • Bonus par produit, « +10 points sur les viennoiseries ». Un mot-clé, un nombre de points. Il suffit que votre caisse envoie le détail des articles (items) dans le webhook.

Votre caisse est compatible

Tactill

Très répandu en boulangerie/pâtisserie/traiteur (iPad). Réglages → Connexions/Webhooks → ajoutez l'URL Habitu sur l'évènement « vente encaissée ».

Synapsy

Boulangerie-pâtisserie avec pesage. API/webhooks disponibles : pointez l'évènement de ticket clôturé vers l'URL Habitu.

SumUp

TPE mobile + caisse. Pas de webhook natif fin ? Reliez « paiement réussi » à Habitu via Zapier/Make en 2 min.

Lightspeed

Resto/retail. Webhooks natifs sur les ventes : configurez l'endpoint Habitu sur l'évènement « sale completed ».

Caisse AWE / Caisse Connectée

Exports/webhooks selon version. Si pas de webhook, passez par Zapier/Make sur l'évènement de vente.

Autre caisse moderne

Toute caisse qui sait poster un webhook HTTP (ou qui se branche à Zapier/Make) fonctionne. Un seul POST par vente suffit.

Règle simple : si votre caisse peut envoyer un webhook HTTP (ou se brancher à Zapier/Make), elle est compatible. Un doute sur la vôtre ? Écrivez-nous, on regarde ensemble : contact@habitu.fr.

Bon à savoir

Les cas particuliers

Le client n'a pas encore de carte

L'API répond 404 no_card avec un signupUrl. Affichez votre QR d'inscription au comptoir : une fois la carte créée, ses prochains passages sont crédités automatiquement.

Vente annulée ou remboursée

Déclenchez l'appel uniquement sur « vente encaissée », jamais sur un ticket en attente. Un remboursement ne retire pas automatiquement le tampon déjà donné, ne créditez que sur un paiement réellement encaissé.

Webhook envoyé deux fois

Les caisses peuvent réémettre un webhook en cas de coupure réseau. Envoyez toujours votre numéro de ticket dans orderId : Habitu reconnaît un ticket déjà crédité et ne double pas le tampon.

Questions fréquentes

Avant de connecter votre caisse.

Ma caisse est-elle compatible avec Habitu ?

+
Oui dès lors qu'elle peut envoyer un webhook HTTP, ou se brancher à Zapier/Make. C'est le cas de Tactill, Synapsy, Lightspeed, SumUp et de la plupart des caisses modernes. En cas de doute, écrivez à contact@habitu.fr.

Faut-il installer un logiciel sur la caisse ?

+
Non. Vous collez une URL et une clé API dans les réglages webhook de votre caisse, sur l'évènement « vente encaissée ». Aucune installation, aucun serveur à héberger. Comptez environ 5 minutes.

Comment le client est-il identifié à l'encaissement ?

+
Par son email ou son téléphone. Trois options : la caisse a déjà le client (compte fidélité caisse), vous scannez le QR de sa carte Wallet, ou vous saisissez son email à l'encaissement. Une fois relié, les ventes suivantes sont créditées automatiquement.

Que se passe-t-il si une vente est remboursée ?

+
Ne déclenchez le crédit que sur l'évènement « vente encaissée », jamais sur un ticket en attente. Un remboursement ne retire pas automatiquement le tampon déjà accordé : créditez uniquement sur un paiement réellement encaissé.

Tampons ou points pour une caisse ?

+
Les points sont conseillés en caisse : le montant payé est converti selon votre réglage points/euro, avec des paliers de récompense. Vous pouvez aussi activer un jour à points multipliés (ex. mercredi ×2) ou un bonus par produit (ex. +10 sur les viennoiseries) en quelques clics.

La fidélité qui se donne toute seule

Branchez votre caisse une fois, oubliez le scan manuel. Essai gratuit 30 jours, configuration en quelques minutes.

Démarrer l'essai gratuit