API-Referenz

Die Summa-API ermöglicht die direkte Integration mit deinem Kassensystem. Nach jedem Verkauf erstellt ein API-Aufruf einen Bon-Stempel – eine einmalige URL, die als QR-Code auf den Bon gedruckt wird.

Authentifizierung

Jeder API-Aufruf braucht einen API-Schlüssel. Der Schlüssel wird als Bearer-Token im Authorization-Header mitgeschickt.

Erstelle einen API-Schlüssel unter Einstellungen → API-Schlüssel in deinem Shop. Settings → API Keys
Kopiere den Schlüssel sofort – er wird nur einmal angezeigt.
Sende den Schlüssel als Header: Authorization: Bearer DEIN_SCHLÜSSEL

Bon-Stempel erstellen

POST /api/receipt-stamp

Erstellt einen einmaligen Bon-Stempel. Die zurückgegebene URL wird als QR-Code auf den Bon gedruckt. Jeder Code gilt nur einmal und verfällt nach 48 Stunden.

Request body

Der Request-Body ist optional. Wenn dein Shop nur ein Programm hat, wird es automatisch gewählt. Bei mehreren Programmen kannst du mit programId angeben welches Programm den Stempel bekommen soll.

Response body

url: Vollständige URL für den QR-Code – der Kunde scannt diesen mit dem Handy.
code: Der Stempel-Code (Teil der URL). Kann für Logging oder Debugging verwendet werden.
expiresAt: Ablaufzeitpunkt im ISO-8601-Format. Nach Ablauf kann der Code nicht mehr eingelöst werden.

Beispiel

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

Fehlercodes

Status Code	Meaning
`401`	API-Schlüssel fehlt oder ist ungültig. Prüfe den Authorization-Header.
`400`	Ungültiges Programm. Die programId existiert nicht oder gehört nicht zu deinem Shop.
`403`	Kein aktives Abo. Bon-Stempel erfordern ein aktives Summa-Abonnement.

Limits

Bon-Stempel erfordern ein aktives Summa-Abonnement. Im Gratis-Plan (bis 10 aktive Karten) funktioniert die API ohne Einschränkung. Darüber hinaus ist ein kostenpflichtiges Abo nötig — bei abgelaufenem oder gekündigtem Abo wird der Zugang gesperrt (HTTP 403).