Schnittstellen & API für Verkaufsautomaten Alles verbunden.
Steuer das Terminal aus deiner eigenen Software, frag deine Automaten per KI, binde es direkt an deinen Automaten an oder lass deine Kasse darüber kassieren. SENVEND Payment Terminal und my.SENVEND passen sich in die Systeme ein, die du schon nutzt.
Integrationen
Vier Schnittstellen. Eine Plattform.
Ob eigene Software, KI-Assistent, Automat oder Kasse: Wähle den Weg, der zu deinem Betrieb oder Projekt passt. Ein Klick bringt dich direkt hin.
-
Für Entwickler
Eigene Software (gRPC-API)
Deine Software startet Zahlung, Altersprüfung und Warenausgabe direkt am Terminal. -
Für Betreiber
KI-Anbindung (MCP)
Frag deine KI nach Umsatz, Bestand und Störungen. Mit SENVEND Telemetrie inklusive. -
Für Hersteller & Technik
Automat (MDB)
Das Terminal spricht direkt mit deinem Automaten, auf Wunsch über unseren MDB-Adapter. Offen dokumentiert auf GitHub. -
Für Kassen & Projekte
Kasse (ZVT)
Deine eigene Kasse oder Bezahlstation kassiert über das SENVEND Payment Terminal.
Software-Anbindung · gRPC-API
Programmier dein Terminal.
Über die SENVEND API steuert deine eigene Software das Payment Terminal direkt im lokalen Netzwerk: Zahlung starten, Alter prüfen, Ware über MDB ausgeben. Die Verkäufe landen wie gewohnt in my.SENVEND.
Mitschnitt einer Zahlung mit Altersprüfung
- Software · Start · +0,00 s
{"start": {"amount": 100, "age_verification": {"min_age": 18}}}Kassiere 1,00 €, prüf vorher das Alter ab 18. - Terminal · Altersprüfung · +0,05 s
ageApiSuccess: VERIFICATION_STARTEDKunde wählt seinen Altersnachweis. - Terminal · Alter bestätigt · +6,40 s
{"ageSuccess": {}}Alter passt. - Terminal · Zahlung · +6,42 s
apiSuccess: PAYMENT_STARTEDKunde hält die Karte vor. - Terminal · Freigabe · +9,10 s
{"approved": {"amount": 100}}Bezahlt: 1,00 €. - Software · Ware ausgegeben · +11,30 s
{"goods_issued": {}}Ware ist raus. - Terminal · Bestätigung · +11,31 s
apiSuccess: GOODS_ISSUED_ACCEPTEDVerstanden. - Terminal · Abschluss · +11,35 s
{"success": {}}Vorgang abgeschlossen.
Vereinfacht: ohne Vorgangs-ID, Statusmeldungen gekürzt, die Zeiten sind Beispielwerte.
-
Bezahlen
Zahlung starten, Betrag bis zur Freigabe anpassen und Bargeld für die Auswertung mitmelden.
-
Altersprüfung
Allein oder vor der Zahlung. Dein Kunde wählt am Terminal aus allen eingerichteten Methoden.
-
Warenausgabe
Deine Software gibt Ware über den angeschlossenen MDB-Automaten aus, einzeln oder als Liste.
-
Bald
Cloud-API
Dieselben Abläufe über das Internet, ohne lokales Netzwerk. Die Definitionen liegen schon auf GitHub.
KI-Anbindung · MCP
Frag einfach deine Automaten.
Über MCP, den offenen Standard für KI-Anbindungen, verbindest du deine KI mit my.SENVEND, zum Beispiel Claude oder ChatGPT. Du meldest dich mit deinem my.SENVEND-Login an, einen Schlüssel brauchst du nicht.
- Nur lesen
- Nur deine Daten
- Claude & Co.
- Zugang inklusive
Beispielfragen
- „Welche Automaten sind gerade fast leer?“
- „Welche Produkte laufen am Bahnhof gut und am Campus gar nicht?“
Mehr Daten. Mehr Möglichkeiten.
Über die MCP-Anbindung kann deine KI auch Daten abfragen und kombinieren, die in der Oberfläche von my.SENVEND nicht direkt verfügbar sind. Deine Benutzerrechte gelten dabei weiterhin.
Hinweis
Für die KI selbst brauchst du ein eigenes Konto bei Claude, ChatGPT & Co., je nach Tarif kostenpflichtig.
Beispiele ansehen
Sechs Anwendungsfälle, jeweils mit einer möglichen Unterhaltung mit deiner KI:Automatenanbindung · MDB
Der Standard im Automaten.
Über MDB spricht dein Automat mit Bezahlgeräten wie Münzwechsler, Scheinleser und Kartenterminal. Wie das SENVEND Payment Terminal dabei arbeitet, dokumentieren wir offen auf GitHub – für Automatenhersteller und Integratoren.
Mitschnitt eines Verkaufs
- Automat · Vend Request · +0,00 s
13 00 00 64 00 01Fach 1 gewählt, 1,00 €. Zahlt der Kunde? - Terminal · ACK · +0,01 s
00Verstanden. - Terminal · Vend Approved · +2,41 s
05 00 64Bezahlt, gib die Ware aus. - Automat · ACK · +2,41 s
00Ok. - Automat · Vend Success · +4,02 s
13 02 00 01Ware ist raus. - Terminal · ACK · +4,02 s
00Verstanden. - Automat · Session Complete · +4,20 s
13 04Vorgang beendet. - Terminal · ACK · +4,20 s
00Alles klar.
Vereinfacht, ohne Abfragen (POLL) und Prüfsummen, die Zeiten sind Beispielwerte.
-
Kartenzahlung (Cashless)
Wie das Terminal am Automaten als bargeldloses Zahlungsgerät arbeitet.
-
Altersprüfung
Wie Altersprüfung und Automat über MDB zusammenspielen.
-
Altersprüfgerät
Die Anbindung als eigenes Altersprüfgerät am Bus (Age Verification Device).
MDB-Adapter · Hardware
Ein Adapter. Alles verbunden.
Der SENVEND MDB-Adapter verbindet Terminal, Automat und Bargeldgeräte. Er sorgt für eine zuverlässige Kommunikation und ermöglicht die Integration auch dort, wo sie bisher schwierig war.
- 1USB-Kabel vom Terminal zum Adapter
- 2Stromkabel vom Terminal zum Adapter
- 3Automat am rechten MDB-Port
- 4Bargeldgeräte am linken MDB-Port
- AUSB-C: Daten zum Terminal
- BStrom vom Terminal (2-polig)
- CRP2350: Raspberry-Pi-Mikrocontroller
- DMDB-Buchsen: Automat und Bargeldgeräte
Das Gerät selbst: MDB-Adapter in der Hardware-Übersicht
-
Stabile Verbindung
Kartenzahlung, Altersprüfung und Automat verstehen sich zuverlässiger, auch bei Automaten, die sonst Probleme machen.
-
Bargeld läuft weiter
Münzwechsler und Scheinleser werden am Adapter angeschlossen und funktionieren wie bisher.
-
Kein eigenes Netzteil
Strom kommt über die MDB-Buchse des Terminals, Daten über USB-C. Die Kabel liegen bei, dazu brauchst du nur ein USB-Kabel von A auf C.
Master-Telemetrie
In naher Zukunft wird mit dem Adapter auch eine Master-Telemetrie möglich.
Kassenanbindung · ZVT
Deine Kasse. Unser Terminal.
Du hast eine eigene Kasse oder Bezahlstation? Über ZVT, den Standard für Kartenterminals in Deutschland, kassiert sie mit dem SENVEND Payment Terminal. Dazwischen sitzt unser ZVT-Proxy.
Mitschnitt einer Kartenzahlung
- Kasse · Autorisierung · +0,00 s
06 01 07 04 00 00 00 00 01 00Kassiere bitte 1,00 €. - Terminal · ACK · +0,02 s
80 00 00Verstanden. - Terminal · Zwischenstatus · +1,84 s
04 FF 01 0AKunde hält die Karte vor. - Kasse · ACK · +1,85 s
80 00 00Ok. - Terminal · Statusinformation · +3,91 s
04 0F …Bezahlt. Hier die Belegdaten. - Kasse · ACK · +3,92 s
80 00 00Erhalten. - Terminal · Abschluss · +4,11 s
06 0F 00Fertig. - Kasse · ACK · +4,11 s
80 00 00Alles klar.
Vereinfacht: Der ZVT-Proxy dazwischen ist ausgeblendet, die Zeiten sind Beispielwerte.
-
ZVT-Proxy
Deine Kasse verbindet sich per TCP mit SENVEND (Port 20000), nicht direkt mit dem Terminal.
-
Was durchgeht
Zahlung, Rückbuchung, Diagnose und Abbruch leitet der Proxy weiter. Altersprüfung und Sprache beantwortet SENVEND selbst.
-
Gemeinsam einrichten
Die Terminal-ID vergibt SENVEND. Schreib uns an api@senvend.com, wir richten die Anbindung mit dir ein.
Häufige Fragen
Was du wissen willst.
Was kann die API?
Deine Software startet über das lokale Netzwerk Zahlungen, Altersprüfungen und die Warenausgabe über MDB, direkt am SENVEND Payment Terminal. Die Verkäufe erscheinen wie gewohnt in my.SENVEND. Eine Cloud-API für den Zugriff über das Internet folgt.
Was kostet die KI-Anbindung?
Nichts extra. Die KI-Anbindung (MCP) ist in SENVEND Telemetrie enthalten. Für die KI selbst brauchst du ein eigenes Konto bei Claude, ChatGPT & Co., je nach Tarif kostenpflichtig.
Brauche ich Programmierkenntnisse?
Für die KI-Anbindung nicht: Adresse eintragen, mit my.SENVEND anmelden, fertig. Die API richtet sich an Entwickler. Die Kassenanbindung über ZVT und die MDB-Anbindung richten Kassen- oder Automatentechniker ein, gemeinsam mit uns.
Kann die KI etwas an meinen Automaten ändern?
Nein. Die KI-Anbindung ist reiner Lesezugriff. Terminal neu starten, Ware ausgeben oder Guthaben buchen geht weiterhin nur direkt in my.SENVEND.
Welche KI-Assistenten werden unterstützt?
Grundsätzlich jeder MCP-fähige Assistent. Schritt-für-Schritt-Anleitungen für Claude und ChatGPT findest du im Hilfezentrum zur KI-Anbindung.
Was passiert mit meinen Daten?
Du siehst nur die Daten deines Unternehmens, mit denselben Rechten wie in my.SENVEND. Deine Fragen und die Antworten daraus verarbeitet der KI-Anbieter, den du verbindest, zum Beispiel Anthropic oder OpenAI. Dafür gelten dessen Datenschutzbestimmungen. Welche Fragen du stellst, entscheidest du selbst.
Brauche ich den MDB-Adapter?
Nicht immer. Bei vielen Automaten läuft das Terminal direkt über MDB. Bei manchen macht der Adapter die Verbindung stabiler, bei einigen überhaupt erst möglich. Ob du ihn brauchst, klärst du am besten mit deinem Fachhändler.
Was kosten die Kassen- und die MDB-Anbindung?
Das hängt von deinem Projekt ab. Schreib uns an api@senvend.com, dann machen wir dir ein Angebot.
Bereit zum Verbinden?
Du planst eine Integration?
Erzähl uns von deinem Projekt, wir finden mit dir den passenden Weg.
Noch Fragen? Wir sind für dich da.
+49 231 4499210 help@senvend.com +49 1579 2451201 Zum Kontaktformular