Kartenzahlung mit Softpay¶

Mit Softpay wird das Android-Gerät, auf dem DiKAS läuft, zum kontaktlosen Kartenterminal: Der Gast hält Karte, Handy oder Smartwatch an das Gerät. Es sind kein separates Terminal, kein Kabel und keine Kopplung nötig. Die Zahlung läuft in der Softpay-App auf demselben Gerät. DiKAS übergibt ihr den Betrag (App-Wechsel), die Softpay-App liest die Karte und kehrt mit dem Ergebnis zu DiKAS zurück. Diese Seite zeigt, welche Voraussetzungen gelten, wie Sie Softpay Schritt für Schritt einrichten und was bei Störungen zu tun ist.

In der Terminal-Liste heißt dieser Typ Softpay.

Für wen eignet sich Softpay?¶

Softpay passt für Betriebe, die mit Handy oder Tablet kontaktlos kassieren möchten und dafür ein Händlerkonto bei Softpay haben. Mehrere Geräte am selben DiKAS-Server können unabhängig voneinander kassieren: Jedes Gerät liest die Karte selbst. Andere Kartenlösungen (ZVT-Terminal, SoftPOS, Stripe, SumUp) lassen sich daneben einrichten. Die Übersicht steht unter Zahlungen und Hardware → EC-/Kartenterminals.

Unterstützte Geräte und Betriebsarten¶

Gerät bzw. Betriebsart	Softpay	Hinweis
Android-Gerät mit NFC, DiKAS-App als Voll-Kasse (mit eigener Lizenz)	✅ Unterstützt	Das Gerät liest die Karte selbst.
Android-Gerät als Client an einem DiKAS-Server	✅ Unterstützt	Auch hier liest das Gerät in der Hand die Karte, nicht der Server. Beleg und Buchung laufen weiter über den Server.
Cloud-Kasse im Browser mit einem gekoppelten Android-Gerät (Geräte-Agent)	✅ Unterstützt	Ohne gekoppeltes Gerät meldet DiKAS, was fehlt. Hintergrund: Hardware im Cloud-Betrieb.
iPhone / iPad	❌ Nicht möglich	Softpay über DiKAS gibt es nur für Android.
Windows-PC, Linux-Server, DiKAS-Box	❌ Nicht möglich	Diese Geräte haben kein NFC. DiKAS meldet „Softpay auf diesem Host nicht verfügbar."

Die DiKAS-App wird für 64-Bit-ARM-Geräte (arm64) ausgeliefert, das sind praktisch alle heutigen Tablets und Handhelds.

Euro und Länder

Softpay-Zahlungen laufen in Euro. Ein Betrag in einer anderen Währung wird nicht gebucht, sondern als Klärfall gemeldet. In welchen Ländern ein Softpay-Händlerkonto möglich ist, klärt der Vertrag mit Softpay, nicht DiKAS.

Voraussetzungen¶

Voraussetzung	Wofür
Händlerkonto bei Softpay mit Zugangsdaten und mindestens einem Store	Die Anmeldung erfolgt einmalig in der Softpay-App. Konto und Stores vergibt Softpay, nicht DiKAS.
Softpay-App auf demselben Gerät	Sie liest die Karte. Für echte Zahlungen die Produktionsvariante, zum Ausprobieren die Sandbox-Variante.
Zugangsdaten von DiKAS für Softpay	DiKAS meldet sich gegenüber Softpay mit einer eigenen Kennung für die gewählte Umgebung (Sandbox oder Produktion) an. Sie müssen sie nirgends eingeben. Fehlen sie für die gewählte Umgebung, meldet DiKAS „Softpay ist nicht eingerichtet: …". Wenden Sie sich dann an den DiKAS-Support.
NFC eingeschaltet	Kontaktloses Lesen.
Freigaben für die Softpay-App	Softpay verlangt auf dem Gerät mehrere Android-Freigaben: Bedienungshilfen-Dienst, Mitteilungen, Kamera und Standort. Fehlt eine, nennt DiKAS sie bei der Bereitschaftsprüfung.
Internetverbindung	Die Zahlung wird online autorisiert.
Aktuelle DiKAS-App	Download und Betriebsart-Wahl: DiKAS auf Android.
Ein Benutzer mit Zugriff auf Admin → Einstellungen	Zum Einrichten des Terminals.

Einrichten in 9 Schritten¶

Am Gerät einrichten

Führen Sie die Einrichtung direkt auf dem Android-Gerät aus, das mit Softpay kassieren soll. Nur dort ist die Softpay-App installiert und angemeldet.

Softpay-App installieren — so, wie es Softpay für Ihr Händlerkonto vorsieht.
In der Softpay-App anmelden: Softpay öffnen, mit den Händler-Zugangsdaten anmelden und die verlangten Freigaben erteilen. DiKAS speichert diese Zugangsdaten nicht und meldet sich auch nirgends für Sie an.
NFC einschalten (Android-Einstellungen).
DiKAS-App öffnen und anmelden, dann Admin → Einstellungen → Hardware → Zahlungsoptionen öffnen.
Auf Terminal hinzufügen tippen, einen Namen vergeben (z. B. „Handy Service") und bei Typ den Eintrag Softpay wählen. DiKAS stellt Umgebung zunächst bewusst auf Sandbox (Test), damit ein neues Terminal nie versehentlich echtes Geld bewegt, und schaltet den Eigendruck des Terminals aus.
Umgebung auf Produktion stellen (für echte Zahlungen).
Im Abschnitt Softpay (er erscheint, sobald ein Softpay-Terminal in der Liste steht) den Händler-Namen eintragen — den Namen, unter dem Softpay Ihr Unternehmen führt, kein Filialname. Danach Speichern.
Beim Terminal auf Store wählen tippen und Ihren Store aus der Liste wählen (Name, Ort und Nummer werden angezeigt). Softpay richtet daraus das virtuelle Terminal für dieses Gerät ein, das kann einen Moment dauern. DiKAS bestätigt mit „Store konfiguriert. Das Terminal ist jetzt einsatzbereit."
Auf Bereitschaft prüfen tippen. Bei Erfolg meldet DiKAS „Bereit. Terminal …, Softpay …." Sonst nennt die Meldung, was fehlt (siehe Fehler und Abhilfe).

Ohne Store keine Zahlung

Solange beim Terminal kein Store gewählt ist (Anzeige Kein Store), kann das Gerät mit Softpay nicht kassieren. Speichern Sie vor Schritt 8 unbedingt, denn die Store-Wahl funktioniert nur für ein bereits gespeichertes Softpay-Terminal.

Gerät wechseln

Terminal freigeben löst die Zuordnung des Geräts (nach einer Rückfrage). Das Gerät kann danach erst nach einer neuen Store-Wahl wieder kassieren. Die Anmeldung in der Softpay-App bleibt bestehen.

Standard-Terminal und mehrere Geräte

Unter Standard-Terminal legen Sie das Terminal fest, das DiKAS für Kartenzahlungen verwendet, wenn keine andere Zuordnung gilt. Jedes Gerät mit Softpay braucht einen eigenen Terminal-Eintrag und eine eigene Store-Wahl. Das Zahlungsfenster nennt das Terminal beim Kassieren mit Namen, so fällt es auf, wenn am falschen Gerät kassiert wird.

So kassieren Sie¶

Den Verkauf aufnehmen und Zahlen wählen.
EC-Karte oder Kreditkarte wählen.
DiKAS zeigt das Fenster EC-Kartenzahlung mit Betrag und Terminalname und wechselt in die Softpay-App mit dem Betrag.
Der Gast hält Karte, Handy oder Smartwatch an das Gerät und gibt bei Bedarf die PIN ein.
Die Softpay-App kehrt automatisch zu DiKAS zurück. DiKAS zeigt Zahlung erfolgreich mit Kartenmarke und maskierter Kartennummer, danach wird der Bon erstellt.

Abbrechen¶

Abbrechen im DiKAS-Fenster schließt nur dieses Fenster. Die Kasse kann einen laufenden Vorgang in der Softpay-App nicht beenden — dafür ist die Softpay-App maßgeblich. Beenden Sie ihn am Gerät. Der Vorgang kann bis zu drei Minuten weiterlaufen. Geht die Zahlung in dieser Zeit doch noch durch, weist DiKAS mit „Kartenzahlung nachträglich eingetroffen" darauf hin: Die Kartenzahlung am Terminal … ist doch durchgelaufen — bitte prüfen und den Beleg nacherfassen. Die Karte ist dann belastet, ohne dass ein Bon besteht.

Wenn der Ausgang unklar bleibt¶

Bleibt der Vorgang offen oder kommt nach drei Minuten keine Antwort, zeigt DiKAS Zahlung unbestätigt. Meldet Softpay den Vorgang als „noch in Bearbeitung", fragt DiKAS vorher rund zehn Sekunden selbst nach, denn meist ist die Zahlung dann nur Sekunden später verbucht.

Nicht erneut kassieren

Die Karte kann belastet worden sein. Tippen Sie im Fenster auf Status prüfen: DiKAS fragt bei Softpay nach, was aus der Zahlung geworden ist, ohne erneut zu belasten. Erst wenn sie als abgelehnt oder abgebrochen bestätigt ist, ist ein neuer Versuch sicher. Prüfen Sie im Zweifel zuerst in der Softpay-App, ob die Zahlung dort erscheint.

Noch offen: „Zahlung unbestätigt — wird geprüft. Bitte NICHT erneut versuchen, sondern kurz warten." Später nochmals Status prüfen.
Durchgegangen, Betrag passt: Die Zahlung wird dem Verkauf zugeordnet.
Durchgegangen, Betrag passt nicht: „Unbestätigte frühere Zahlung über … gefunden — bitte klären (Storno/Abgleich), bevor der Vorgang wiederholt wird."

Dieser automatische Abgleich gilt nur, solange die DiKAS-App nicht neu gestartet wurde. Danach prüfen Sie den Vorgang bitte in der Softpay-App und beim Gast.

Trinkgeld und abweichender Betrag¶

DiKAS verlangt von Softpay kein Trinkgeld, keinen Zuschlag und keine Währungsumrechnung. Belastet das Terminal trotzdem einen anderen Betrag, wird der Vorgang nicht gebucht. DiKAS meldet: „Das Terminal hat einen anderen Betrag belastet (… statt …). Der Vorgang wurde NICHT gebucht — bitte am Terminal stornieren und erneut kassieren (Referenz: …)." Die Karte ist in diesem Fall belastet. Notieren Sie die Referenz und stornieren Sie die Zahlung (siehe unten).

Beleg, Storno und Gutschrift¶

Kartenbeleg¶

Das Gerät hat keinen eigenen Drucker. Mit der Voreinstellung (Terminal druckt Beleg selbst aus) druckt DiKAS den Kundenbeleg der Karte auf den Kassenbon, über den eingerichteten Bondrucker (siehe Artikel & Drucker). Softpay meldet außerdem die Kartenmarke (z. B. girocard, Visa, Mastercard). Auf Wunsch weist DiKAS sie als eigene Zahlungsart aus (Option Kartentyp als Zahlungsart übernehmen, siehe Zahlungen).

Tagesabschluss¶

Softpay kennt keinen Kassenschnitt: Die Abrechnung schließt der Acquirer nach seinem Zeitplan. Deshalb fehlt der Knopf Kassenschnitt bei Softpay-Terminals. Abgleichen können Sie die Kartenumsätze über die Berichte und den Tagesabschluss.

Storno¶

Einen Beleg mit Softpay-Zahlung stornieren Sie wie jeden Beleg (siehe Zahlungen → Storno einer Kartenzahlung). DiKAS storniert die Karte zuerst bei Softpay, ohne dass der Gast die Karte erneut anhalten muss, und erstellt danach den Storno-Beleg.

Ist die Abrechnung bereits abgeschlossen, meldet DiKAS: „Storno nicht mehr möglich — der Abrechnungslauf ist bereits abgeschlossen. Bitte stattdessen eine Karten-Gutschrift durchführen (Karte des Gastes wird benötigt)."
Fehlt zur Zahlung die Softpay-Referenz, meldet DiKAS: „Storno nicht möglich: Zu dieser Zahlung ist keine Softpay-Referenz hinterlegt."

Nur am ursprünglichen Gerät

Ein Kartenstorno ist nur an der Kasse mit dem Terminal möglich, über das bezahlt wurde. An einer anderen Kasse zeigt DiKAS: „Diese Kartenzahlung lief über Terminal … Stornieren ist nur an der Kasse mit diesem Terminal möglich."

Karten-Gutschrift¶

Eine Gutschrift ist eine eigenständige Erstattung auf die Karte, etwa wenn ein Storno nicht mehr möglich ist. Sie starten sie an der Kasse über Menü → EC-Gutschrift oder in den Zahlungsoptionen über Karten-Gutschrift am Terminal. Betrag eingeben, Gutschrift durchführen, der Gast hält die Karte an das Gerät. Bei Softpay ist das eine frei wählbare Erstattung mit Kartenkontakt. Auch hier schützt DiKAS vor Doppelerstattung: Bleibt der Ausgang unklar, wird nicht blind ein zweites Mal erstattet.

Grenzen¶

Thema	Verhalten
Währung	Nur Euro.
Gleichzeitige Zahlungen	Pro Gerät eine Zahlung zugleich. Ein zweiter Start meldet „Es läuft bereits eine Kartenzahlung auf diesem Gerät."
Wartezeit	Bis zu drei Minuten auf das Ergebnis, danach „unbestätigt".
Offline	Nicht möglich, die Zahlung braucht Internet. Barzahlung geht weiterhin ohne Internet.
Trinkgeld am Gerät	Wird nicht angefordert.
Kassenschnitt	Entfällt, die Abrechnung schließt der Acquirer.
Abbruch von der Kasse	Nicht möglich. Der Vorgang wird in der Softpay-App beendet.
Mehrere Geräte	Jedes Gerät hat eigenen Terminal-Eintrag und eigene Store-Wahl, alle kassieren unabhängig.
iOS	Nicht möglich.

Fehler und Abhilfe¶

Was Sie sehen	Ursache und Abhilfe
„Softpay ist nicht eingerichtet: Es sind keine Produktions-Zugangsdaten hinterlegt." (bzw. „… Sandbox-Zugangsdaten …")	Für die gewählte Umgebung liegt auf dem Gerät keine DiKAS-Kennung für Softpay. Wenden Sie sich an den DiKAS-Support. Zum Ausprobieren kann Sandbox (Test) gewählt werden.
„Softpay ist nicht eingerichtet: Es fehlt der Händler-Name in den Einstellungen."	Im Abschnitt Softpay den Händler-Namen eintragen und Speichern.
„Softpay ist noch nicht konfiguriert: Bitte in den Terminal-Einstellungen einen Store wählen."	Store wählen (Schritt 8).
„Softpay hat keine Stores geliefert. Mögliche Gründe: in der Softpay-App ist noch kein Händler angemeldet, dem Konto sind keine Stores zugeordnet, oder die hinterlegte Integrator-Kennung passt nicht zur gewählten Umgebung (Sandbox/Produktion)."	In der Softpay-App anmelden. Beim Softpay-Konto prüfen, ob Stores zugeordnet sind. Umgebung passend zur installierten Softpay-App wählen (Produktion bzw. Sandbox).
„Terminal '…' ist noch nicht gespeichert. Bitte die Terminal-Liste zuerst speichern …"	Speichern, dann Store-Wahl erneut starten. Dasselbe gilt, wenn der Typ nicht als Softpay gespeichert ist.
„Softpay kennt den gewählten Store (…) nicht mehr. Bitte die Store-Liste erneut öffnen und neu wählen."	Store-Liste erneut öffnen und den Store neu wählen.
„Die Softpay-App ist auf diesem Gerät nicht installiert."	Softpay-App installieren (passend zur gewählten Umgebung).
„NFC ist ausgeschaltet — bitte in den Android-Einstellungen aktivieren."	NFC einschalten.
„Der Softpay-App fehlen noch Freigaben auf diesem Gerät: …"	Die genannten Freigaben erteilen: Bedienungshilfen-Dienst für Softpay einschalten (Android-Einstellungen → Bedienungshilfen), Mitteilungen, Kamera oder Standort für die Softpay-App erlauben. Danach Bereitschaft prüfen.
„Es ist noch kein Store konfiguriert — bitte in den Terminal-Einstellungen einen Store wählen."	Wie oben: Store wählen.
„Das Softpay-Terminal ist nicht bereit."	In der Softpay-App anmelden bzw. dort den Zustand prüfen, danach Bereitschaft prüfen.
„Softpay ist auf diesem Gerät nicht verfügbar."	Die Kasse läuft in einer Umgebung ohne Softpay-Anbindung (z. B. Browser auf einem PC). Am Android-Gerät mit der DiKAS-App kassieren.
„Softpay auf diesem Host nicht verfügbar."	Die Zahlung wird auf einem Rechner ohne NFC ausgeführt (Server, PC, Box). Am Android-Gerät kassieren oder ein Android-Gerät mit der Cloud-Kasse koppeln.
„Es läuft bereits eine Kartenzahlung auf diesem Gerät."	Eine frühere Zahlung ist noch offen. In der Softpay-App beenden, bis zu drei Minuten warten, dann erneut.
„Zahlung abgebrochen."	In der Softpay-App wurde abgebrochen. Nichts belastet, erneut starten.
Zahlung abgelehnt (Fehlertext von Softpay, „Kartenzahlung fehlgeschlagen.")	Die Karte wurde abgelehnt. Andere Karte oder Barzahlung anbieten. Der Fehlertext beginnt mit einer Nummer, die der Support zur Fehlersuche braucht.
Zahlung unbestätigt, „Softpay hat den Vorgang noch nicht abgeschlossen — der Ausgang ist unbestätigt und wird geprüft. Bitte NICHT erneut kassieren."	Ausgang unbekannt. Nicht erneut kassieren: Status prüfen, siehe Wenn der Ausgang unklar bleibt.
„Das Terminal hat einen anderen Betrag belastet …"	Karte ist belastet, Vorgang nicht gebucht. Zahlung mit der angegebenen Referenz stornieren, danach neu kassieren.
„Kartenzahlung nachträglich eingetroffen"	Eine abgebrochene Zahlung ist doch durchgegangen. Prüfen und den Beleg nacherfassen (oder stornieren).
„Kartenzahlung ohne Zuordnung"	Ein Ergebnis traf ein, das zu keiner Zahlung dieses Geräts gehört. In der Softpay-App prüfen, ob eine Karte belastet wurde, bevor erneut kassiert wird.
„Storno nicht mehr möglich — der Abrechnungslauf ist bereits abgeschlossen. …"	Stattdessen Karten-Gutschrift durchführen.
„Ein laufender Softpay-Vorgang kann von der Kasse nicht abgebrochen werden — die Softpay-App ist die maßgebliche Stelle. Bitte den Vorgang am Gerät beenden."	Vorgang in der Softpay-App am Gerät beenden.

Nächster Schritt¶

→ Zahlungen — Kartenzahlung im Alltag, Storno und Gutschrift → Einstellungen → Terminals — alle Terminal-Typen im Überblick