Check incoming payments
The tebio Business Portal provides a central, global overview of all payment transactions processed in the system under Finance on the Payments tab. Here you can monitor and analyze the status of collections, transfers, manual payments, and refunds in real time.
When do I need this view?
Section titled “When do I need this view?”Use the payment overview and transaction details if you:
- Want to check the exact status of a specific payment (for example after a customer inquiry about a reminder).
- Need to filter specifically for failed payments (for example bounced SEPA direct debits) or outstanding transfers.
- Are looking for provider information (such as the PayPal or Stripe reference ID) for accounting reconciliation.
- Want to record a refund or manually finalize a payment (see Record payment).
Structure of the payment overview (table)
Section titled “Structure of the payment overview (table)”The table lists all transactions chronologically and provides the following information at a glance:
- Payer entity: Usually this is the customer, but it can also be a sales partner.
- Payment type: Describes the context of the transaction (for example creation of a payment agreement, recording of a payment, authorization).
- Payment method: The payment instrument used (for example SEPA, PayPal, credit card).
- Amount: The amount of the payment transaction.
- Status: The real-time status (for example Successful, Pending, Failed).
- Date: The exact timestamp of execution.
Requirements
Section titled “Requirements”- You need the required permissions in the Business Portal for this process.
Step-by-step guide
Section titled “Step-by-step guide”Filter and search options
Section titled “Filter and search options”To find records quickly in large data sets, several filters are available:
- Quick filters: Filter directly by payment method, status, payment type, and a date range (date from / to).
- Advanced search (“more filters”): Search specifically for a particular customer/partner, the internal transaction ID, or the external provider transaction reference (ideal for matching bank statements or provider dashboards).
View transaction details
Section titled “View transaction details”Click any row in the table to open the detailed view of that specific payment.
1. Left area (overview and actions)
Section titled “1. Left area (overview and actions)”Here you see the booked amount (for example EUR 550.00) and the current status (Successful, Failed, or Pending) as a large badge.
Below that you find the most important master data:
- The paying customer (clickable, goes directly to the customer record).
- The payment method and payment type.
- The payment group (for example
Customer_Default). - The linked payment agreement (ID) and its status (for example
ACTIVEorINACTIVE).
Action buttons: Depending on the payment status, relevant follow-up processes are offered here:
- For successful payments you find the Refund Payment button.
- For manually maintained pending payments (for example external transfers) you find the Finalize Payment button.
2. Right area (detail tabs)
Section titled “2. Right area (detail tabs)”Use the tabs on the right to drill into the technical information:
- Payment provider details: Shows provider-specific information such as account name and account ID. You also see the internal payment transaction, the reason for the payment (including the invoice reference), the related subscription, the billed product, and exact timestamps (start, end, payment date).
- Sub-transaction: If a payment was split or went through a complex authorization-capture flow (for example a credit-card reservation and a later capture), the individual partial transactions are listed here in a table.
Notes and typical errors
Section titled “Notes and typical errors”- Failed payments without a refund button: A failed payment cannot be refunded because no money was transferred. The corresponding buttons are hidden automatically in this status.
- Provider references: If you suspect discrepancies between the tebio Business Portal and your payment service provider (PSP), always compare the provider transaction reference to follow the exact flow in the PSP dashboard.
Result
Section titled “Result”You have successfully reviewed the transaction history, read the exact details from the payment provider, and if needed started follow-up processes such as a manual refund.
API notes
Section titled “API notes”If you want to retrieve payment data programmatically (for example for external dashboards or ERP systems), the following PaymentTransactionService endpoints are available:
| Endpoint | Method | Description | OperationId |
|---|---|---|---|
/v2/payment/transaction/search | POST | Filter and search the global transaction list. | searchTransactions |
/v2/payment/transaction/{transactionUuid} | GET | Retrieve full details including provider references and sub-transactions for a specific transactionUuid. | getTransaction |