Terminal

Öffnen Sie den Link auf einem Telefon oder Tablet, tippen Sie den Betrag auf dem Ziffernblock ein und reichen Sie das Gerät der Kundin oder dem Kunden. Nach der Bestätigung springt die Seite von selbst zurück zum Ziffernblock — bereit für den nächsten Verkauf.

Terminal funktioniert ohne Vorbereitung. Kein Code, keine eingebetteten API-Schlüssel, keine Serverseite. Marke, Währung und aktive Netzwerke übernimmt es aus den Einstellungen des Projekts.

Wo Sie die Terminal-URL finden

Die Terminal-Seite des Dashboards liegt unter /terminal. Sie zeigt die URL des Projekts, mit dem Sie gerade arbeiten, fertig zum Kopieren.

Ob ein Projekt eine solche URL hat, entscheidet seine Integrationsmethode — die Antwort darauf, wie das Projekt an Paymos angebunden ist. Sie wird bei der Anlage des Projekts einmal gewählt und bleibt danach unverändert; nur die Antwort Terminal kassiert vor Ort. Einen Schalter, der ein Terminal nachträglich freigibt, gibt es nicht: Wer eines braucht, legt dafür ein eigenes Projekt an.

Die URL sieht so aus:

https://paymos.io/terminal?key=pk_live_xxx&pid=prj_yyy

Geben Sie den Link an Ihr Kassenpersonal weiter oder legen Sie ihn als Lesezeichen auf dem Gerät an der Theke ab.

Was in der URL steht

Parameter	Zweck
key	Der öffentliche Schlüssel des Projekts (Präfix pk_live_ oder pk_test_). Nicht geheim — wer ihn hat, kann jedoch Rechnungen für Ihr Projekt anlegen. Er stammt aus dem aktiven Payment-Schlüssel des Projekts.
pid	Die Projektkennung (Präfix prj_). Sie entscheidet, welche Token, Netzwerke und welches Branding geladen werden.

Die URL ist an kein Gerät gebunden — Sie können sie in jedem Browser öffnen. Jedes Öffnen ist eine eigenständige Sitzung.

Wie ein Verkauf abläuft

• 01Das Kassenpersonal öffnet die Terminal-URL im Browser (Telefon oder Tablet).
• 02Es wählt die Fiat-Währung (USD, EUR, RUB und 43 weitere) und tippt den Betrag auf dem Ziffernblock ein.
• 03Ein Tipp auf Bezahlen legt eine Rechnung an und öffnet die gewohnte Zahlungsseite.
• 04Die Kundschaft zahlt vom eigenen Gerät: QR-Code vom Terminal-Bildschirm scannen oder dem Link folgen.
• 05Sobald die Zahlung on-chain bestätigt ist, springt das Terminal von selbst zurück zum Ziffernblock.

Das Kassenpersonal fasst nie eine Wallet an. Die Kundschaft legt kein Paymos-Konto an. Die Wartezeit ist fast vollständig die Bestätigung on-chain — Sekunden auf einer Chain mit schneller Finalität, ein paar Minuten bei einer großen Zahlung auf einer langsameren.

Das Aussehen anpassen

Terminal übernimmt dieselben Markeneinstellungen wie die gewöhnliche Checkout-Seite. Ändern lassen sie sich in der Karte Branding auf der Seite des Checkout-Formulars:

Einstellung	Was sie verändert
Checkout-Stil	Die Grundvorlage der Zahlungsseite (Hintergrundmuster, Thema)
Akzent	Die Primärfarbe: Schaltflächen, Links, Hover, aktive Netzwerkanzeige
Hintergrund	Der Seitenhintergrund
Fläche	Die Fläche von Karten und Feldern
Text	Der Haupttext
Gedämpft	Nebentext (Hinweise, Bildunterschriften)
Eckenradius	Die Rundung von Schaltflächen und Karten, 0–32 px

Die Vorschau daneben zieht jede Änderung sofort nach. Das Terminal übernimmt sie beim nächsten Öffnen.

Logo

Das Projektlogo erscheint automatisch in der Kopfzeile des Terminals. Es wird als Datei hochgeladen, nicht als URL hinterlegt: Öffnen Sie unter Projekte das Projekt und laden Sie das Bild auf dessen Detailseite hoch. Zulässig sind PNG, JPEG und WebP, jede Datei bis 2 MB; SVG gehört nicht dazu.

Währungsliste

Das Terminal zeigt die Fiat-Währungen, die im Projekt unter dem Reiter Währungen aktiviert sind. Voreingestellt ist das Ladengeschäft-Set USD, EUR, RUB. Ergänzen oder entfernen Sie, was zu Ihrer Region passt.

Aktive Netzwerke und Token

Das Terminal zeigt der Kundschaft nur die Netzwerke und Token, die im Projekt unter Währungen aktiviert sind. Eine übliche Mischung im Einzelhandel:

• Tron (USDT) — Kundschaft aus der GUS und Asien
• Polygon (USDC/USDT) — niedrige Gebühr für die Kundschaft
• BSC (USDT) — Menschen, die in Binance zu Hause sind
• TON — ein Publikum, das in Telegram lebt

Lassen Sie Ethereum Mainnet aktiviert, wenn Sie mit großen Beträgen rechnen.

Sandbox oder Produktion

Das Präfix des Schlüssels in der Terminal-URL entscheidet über die Umgebung — pk_test_ für die Sandbox, pk_live_ für die Produktion. In der Sandbox trägt das Terminal über der Kopfzeile ein bernsteinfarbenes Band mit der Aufschrift Sandbox.

Zum Testen:

1. Erzeugen Sie einen pk_test_-Schlüssel unter Dashboard → Entwickler → API-Schlüssel.
2. Bauen Sie die Sandbox-Terminal-URL (gleiche Form, Testschlüssel).
3. Bezahlen Sie Rechnungen aus Testnet-Wallets.

Für den Livegang erzeugen Sie einen pk_live_-Schlüssel und aktualisieren die URL auf den Kassengeräten.

Terminal als Rückfall für das Low-Code SDK

Wenn Sie das Low-Code SDK ohne festen Betrag nutzen (amount weggelassen), übergeben Sie die Terminal-URL als Option pos_url — das Widget öffnet dann das Terminal statt des gewohnten Checkout-Formulars. Ein Widget deckt so zwei Abläufe ab:

• Fester Betrag — die Kundschaft zahlt den vorgegebenen Betrag über das gewohnte Formular.
• Freier Betrag — die Kundschaft gibt den Betrag auf dem Ziffernblock des Terminals ein.

Ein Skript, zwei Betriebsarten, kein zweiter Build. Ohne pos_url gibt es keinen Rückfall: Ein Klick ohne auflösbaren Betrag löst das Ereignis paymos:error aus, statt das Terminal zu öffnen.

Mehrere Kassen oder Geräte

Die URL ist gemeinsam nutzbar. Öffnen Sie sie auf so vielen Geräten, wie Sie brauchen — sie laufen alle parallel gegen dasselbe Projekt. Die Transaktionen landen in der gemeinsamen Historie des Projekts; das Dashboard zeigt alles.

Mehrere Standorte

Legen Sie ein Projekt je Standort an:

1. Dashboard → Projekte → Neues Projekt, als Integrationsmethode Terminal wählen.
2. Marke und aktive Netzwerke einrichten.
3. Die URL dieses Standorts unter /terminal kopieren.

Alle Projekte gehören zu einem Händlerkonto — die Auswertung läuft im gemeinsamen Dashboard zusammen.

Sicherheit

Der key in der URL ist der öffentliche Schlüssel. Er gibt keinen Zugriff auf Auszahlungen, Projekteinstellungen oder irgendeinen geschützten Vorgang. Er erlaubt es aber, Rechnungen anzulegen — für Ihr Projekt.

In der Praxis:

• Die Terminal-URL darf gefahrlos als Lesezeichen auf einem öffentlich zugänglichen Kassengerät liegen.
• Gelangt die URL nach außen, kann eine fremde Person Rechnungen anlegen (aber sie nicht in Ihrem Namen bezahlen und keine Mittel abziehen).
• Bei einem Verdacht erzeugen Sie unter Dashboard → Entwickler → API-Schlüssel einen neuen pk_live_-Schlüssel und aktualisieren die URL. Den alten Schlüssel widerrufen Sie.

Fehlersuche

Das Terminal öffnet sich nicht

Prüfen Sie:

1. Die URL enthält beide Parameter — key und pid.
2. pid gehört zu einem Projekt mit der Integrationsmethode Terminal.
3. Der Schlüssel ist unter Entwickler → API-Schlüssel nicht widerrufen.

Die Seite meldet „Zahlung nicht verfügbar“

Eine Meldung, mehrere Ursachen: ein falscher oder widerrufener key, ein falscher pid, oder ein Projekt mit einer anderen Integrationsmethode. Am häufigsten stimmt key oder pid nicht — kopieren Sie die URL erneut unter /terminal. Steht dort gar keine URL zum Kopieren, liegt es an der Integrationsmethode: Das Projekt hinter pid läuft über REST API, Telegram-Bot, CMS-Plugin oder Low-Code, und ein Terminal lässt sich dort nicht nachrüsten. Für den Verkauf vor Ort legen Sie ein Projekt mit der Integrationsmethode Terminal an und verteilen dessen URL.

Nach dem Tippen auf „Bezahlen“ erscheint kein QR-Code

Prüfen Sie, ob im Projekt unter Währungen mindestens ein Token aktiviert ist.

Die Zahlung wird nicht bestätigt

Wie tief bestätigt wird, hängt vom Netzwerk und vom Betrag ab — kleine Beträge sind schnell durch, große warten länger auf Finalität. Chains mit schneller nativer Finalität (BSC, Polygon, Solana, Avalanche, Plasma) sind in Sekunden fertig; auf Tron, Ethereum und den L2s kann ein großer Betrag ein paar Minuten dauern. Hat die Kundschaft vor mehreren Minuten gezahlt und die Seite bewegt sich nicht, öffnen Sie die Transaktion im Explorer des Netzwerks und prüfen Sie, ob sie angekommen ist.

Nach einer Themenänderung sieht das Terminal kaputt aus

Im offenen Tab liegt noch das alte Thema im Cache. Schließen Sie den Tab und öffnen Sie die URL erneut.