> ## Documentation Index
> Fetch the complete documentation index at: https://help.getposbridge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zahlungsdetails auf dem Kassenbon

> Empfohlener Weg: PosBridge → Terminals. Häkchen, Vorlage und Live-Vorschau — den erzeugten Code einmal in Shopify einfügen.

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*

<Steps>
  <Step title="Terminals öffnen">
    Shopify Admin → **PosBridge → Terminals**. Abschnitt **Zahlungsdetails auf dem Kassenbon**.
  </Step>

  <Step title="Block auf dem Kassenbon anzeigen">
    Häkchen **Block auf dem Kassenbon anzeigen** setzen. Aus: Auf dem Bon steht nichts.
  </Step>

  <Step title="Felder und Vorlage">
    Unter **Was soll gedruckt werden?** die Zeilen wählen. Leere Zeilen werden weggelassen. **Vorlage** ist der Startpunkt — alles darunter bleibt änderbar.
  </Step>

  <Step title="Vorschau prüfen und speichern">
    Die **Vorschau · 80 mm Bonpapier** zeigt den Block so, wie er gedruckt wird. Speichern — danach erscheint **Dein Code**.
  </Step>
</Steps>

### 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*

<Steps>
  <Step title="Shopify Admin → Point of Sale → Belege → Gedruckte Belege" />

  <Step title="Standort: „Standard (alle Standorte)“" />

  <Step title="Fußzeile → Block hinzufügen → Benutzerdefiniertes Liquid" />

  <Step title="Code unverändert einfügen und speichern" />
</Steps>

```Liquid theme={null}
{% 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 %}
```

<Note>
  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.
</Note>

### 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.

<Warning>
  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.
</Warning>

### 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**.

<Warning>
  `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.
</Warning>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.