hobex Payment Terminal
by Wolfgang Pichler (Callino) https://github.com/Callino/hobex , Gerhard Baumgartner (Callino) https://github.com/Callino/hobex| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Point of Sale (point_of_sale)
• Discuss (mail) • Inventory (stock) • Invoicing (account) |
| Lines of code | 1086 |
| Technical Name |
pos_hobex |
| License | AGPL-3 |
| Website | https://github.com/Callino/hobex |
| Versions | 16.0 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Point of Sale (point_of_sale)
• Discuss (mail) • Inventory (stock) • Invoicing (account) |
| Lines of code | 1086 |
| Technical Name |
pos_hobex |
| License | AGPL-3 |
| Website | https://github.com/Callino/hobex |
| Versions | 16.0 17.0 18.0 19.0 |
hobex Payment Terminal
Akzeptiere Karten- und kontaktlose Zahlungen direkt an der Odoo-Kasse — voll integriert mit dem hobex REST-API.
Was dieses Modul macht
Dieses Modul integriert hobex Zahlungsterminals direkt in den Odoo Point of Sale. Der Kassier startet die Zahlung mit einem Klick, der Betrag wird über das offizielle hobex REST-API an das Terminal gesendet, und das Ergebnis — inkl. Autorisierungscode, Karten-Brand, maskierter PAN und optionalem Unterschriftsbeleg — fließt automatisch in den zugehörigen pos.payment-Datensatz zurück. Keine manuellen Schritte, keine doppelten Buchungen.
Unterstützt werden alle hobex Terminals, die das REST-API anbieten — mit getrennten Endpunkten für Produktiv- und Test-Sandbox.
Funktionen im Überblick
hobex erscheint als Karte in der Provider-Übersicht neben
Adyen, Stripe und SIX. Ein Klick auf Aktivieren /
Setup setzt automatisch Integration = Terminal
und Zahlungsterminal = Hobex.
Synchroner Aufruf mit Status-Polling: läuft die Verbindung in den Timeout, kann der Kassier zur Bestellung zurückkehren und den Status nachholen. Keine Doppelbelastungen.
Reversal direkt aus Odoo. Ein Storno setzt sowohl die
POS-Zahlung als auch den verknüpften hobex-Transaktionsdatensatz
auf refunded — der Audit-Trail bleibt konsistent.
Bei Belegen mit CVM = Unterschrift wird der Händlerbeleg automatisch von hobex abgerufen und — falls ein IoT-Drucker angebunden ist — direkt gedruckt.
hobex_user, hobex_pass und
hobex_auth_token sind auf
base.group_erp_manager beschränkt.
Kassen-Benutzer können sie weder über RPC, Export noch
das Formular auslesen.
Timeout, Verbindungsfehler, ungültige Credentials und unerwartete HTTP-Antworten produzieren jeweils eine eigene, beschreibende Meldung — statt eines generischen „Credentials prüfen“.
Ein eingebauter Cron-Job aktualisiert den hobex-Token einmal täglich, sodass Sessions nicht mitten in der Schicht unbemerkt ablaufen.
Alle UI-Texte und Dialoge sind übersetzt
(i18n/de.po). Belegausdruck auf Deutsch.
Einrichtung in 4 Schritten
|
1
|
Modul installierenÜber Apps → pos_hobex oder direkt aus der Provider-Übersicht auf der Zahlungsmethode (Klick auf die Hobex-Karte). |
|
2
|
Zahlungsmethode anlegenPoint of Sale → Konfiguration → Zahlungsmethoden → Neu. Bank-Journal wählen, Integration = Terminal, Zahlungsterminal = Hobex. |
|
3
|
Credentials eintragenTerminalID, hobex Benutzer und Passwort aus dem hobex Dashboard übernehmen, dazu Testmodus oder Echtbetrieb wählen. |
|
4
|
Verbindung testenAuf Check Connection klicken — bei Erfolg erscheint der Sample Transaction-Button, mit dem eine 0,01 €-Probebuchung gegen das Terminal gefahren werden kann. |
Endpunkte
Test-Sandbox
hobexplus.brunn.hobex.atProduktiv
online.hobex.atAuthor
Wolfgang Pichler & Gerhard Baumgartner
Callino Software Entwicklung
Sponsor
Im Auftrag der hobex AG entwickelt.
Quellcode
github.com/Callino/hobex
Lizenz: AGPL-3.0
Please log in to comment on this module