API Tampo

Ajoutez des tampons, créez des cartes et lisez leur statut depuis votre caisse, votre site ou un outil no-code (Zapier, Make). API REST en JSON. Réservée au plan Pro.

Authentification

Générez une clé dans Développeurs, puis passez-la dans l’en-tête Authorization de chaque requête. Base : https://tampoo.fr/api/v1

Authorization: Bearer tampo_live_xxxxxxxxxxxx

Endpoints

GET/programs

Liste vos programmes de fidélité (id, objectif, récompense…).

curl https://tampoo.fr/api/v1/programs \
  -H "Authorization: Bearer tampo_live_xxx"

POST/cards

Crée une carte client et renvoie son token + l’URL publique (à envoyer au client ou à encoder en QR). Corps JSON : programId (requis), firstName, lastName, email, phone, startStamps.

curl -X POST https://tampoo.fr/api/v1/cards \
  -H "Authorization: Bearer tampo_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"programId":"prog_123","firstName":"Camille","email":"camille@ex.fr"}'

# → { "token": "aB3...", "url": "https://tampoo.fr/c/aB3...", "stampCount": 0 }

POST/stamps

Ajoute un tampon à une carte (anti double-scan + déblocage de récompense + notification push automatiques). C’est l’endpoint à appeler depuis une caisse au moment du paiement.

curl -X POST https://tampoo.fr/api/v1/stamps \
  -H "Authorization: Bearer tampo_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"token":"aB3..."}'

# → { "stampCount": 8, "stampsGoal": 10, "rewardUnlocked": false, ... }

GET/cards/:token

Récupère l’état d’une carte (tampons, récompenses disponibles).

curl https://tampoo.fr/api/v1/cards/aB3... \
  -H "Authorization: Bearer tampo_live_xxx"

Réponses & erreurs

Toutes les réponses sont en JSON. En cas d’erreur, le corps contient { "error": "..." } avec un code HTTP : 401 clé invalide, 403 plan insuffisant, 404 ressource introuvable, 409 tampon trop rapproché.

Une intégration spécifique en tête ? Écrivez-nous →