Zahlungsdetails auf dem Kassenbon

Der empfohlene Weg, Trinkgeld, Karte und SumUp-Referenz auf dem gedruckten Kassenbon auszugeben, liegt in der App: PosBridge → Terminals → Zahlungsdetails auf dem Kassenbon. Dort setzt du die Häkchen, wählst eine Vorlage und prüfst die Live-Vorschau. Den erzeugten Liquid-img-Code fügst du einmal in Shopify ein. Liquid-Variablen (posbridge_*) sind optional — für Händler, die die POS-Belegvorlage selbst schreiben. Ca. einmalig

Terminals öffnen

Shopify Admin → PosBridge → Terminals. Abschnitt Zahlungsdetails auf dem Kassenbon.

Block auf dem Kassenbon anzeigen

Häkchen Block auf dem Kassenbon anzeigen setzen. Aus: Auf dem Bon steht nichts.

Felder und Vorlage

Unter Was soll gedruckt werden? die Zeilen wählen. Leere Zeilen werden weggelassen. Vorlage ist der Startpunkt — alles darunter bleibt änderbar.

Vorschau prüfen und speichern

Die Vorschau · 80 mm Bonpapier zeigt den Block so, wie er gedruckt wird. Speichern — danach erscheint Dein Code.

Code in Shopify einfügen

Nach dem Speichern erzeugt die App einen img-Block für den neuen Belegeditor. Denselben Code in die gedruckte Belegvorlage einfügen — unverändert. ca. 1 Minute

Shopify Admin → Point of Sale → Belege → Gedruckte Belege

Standort: „Standard (alle Standorte)“

Fußzeile → Block hinzufügen → Benutzerdefiniertes Liquid

Code unverändert einfügen und speichern

{% if order.id %}
  <img width="100%"
    src="https://<app-host>/receipt/sumup.svg?v=…&key=…&orderId={{ order.id }}&shop={{ shop.domain }}&country={{ location.country_code }}"
  />
{% endif %}

URL und Schlüssel setzt die App. Den fertigen Block unter Dein Code kopieren — nicht von Hand nachbauen. Änderungen an Häkchen, Vorlage oder Beschriftungen wirken nach dem Speichern ohne erneutes Einfügen.

Vorlagen und Felder

Die Vorlage ist der Startpunkt. Darstellung (Trennlinien, Überschrift, Schriftgröße, eigene Überschrift) bleibt darunter änderbar.

Vorlage	Darstellung
Klar	Ruhig und offiziell, wie der übrige Bon.
Klassisch	Kassenbon-Optik: feste Spalten, Punktlinien.
Minimal	Nur die Zeilen, Werte fett, ohne Rahmen.

Häkchen	Wirkung
Block auf dem Kassenbon anzeigen	Aus: Auf dem Bon steht nichts.
Trinkgeld	Zeile, wenn am Terminal ein Trinkgeld gewählt wurde.
Kartenart (z. B. GIROCARD)	Kartenschema, sofern SumUp es liefert.
Letzte 4 Ziffern der Karte	Maskiert, z. B. ****5000.
SumUp-Transaktionscode	SumUp-Referenz der Zahlung.
Interne Zahlungsreferenz	Interne POSBridge-Zahlungs-ID.

Leere Zeilen werden weggelassen. Beschriftungen leer lassen = automatisch übersetzt.

Ohne Internet bleibt der Bereich leer, der Rest druckt normal. Nicht auf Retouren- und Umtauschbelegen. Sichtbar nach ca. 1 Minute. POS-App ab Version 11.10.

Optional: Liquid-Variablen

Für Händler, die die POS-Belegvorlage selbst schreiben. Nach erfolgreicher Zahlung schreibt PosBridge Cart-Properties auf die Bestellung (order.note_attributes / order.attributes). Die Keys stammen aus der POS-Extension — keine weiteren Keys erfinden. Beispiel:

{% assign pb_tx = order.note_attributes | where: "name", "posbridge_sumup_tx" | first %}
{% if pb_tx %}{{ pb_tx.value }}{% endif %}

Variable	Inhalt	Beispiel
Nach erfolgreicher Zahlung
`posbridge_payment_id`	Interne POSBridge-Zahlungs-ID	pay_a1b2c3d4
`posbridge_sumup_tx`	SumUp-Transaktions-ID	T8F2…XA91
`posbridge_charged_cents`	Belasteter Betrag in Cent (ohne Trinkgeld)	1800
`posbridge_charged_mode`	FULL oder PARTIAL	FULL
Wenn SumUp Kartendaten liefert
`posbridge_card_type`	Kartenschema / Netzwerk	GIROCARD
`posbridge_card_last4`	Letzte 4 Ziffern	****5000
Nur wenn am Terminal ein Trinkgeld gewählt wurde
`posbridge_tip_amount`	Trinkgeld (formatiert)	2,00 €
`posbridge_tip_subtotal`	Warenkorb ohne Trinkgeld (formatiert)	18,00 €
`posbridge_tip_total`	Gesamt inkl. Trinkgeld (formatiert)	20,00 €

Währungsformat der formatierten Beträge: Einstellungen → POS Extension → Währungsformat auf dem Kassenbon.

posbridge_charged_cents ist eine Ganzzahl in Cent — nicht in Euro. 1800 = 18,00 €. Die formatierten Trinkgeld-Felder werden nur geschrieben, wenn am Terminal ein Trinkgeld gewählt wurde.

Steuerliche Fragen zum Trinkgeld mit dem Steuerberater klären — die Behandlung variiert je nach Land und Unternehmensform.

Hilfe

Erste Schritte

Terminals

Zahlungen

Transaktionen

Erstattungen

POS & Multi-Standort

Einstellungen

FAQ

Pläne & Abrechnung

Fehlersuche

Zahlungsdetails auf dem Kassenbon

Code in Shopify einfügen

Vorlagen und Felder

Optional: Liquid-Variablen

​Code in Shopify einfügen

​Vorlagen und Felder

​Optional: Liquid-Variablen

Code in Shopify einfügen

Vorlagen und Felder

Optional: Liquid-Variablen