SumUp-Zahlungen in InvoFlux einrichten

Mit SumUp können Sie Kartenzahlungen und Online-Zahlungen direkt über InvoFlux abwickeln. Diese Anleitung beschreibt, wie Sie Ihre SumUp-Zugangsdaten hinterlegen und den Zahlungsworkflow nutzen.

Voraussetzungen

• Aktives SumUp-Händlerkonto.
• Zugang zum SumUp Developer Portal.
• InvoFlux-Account mit aktivierter SumUp-Integration.

Schritt 1: API-Zugang in SumUp erstellen

1. Melden Sie sich im SumUp Developer Portal an.
2. Erstellen Sie eine neue Anwendung (App) für Ihre Online-Zahlungen.
3. Notieren Sie sich die bereitgestellten Zugangsdaten, z. B.:
   • Client ID / Client Secret (für OAuth)
   • oder einen API Key (Server-Side Secret), falls Ihr SumUp-Setup dies nutzt.
4. Stellen Sie sicher, dass für Ihre App der Zugriff auf das Checkout-Modell (Online Payments) freigeschaltet ist. 

Schritt 2: SumUp-Zugangsdaten in InvoFlux hinterlegen

1. Melden Sie sich in InvoFlux an.
2. Öffnen Sie Einstellungen → Zahlungen → SumUp.
3. Tragen Sie Ihre SumUp-Zugangsdaten ein, z. B.:
   • Client ID und Client Secret für OAuth
   • oder API Key, falls InvoFlux diese Variante verwendet.
4. Speichern Sie die Einstellungen.

Schritt 3: Zahlungsworkflow mit SumUp (Online Checkout)

Der typische Ablauf für Online-Zahlungen mit SumUp und InvoFlux sieht wie folgt aus:

1. Sie erstellen in InvoFlux eine Rechnung für Ihren Kunden.
2. Sie aktivieren SumUp als Zahlungsmethode für diese Rechnung.
3. InvoFlux erstellt im Hintergrund ein Checkout-Objekt bei SumUp mit:
   • Betrag (Rechnungsbetrag)
   • Währung
   • Checkout-Referenz (z. B. die Rechnungsnummer)
   • und der Redirect-URL zurück zu InvoFlux. 
4. Ihr Kunde erhält einen Zahlungslink (z. B. in der Rechnungs-E-Mail) und wird zur SumUp-Zahlungsseite weitergeleitet.
5. Der Kunde schließt die Zahlung auf der SumUp-Seite ab (Karte, ggf. weitere Zahlungsmethoden).
6. Nach der Zahlung leitet SumUp den Kunden zurück zu InvoFlux (Redirect-URL).
7. InvoFlux prüft den Status des Checkouts bei SumUp und markiert die Rechnung als bezahlt, wenn die Zahlung erfolgreich war. 

Schritt 4: Test der SumUp-Integration

1. Erstellen Sie in InvoFlux eine Testrechnung mit SumUp als Zahlungsmethode.
2. Öffnen Sie die Rechnungsansicht und klicken Sie auf den SumUp-Zahlungslink.
3. Führen Sie eine Testzahlung mit einem geeigneten Kartendatensatz durch (je nach Testumgebung von SumUp).
4. Nach erfolgreicher Zahlung sollten Sie:
   • In InvoFlux die Rechnung als bezahlt sehen.
   • In Ihrem SumUp-Händlerkonto die entsprechende Zahlung im Bereich Checkouts bzw. Transaktionen finden. 

Fehlerbehebung

Fehlermeldung „Zugriff verweigert“ oder „Unauthorized“

• Prüfen Sie, ob Client ID / Secret bzw. API Key korrekt in InvoFlux hinterlegt sind.
• Stellen Sie sicher, dass Ihre SumUp-App die notwendigen Berechtigungen für Online-Checkouts hat.

Kunde wird nicht zurück zu InvoFlux geleitet

• Prüfen Sie, ob in SumUp die korrekte Redirect-URL eingetragen ist, falls dies in Ihrer App-Konfiguration erforderlich ist.
• Kontrollieren Sie, ob der Kunde den Zahlungsprozess vollständig abgeschlossen hat.

Rechnung bleibt offen, obwohl SumUp-Zahlung erfolgreich ist

• Prüfen Sie, ob InvoFlux nach dem Redirect den Checkout-Status korrekt abfragt (dies erfolgt in der Regel automatisch im Hintergrund).
• Kontrollieren Sie Ihre Server-Logs auf Fehlermeldungen im Zusammenhang mit der SumUp-API.
• Vergleichen Sie die Checkout-Referenz in SumUp mit der Rechnungsnummer in InvoFlux, um sicherzustellen, dass die Zuordnung stimmt. 

Bei Fragen zur SumUp-Integration oder Fehlermeldungen, die Sie nicht zuordnen können, wenden Sie sich an den InvoFlux-Support oder Ihren SumUp-Ansprechpartner.