{"id":289545,"date":"2026-08-17T08:59:27","date_gmt":"2026-08-17T06:59:27","guid":{"rendered":"https:\/\/www.blumen-schwarz.de\/aktuell\/?p=289545"},"modified":"2026-08-27T14:34:00","modified_gmt":"2026-08-27T12:34:00","slug":"cashgenic-bezahlautomat-unter-linux-mit-curl-ansprechen","status":"publish","type":"post","link":"https:\/\/www.blumen-schwarz.de\/aktuell\/cashgenic-bezahlautomat-unter-linux-mit-curl-ansprechen\/2026\/08\/","title":{"rendered":"Cashgenic Bezahlautomat unter Linux mit curl ansprechen"},"content":{"rendered":"

Wir haben lange nach einem Bezahlautomat (Bargeldeinzahlung an der Kasse mit Bargeldwechsler) gesucht. Da unsere Kassensystem unter Linux laufen und wir die Anbindung selbst machen wollten, war unsere erste Anfrage an einige Herstellter in Deutschland \/ Europa nach der Dokumentation, wie man den Bezahlautomaten ansprechen kann. Kurz: Wir haben nirgends eine brauchbare R\u00fcckmeldung erhalten. Das Ziel der deutschen Hersteller scheint immer zu sein, noch zus\u00e4tzlich das eigene Kassensystem zu verkaufen.<\/p>\n

Dann haben wir auf chinesischen B2B Plattformen das Suchen angefangen und nach kurzer Zeit hatten wir eine brauchbare API Beschreibung der Cashgenic Bezahlautomaten auf dem Tisch. Darauf hin haben wir das Ger\u00e4t (in China)<\/a> dort gekauft.<\/p>\n

curl ist manchmal etwas komplexer. Deswegen machen wir diese Seite als kurze Hilfe zum Einstieg (mehr holt man sich dann aus der Dokumentation).<\/p>\n

Hinweis: Nat\u00fcrlich gibt es curl auch f\u00fcr andere Betriebssysteme. Es gibt fast kein Betriebssystem wo curl nicht l\u00e4uft. Daher gilt diese Anleitung nicht nur f\u00fcr Linux.<\/strong><\/em><\/p>\n

erster Schritt<\/h3>\n

Bargeldautomaten auf API Zugriff umstellen. Damit werden die Bluetoothverbindungen abgeschaltet und der Automat muss \u00fcber Wlan oder Kabel verbunden sein. Laut Dokumentation sollte damit dann der Webeserver auf den Standard http und https Ports Informationen ausgeben - macht er bei uns nicht. Beide Ports sind zu. Das ist aber nicht wichtig. Bei der Aktivierung des API Zugriffes muss man einen Usernamen und ein Passwort vergeben.<\/p>\n

jetzt geht es los<\/h3>\n

Token erstellen.<\/h4>\n

Das Token ersetzt in den weiteren Schritten Username und Passwort. Soweit ich das auswendig wei\u00df, ist es einen Tag g\u00fcltig. Wichtig ist es, curl mit der Option --insecure zu starten. Damit akzeptiert er das selbstsignierte Webserverzertifikat.<\/p>\n

curl -X POST -H 'Content-Type: application\/x-www-form-urlencoded' --insecure \"https:\/\/IPADRESSE:44333\/token?grant_type=password&username=USER&password=PASSWORT\"<\/p>\n

Wir schreiben mit folgendem 3 Zeiler das Token auf die Festplatte des Kassensystemes:<\/p>\n

token=`curl -X POST -H 'Content-Type: application\/x-www-form-urlencoded' --insecure \"https:\/\/IPADRESSE\u200b:44333\/token?grant_type=password&username=USER&password=PASSWORT\" `
\ntoken=`echo $token|sed 's\/.*access_token\":\"\/\/'|sed 's\/\".*\/\/'`
\necho $token >.token.txt<\/p>\n

verschiedene Befehle<\/h4>\n

(alle setzten voraus, dass das Token in der Datei .token.txt im jeweiligen Verzeichnis liegt). Wichtig ist, dass die Betr\u00e4ge ohne Punkt und Komma immer mit 2 Nachkommastellen angegeben werden. Also 1\u20ac muss als 100 an den Bezahlautomaten gesendet werden (wie halt bei Kartenlesern auch).<\/p>\n

Starten eines Kassiervorganges<\/strong><\/p>\n

curl -X POST --insecure -H 'Content-Type: application\/json' -H \"Authorization: Bearer `cat .token.txt<\/code>`\" -d '{\"request\":\"PayAmount\",\"value\":BEZAHLBETRAG}' \"https:\/\/IPADRESSE:44333\/session\"<\/p>\n

Kassiervorgang beenden (wenn er sauber fertig und abgeschlossen ist)<\/strong><\/p>\n

curl -X POST --insecure -H 'Content-Type: application\/json' -H \"Authorization: Bearer `cat .token.txt<\/code>`\" -d '{\"request\":\"CloseSession\"}' https:\/\/IPADRESSE:44333\/session<\/p>\n

(das kann man auch zum Testen ob der Zahlvorgang schon abgeschlossen ist, verwenden)<\/p>\n

Ansonsten kann man auch (das ist etwas sauberer) mit der Session ID, die mit dem Start des Kassiervorganges zur\u00fcckgegeben wird, den Status abfragen:<\/p>\n

curl -X GET --insecure -H 'Content-Type: application\/json' -H \"Authorization: Bearer `cat .token.txt<\/code>`\" https:\/\/IPADRESSE:44333\/status?transaction=IDKASSIERVORGANG<\/p>\n

Kassiervorgang au\u00dferplanm\u00e4\u00dfig stoppen<\/strong><\/p>\n

curl -X POST --insecure -H 'Content-Type: application\/json' -H \"Authorization: Bearer `cat .token.txt<\/code>`\" -d '{\"request\":\"stopPayment\"}' https:\/\/IPADRESSE:44333\/session<\/p>\n

Danach muss man noch ein CloseSession machen<\/p>\n

Auszahlung aus der Kasse<\/strong><\/p>\n

curl -X POST --insecure -H 'Content-Type: application\/json' -H \"Authorization: Bearer `cat .token.txt`\"\" -d '{\"request\":\"RefundAmount\",\"value\":\"AUSZAHLUNGSBETRAG\"}' https:\/\/IPADRESSE:44333\/session<\/p>\n

Einstellung, wieviel Scheine zum Wechseln bereitgestellt werden sollen<\/strong><\/p>\n

Bei uns war, nach einem Ausbau des Scheinwechslers auf einmal kein Schein zum Wechseln mehr in der graphischen Oberfl\u00e4che sichtbar und ausw\u00e4hlbar. Sprich: Der Automat h\u00e4tte nur noch mit M\u00fcnzen gewechselt.<\/p>\n

Per Api konnte man die Menge und Scheine neu definieren (und die sind danach auch in der GUI wieder aufgetaucht)<\/p>\n

curl -X POST --insecure -H 'Content-Type: application\/json' -H \"Authorization: Bearer\u00a0 `cat .token.txt`\" -d '{\"denominations\":[{\"country\":\"EUR\",\"value\":500,\"enabled\":true,\"route\":\"Payout\",\"floatLevel\":5,\"maxStoredLevel\":0}]}' https:\/\/IPADRESSE:44333\/denomination<\/p>\n

 <\/p>\n

Zum System<\/h1>\n

Der Cashgenic Bargeldautomat l\u00e4uft unter Android auf einem Tinkerboard. Tinkerboard ist die Raspberry PI Alternative von Asus.\u00a0 Das Board kommt mit anschaltbaren ADB Zugriff. Damit ist es m\u00f6glich eine Shell auf dem Automaten zu starten und zus\u00e4tzliche Programme zu installieren.\u00a0 Das gibt viel Freiheit und macht Spa\u00df.<\/p>\n

Generell tut der Cashgenic einfach das was es machen soll: Geld kassieren und Wechseln.<\/p>\n

Es gibt aber ein paar Einschr\u00e4nkungen, die nicht optimal sind.<\/p>\n