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

# Die POSBridge Kachel & Modal erklärt

> Was du in der POS Extension siehst und wie du damit Zahlungen abwickelst.

<Note>
  POSBridge sendet den Betrag ans SumUp Terminal und zeigt den Zahlungsstatus an. Die Kartenzahlung selbst wird ausschließlich von **SumUp** durchgeführt und verarbeitet — POSBridge greift dabei nicht ein.
</Note>

### Die Smart Grid Kachel

Die **POSBridge SumUp Payment** Kachel erscheint im Shopify POS Smart Grid. Sie zeigt auf einen Blick:

* Den aktuellen **Warenkorbbetrag** (wird automatisch aus dem aktiven Shopify POS Warenkorb übernommen)
* Den **Terminal-Status** — ob dein gepaartes Terminal bereit ist

Tippe auf die Kachel um das Zahlungs-Modal zu öffnen.

### Das Zahlungs-Modal

Das Modal öffnet sich nach dem Tippen auf die Kachel. Es zeigt:

| Element | Beschreibung |
| - | - |
| **Vollbetrag / Teilbetrag** | Umschalter. **Vollbetrag** = Warenkorb. **Teilbetrag** = eigenen Betrag eingeben. |
| **Terminal-Auswahl** | Falls mehrere Terminals: Auswahl. Das zuletzt genutzte ist vorausgewählt. |
| **Zahlung senden** | Sendet den Betrag ans Solo (nicht „Zahlung starten“). |
| **Trinkgeld** | Kein Modal-Tab. Der Kunde wählt das Trinkgeld **am Terminal**, nachdem die Zahlung gesendet wurde. |
| **Countdown (Quick Mode)** | Wenn aktiv: sendet automatisch. Tippe auf den Countdown zum Abbrechen. |
| **Abbrechen** | Bricht die laufende Zahlung ab (solange das Terminal die Karte noch nicht belastet hat). |

### Zahlungsstatus-Anzeige

Nachdem der Kunde die Karte getippt oder gesteckt hat, zeigt das Modal den aktuellen Status:

| Status | Was es bedeutet |
| - | - |
| 🟡 **Ausstehend** | Terminal verarbeitet die Zahlung — bitte warten. |
| ✅ **Bezahlt** | Zahlung am Solo erfolgreich. Jetzt zurück in Shopify POS → Checkout mit der **benutzerdefinierten Zahlungsart** (z. B. SumUp) abschließen. |
| ❌ **Fehlgeschlagen** | Karte abgelehnt oder Fehler. Erneut versuchen oder andere Zahlungsmethode. |
| ⏱ **Abgelaufen** | Timeout — Terminal hat nicht rechtzeitig geantwortet. Erneut versuchen. |

### Erstattungen

Erstattungen laufen nicht über das Modal: Starte einfach die **Retoure** wie gewohnt in Shopify POS (oder erstatte im Shopify Admin). POSBridge erkennt die Erstattung automatisch und bucht den Betrag auf die SumUp-Karte des Kunden zurück.

Den Live-Status siehst du direkt auf der Bestelldetail-Seite im POS (POSBridge-Block). Details: siehe Kategorie **Erstattungen**.

<Warning>
  **Nach jeder Zahlung:** Wechsle zurück in Shopify POS und schließe den Checkout manuell ab — wähle die **benutzerdefinierte Zahlungsart** (z. B. *SumUp*). Erst dann ist die Bestellung in Shopify bezahlt.
</Warning>

### Kassierer-Name (Trinkgeld-Zuordnung)

Trinkgeld wählt der Kunde **am Terminal** — nicht in einem Tab des Modals. Im Tab **Einstellungen** gibt es nur das Feld **Kassierer**: jeder Mitarbeiter trägt dort **einmalig** seinen Namen ein. Der Name wird bei den folgenden Zahlungen gespeichert und dem Trinkgeld zugeordnet.

**Wichtig für mehrere Kassierer an einer Kasse:** Jeder Mitarbeiter loggt sich mit seiner eigenen Shopify-POS-PIN ein. Der gespeicherte Name hängt am Login — beim Wechsel wird der Name des neuen Kassierers geladen.

Sobald ein Name eingetragen ist, verschwindet die Eingabe. Die Seite **Trinkgeld** in der App zeigt dann eine Auswertung nach Mitarbeiter.

#### Name korrigieren oder Mitarbeiter löschen

In der App unter **Trinkgeld** (unten: *Kassierer-Verwaltung*) kannst du Namen umbenennen oder inaktive Mitarbeiter entfernen. Bestehende Zahlungen ändern sich dadurch nicht.


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