Configure payment methods
Under the menu item Payment Methods (can be found under Invoicing and Invoices) you can determine how your customers can pay for subscriptions and products. The tebio business portal offers you an overview of various payment methods that you can activate, configure and restrict to specific user groups.
A fundamental distinction is made between payment gateways (which require a separate contract with a payment provider) and house bank procedures (where payments flow directly to your own business account).
When do I need this function?
Section titled “When do I need this function?”You need this function to ensure that your customers can pay when booking in the checkout or in the self-care / customer portal. By selecting and configuring suitable gateways or direct banking procedures, you control the payment flow and customer experience (e.g. by offering credit cards via Stripe or direct debits via your house bank).
Requirements
Section titled “Requirements”- For payment gateways (Stripe, PayPal, Computop): You have concluded an existing contract with the respective payment service provider and have the necessary access data (such as API keys, client secrets or an account ID).
- For house bank procedures (SEPA): You have made a direct debit agreement with your bank and ideally have a creditor identification number (creditor ID).
Step-by-step instructions
Section titled “Step-by-step instructions”In the main left menu, navigate to Billing and Invoices and select Payment Methods. Tiles are then displayed for all available methods.
1. Connect payment gateways
Section titled “1. Connect payment gateways”At the payment gateways, specialized payment service providers process the transactions. This requires a separate contract with the relevant provider.
Click Connect for the desired method (or View Details if it is already set up).
- Stripe: The connection is implemented via Stripe Connect. This means that your own Stripe account is connected to tebio’s Stripe account directly from the business portal. You can simply start this process using the button and, if necessary, create a completely new Stripe account in the same step. After the connection, you will see your Account ID in the dialog and can check which of the following payment methods have been activated for you with Stripe:
- Credit card payments (including Google Pay and Apple Pay)
- Klarna
- SEPA direct debit (with virtual IBANs from Stripe)
- Amazon Pay
- PayPal: The connection enables convenient payments via PayPal account. You enter your Client ID, the Client Secret and the Merchant ID. A web profile ID is optional.
[!IMPORTANT] Important for Subscriptions: In order to collect recurring payments for subscriptions, you must specifically request the “Reference Transactions” feature from PayPal. To do this, contact PayPal Support and state that you want to charge recurring invoices on the basis of a “Billing Agreement”, that the payments will be collected after the initial setup without further active confirmation from the buyer and that you are using a direct API integration without an additional third-party PSP.
- Computop: Computop is available as another secure gateway. It supports major credit cards (such as Visa, MasterCard, American Express) as well as automated, recurring payments (e.g. for subscription renewals). To activate Computop, enter the encryption key, the HMAC key, your Merchant ID and the assigned zone.
2. Configure house bank procedure
Section titled “2. Configure house bank procedure”With these procedures (“external payments”), the actual money transfer is not processed directly via the portal. The platform simply documents these payments without tebio automatically triggering a flow of funds (exception: you use the bank files generated by tebio for further processing at your house bank). Payment actions such as Authorize, Capture, Cancel or Refund are not supported by the system.
- SEPA direct debit (external): Enter your creditor identification number, the IBAN, the BIC and the name of the account holder. You can use a switch to specify whether collections should be bundled as a collective booking. Use a dropdown to specify the type of direct debit (CORE or B2B). Note: SEPA B2B direct debits require a separate, written mandate that you must obtain and manage outside of the platform. The system generates a pain.008 XML file (versions
pain.008.001.08topain.008.001.11) for the processed payments, which you can upload to your bank. You can find these generated files in the portal under Payments > Reports.[!TIP] The status model: Use the Status model dropdown to define how the platform evaluates external payments:
- CLOSED_OK_ONLY: Every transaction is immediately documented in the portal as a successful payment.
- FINALIZE_DRIVEN_STATUS: Transactions are initially created in the status
PENDING(Pending) and wait, for example. B. on the successful direct debit. They are only considered complete after manual finalization. If no confirmation is received within the waiting period (standard: 14 days or 20,160 minutes), the payment automatically switches toCLOSED_FAILED.
- SEPA transfer (external): Enter the recipient/account holder, your IBAN, the BIC and the name of the bank here. Customers receive this data in the checkout as the destination for their transfer. For SEPA transfers, the system creates a pain.001 file (supported versions:
pain.001.001.09topain.001.001.12). - Other external procedures: If required, the system also supports additional documentation via the interfaces such as cash on delivery (EXTERNAL_COD), Point of Sale (POS) (EXTERNAL_POS) or cash payments (EXTERNAL_PAYMENT).
3. Set up role-based permission
Section titled “3. Set up role-based permission”On the right side of each payment method tile you will find the Role Based Permission section.
- Click Settings (or Edit).
- A dialog opens with various user groups (e.g. subscription management with full access, account holders, customer support, customers in the self-care / customer portal, customers (order page), sales partners).
- Tick the roles that should have this payment method available to them.
- Important: If no roles are selected, the payment method will be available to all authorized users.
- Finally, click Save Changes.
Tip: If you want to switch off a payment method completely, click on Delete method (or Disconnect service) in the details dialog at the top right.
Result
Section titled “Result”After saving the configurations, the payment method will be available to the user groups you selected during the payment process (e.g. on your hosted pages). The status display on the respective tile changes to Connected.
Notes and typical errors
Section titled “Notes and typical errors”- Missing PayPal Reference Transactions: One of the most common errors with subscriptions is that recurring payments via PayPal fail because PayPal’s “Reference Transactions” feature has not yet been activated for your merchant account.
- SEPA B2B direct debits fail: Remember that a separate written mandate is required for B2B direct debits (corporate customers). The payer must present this to his bank, otherwise the direct debit will be rejected.
- External payments expire: If you use the status model
FINALIZE_DRIVEN_STATUSfor house bank procedures, you must not forget to confirm receipt of payment (e.g. through bank statement reconciliation). After the deadline has expired (standard: 14 days), the payments will automatically change to the statusCLOSED_FAILED.
API notice
Section titled “API notice”If you want to automate the configuration of payment methods or the retrieval of SEPA files, you can do this via our API. Here are the key endpoints for this area:
-
Configuration via the API: All parameters visible in the interface (e.g. client IDs, status models, access data) can be accessed and configured via the API. Use the payment settings for this:
- Get configuration: Get payment settings
- Set configuration: Set payment settings
-
Retrieve pain.008 files automatically: If you do not want to manually download created SEPA files (e.g. for direct debit) via the portal, retrieve them in the following sequence:
- Detect document type: Search for the UUID of the document type using the filter
code = pain.008. - Find related documents: Use the type ID found to search for the actual documents.
- Get file contents: Download the discovered documents.
- Detect document type: Search for the UUID of the document type using the filter