Référence API

L'API Summa permet une intégration directe avec ton système de caisse. Après chaque vente, un appel API crée un tampon sur ticket — une URL à usage unique imprimée sous forme de QR code sur le ticket.

Authentification

Chaque appel API nécessite une clé API. La clé est envoyée comme jeton Bearer dans l'en-tête Authorization.

Crée une clé API sous Paramètres → Clés API dans le tableau de bord de ta boutique. Settings → API Keys
Copie la clé immédiatement — elle n'est affichée qu'une seule fois.
Envoie la clé en en-tête : Authorization: Bearer TA_CLE

Créer un tampon sur ticket

POST /api/receipt-stamp

Crée un tampon sur ticket à usage unique. L'URL retournée est imprimée sous forme de QR code sur le ticket. Chaque code est à usage unique et expire après 48 heures.

Request body

Le corps de la requête est facultatif. Si ta boutique n'a qu'un seul programme, il est sélectionné automatiquement. Avec plusieurs programmes, utilise programId pour préciser quel programme doit recevoir le tampon.

Response body

url: URL complète pour le QR code — le client la scanne avec son téléphone.
code: Le code du tampon (partie de l'URL). Utile pour la journalisation ou le débogage.
expiresAt: Horodatage d'expiration au format ISO 8601. Après cette date, le code ne peut plus être utilisé.

Exemple

curl -X POST https://your-domain.com/api/receipt-stamp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Codes d'erreur

Status Code	Meaning
`401`	Clé API manquante ou invalide. Vérifie l'en-tête Authorization.
`400`	Programme invalide. Le programId n'existe pas ou n'appartient pas à ta boutique.
`403`	Pas d'abonnement actif. Les tampons sur ticket nécessitent un abonnement Summa actif.

Limites

Les tampons sur ticket nécessitent un abonnement Summa actif. Sur le forfait gratuit (jusqu'à 10 cartes actives), l'API fonctionne sans restriction. Au-delà de cette limite, un abonnement payant est requis — un abonnement expiré ou annulé bloque l'accès (HTTP 403).