Zahlungseingänge prüfen

Das tebio Business-Portal bietet im Bereich Finanzen unter dem Reiter Zahlungen eine zentrale, globale Übersicht aller im System verarbeiteten Zahlungstransaktionen. Hier können Sie den Status von Einzügen, Überweisungen, manuellen Zahlungen und Erstattungen in Echtzeit überwachen und detailliert analysieren.

Wann brauche ich diese Ansicht?

Nutzen Sie die Zahlungsübersicht und die Transaktionsdetails, wenn Sie:

Den genauen Status einer spezifischen Zahlung (z. B. nach einer Kundenanfrage zu einer Mahnung) prüfen möchten.
Gezielt nach fehlgeschlagenen Zahlungen (z. B. geplatzten SEPA-Lastschriften) oder ausstehenden Überweisungen filtern müssen.
Provider-Informationen (wie die Referenz-ID von PayPal oder Stripe) für die Buchhaltungsabstimmung suchen.
Eine Erstattung erfassen oder eine Zahlung manuell finalisieren möchten (siehe Zahlung erfassen).

Aufbau der Zahlungsübersicht (Tabelle)

Die tabellarische Übersicht listet alle Transaktionen chronologisch auf und bietet folgende Informationen auf einen Blick:

Entität des Zahlers: In der Regel ist dies der Kunde, es kann aber auch ein Vertriebspartner sein.
Zahlungsart: Beschreibt den Kontext der Transaktion (z. B. Erstellung einer Zahlungsvereinbarung, Erfassung einer Zahlung, Autorisierung).
Zahlungsmethode: Das genutzte Zahlungsmittel (z. B. SEPA, PayPal, Kreditkarte).
Betrag: Die Höhe der Zahlungstransaktion.
Status: Der Echtzeit-Status (z. B. Erfolgreich, Ausstehend, Fehlgeschlagen).
Datum: Der exakte Zeitstempel der Ausführung.

Voraussetzungen

Sie benötigen die erforderlichen Berechtigungen im Business-Portal für diesen Vorgang.

Schritt-für-Schritt-Anleitung

Filter- und Suchmöglichkeiten

Um in großen Datenmengen schnell fündig zu werden, stehen Ihnen diverse Filter zur Verfügung:

Schnellfilter: Filtern Sie direkt nach Zahlungsmethode, Status, Zahlungsart und einem Datumsbereich (Datum von / bis).
Erweiterte Suche (“mehr Filter”): Hier können Sie gezielt nach einem bestimmten Kunden/Partner, der internen Transaktions-ID oder der externen Referenz der Provider-Transaktion (ideal für den Abgleich mit Bankauszügen oder Provider-Dashboards) suchen.

Transaktionsdetails einsehen

Klicken Sie auf eine beliebige Zeile in der Tabelle, um in die detaillierte Ansicht dieser spezifischen Zahlung zu gelangen.

1. Linker Bereich (Übersicht & Aktionen)

Hier sehen Sie den gebuchten Betrag (z. B. EUR 550,00) und den aktuellen Status (Erfolgreich, Fehlgeschlagen oder Ausstehend) als großen Badge. Darunter finden Sie kompakt die wichtigsten Stammdaten:

Der zahlende Kunde (klickbar, führt direkt zur Kundenakte).
Die Zahlungsmethode und Zahlungsart.
Die Zahlungsgruppe (z. B. Customer_Default).
Die verknüpfte Zahlungsvereinbarung (ID) sowie deren Status (z. B. AKTIV oder DEAKTIV).

Aktions-Buttons: Je nach Status der Zahlung werden Ihnen hier relevante Folgeprozesse angeboten:

Bei erfolgreichen Zahlungen finden Sie hier den Button Erstattungszahlung (Refund Payment).
Bei manuell zu pflegenden, ausstehenden Zahlungen (z. B. externe Überweisungen) finden Sie hier den Button Finalize Payment (bzw. “Zahlung finalisieren”).

2. Rechter Bereich (Detail-Reiter)

Über die Reiter im rechten Bereich können Sie tiefer in die technischen Informationen eintauchen:

Details vom Zahlungsanbieter: Zeigt provider-spezifische Informationen wie Kontoname und Konto-ID. Sie sehen hier zudem die interne Zahlungstransaktion (intern) sowie den Grund der Zahlung (inklusive Referenz zur Rechnung), das zugehörige Abonnement, das abgerechnete Produkt sowie exakte Zeitstempel (Start, Ende, Zahlungsdatum).
Sub-Transaktion: Falls eine Zahlung gesplittet wurde oder komplexe Authorisierungs-Capture-Abläufe (z. B. Reservierung auf der Kreditkarte und spätere Abbuchung) durchlief, werden die einzelnen Teil-Transaktionen hier tabellarisch aufgelistet.

Hinweise und typische Fehler

Fehlgeschlagene Zahlungen ohne Erstattungs-Button: Eine fehlgeschlagene Zahlung kann systembedingt nicht erstattet werden, da nie Geld geflossen ist. Entsprechende Buttons werden in diesem Status automatisch ausgeblendet.
Provider-Referenzen: Wenn Sie Unstimmigkeiten zwischen dem tebio Business-Portal und Ihrem Payment-Service-Provider (PSP) vermuten, gleichen Sie immer die Referenz der Provider-Transaktion ab, um den exakten Flow im PSP-Dashboard nachzuvollziehen.

Ergebnis

Sie haben die Transaktionshistorie erfolgreich nachvollzogen, die exakten Details vom Zahlungsanbieter ausgelesen und konnten bei Bedarf Folgeprozesse wie eine manuelle Erstattung anstoßen.

API-Hinweise

Falls Sie Zahlungsdaten programmatisch abrufen möchten (z. B. für externe Dashboards oder ERP-Systeme), stehen Ihnen folgende Endpunkte des PaymentTransactionService zur Verfügung:

Endpunkt	Methode	Beschreibung	OperationId
`/v2/payment/transaction/search`	POST	Ermöglicht das Filtern und Durchsuchen der globalen Transaktionsliste.	searchTransactions
`/v2/payment/transaction/{transactionUuid}`	GET	Ruft die vollständigen Details inkl. Provider-Referenzen und Sub-Transaktionen zu einer spezifischen `transactionUuid` ab.	getTransaction