Transactions

Overview

This guide covers creating, viewing, and managing transactions through the Payment Hub system. A transaction represents funds received from a client that must be allocated across their active loan obligations. Transactions can be created manually or automatically by the system, with flexible distribution options.

Navigation: Client → Transactions tab or Transactions menu

Payment Hub interface

In timveroOS 8.0, payments are created through transactions at the client level, replacing the previous loan-level payment entry. This enables automatic distribution across multiple loans.

Transaction Concepts

How Payment Hub Works

Payment Hub introduces a two-step payment model:

1. Transaction — Record of funds received from client (client-level)

2. Payment — Allocation of transaction funds to a specific loan (loan-level)

One transaction can generate multiple payments across different loans belonging to the same client.

Transaction States

Status	Description	Available Actions
Unallocated	Linked to client, no funds distributed	Smart Allocate, Create Payment, Void
Partly Allocated	Some funds distributed, remainder available	Smart Allocate, Create Payment
Allocated	Fully distributed (unallocated amount = 0)	Cancel Payments
Void	Transaction cancelled	None

Registering Transactions

Creating a Transaction

Steps:

1. Navigate to the Client (!!!) record

2. Click Add Transaction

3. Complete the transaction form:

   • Payment Purpose: Distribution logic type (if multiple purposes configured)

   • Currency: Transaction currency

   • Amount: Total transaction amount

   • Document Number: Reference document (max 125 characters)

   • Transaction Date: Date funds were received

   • Smart Distribution: Enable to automatically allocate on save

4. Confirm transaction creation

Example of Transaction login form

Result: Transaction is created. If Smart Distribution is enabled, payments are automatically generated across client's loans.

Alternative creation locations (project-dependent): Loan page, Credit Line page, or Transactions menu (requires client selection).

Transactions can be created manually or triggered automatically by the system via scheduled processes or external integrations.

Automatic Distribution (Smart Distribution)

When Smart Distribution is enabled:

1. System creates transaction record

2. Automatically generates payments across client's loans based on:

   • Configured prioritization rules

   • Transaction purpose distribution logic

   • Obligation repayment hierarchy

3. Updates transaction status based on distribution result

Distribution rules are configured at SDK level for each project. If automatic distribution cannot complete, transaction is created in Unallocated status for manual processing.

Smart Allocate Action

For transactions in Unallocated or Partly Allocated status:

Steps:

1. Open transaction page

2. Click Smart Allocate

3. Review proposed distribution plan

4. Choose action:

   • Confirm: Accept plan and create payments

   • Cancel: Return without changes

The system displays how it proposes to distribute the transaction according to SDK-configured rules.

Manual Distribution

Creating Payments Manually

When automatic distribution is not used or is incomplete:

Steps:

1. Open transaction page

2. Navigate to Credits tab

3. Review list of client's active loans

4. Locate target loan

5. Click Payment button on the loan row

6. Complete payment form:

   • Loan: Pre-selected from action

   • Payment Type: Payment purpose (e.g., Mandatory, Voluntary)

   • Amount: Cannot exceed unallocated transaction amount or loan debt

   • Payment Application Date: Date to apply payment

7. Confirm payment creation

Result: Payment is created and automatically distributed across loan obligations according to configured rules.

Payment creation is available only when transaction has unallocated amount > 0.

Validation Rules

Rule	Description
Amount ≤ Unallocated	Payment cannot exceed remaining transaction amount
Amount ≤ Loan Debt	Payment cannot exceed total loan outstanding
Active Loans Only	Only active loans in transaction currency are available
Outstanding Balance	Only loans with unpaid debt are displayed

Transaction Page

Transaction Details

The transaction page displays:

• Transaction amount and currency

• Transaction date

• Document reference number

• Current status

• Unallocated amount

• Payment purpose

• Creation information

Credits Tab

The Credits tab shows a table of client's active loans:

Column	Description
Credit	Loan identifier/name
Contract Date	Loan contract date
Status	Loan status
Debt	Outstanding loan balance

For loans with payments from this transaction, additional details appear:

Column	Description
Payment Date	Date payment was applied
Payment Status	Payment status (e.g., Approved, Canceled)
Payment Amount	Amount allocated to this loan
Created By	User who created payment
Payment Distribution	Breakdown across obligation types

Payment Adjustments

Canceling Payments

To reverse a payment allocation:

Steps:

1. Locate payment in transaction details

2. Click Cancel

3. Confirm cancellation

Result:

• Canceled payment amount returns to transaction's unallocated amount

• Transaction status recalculates automatically:

  • All payments canceled → Unallocated

  • Some payments canceled → Partly Allocated

• Payment record status changes from Approved to Canceled

Only the selected payment is affected. Other payments remain unchanged.

Voiding Transactions

To cancel an unallocated transaction:

Steps:

1. Open transaction page

2. Verify status is Unallocated (no active payments)

3. Click Void

4. Confirm in dialog

Result: Transaction moves to Void status.

Only transactions in Unallocated status can be voided. Transactions with active payments must have all payments canceled first.

Common Scenarios

Standard Payment Processing

Scenario: Client payment received for multiple loans

1. Navigate to client record

2. Create transaction with full received amount

3. Enable Smart Distribution

4. Confirm creation

5. System automatically creates payments across loans

6. Verify distribution meets expectations

7. Review allocation on Credits tab

Manual Distribution Required

Scenario: Automatic distribution not needed or failed

1. Create transaction without Smart Distribution

2. Transaction enters Unallocated status

3. Navigate to Credits tab

4. Review available loans

5. Create payment on selected loan(s) manually

6. Repeat until transaction fully distributed or as needed

7. Unallocated amount remains available for future distribution

Partial Allocation

Scenario: Client specifies payment should apply only to certain loan(s)

1. Create transaction (with or without Smart Distribution)

2. If automatically distributed incorrectly, cancel unwanted payments

3. Manually create payments only on specified loans

4. Transaction remains in Partly Allocated status

5. Unallocated amount available for future use

Correcting Payment Distribution

Scenario: Payment was allocated to wrong loan

1. Open transaction record

2. Navigate to Credits tab

3. Cancel incorrect payment (full or partial amount)

4. Amount returns to unallocated

5. Create new payment on correct loan

6. Verify correct distribution

7. Document correction reason

Redistribution After Changes

Scenario: Loan conditions changed after distribution

1. Open transaction in Allocated or Partly Allocated status

2. Cancel all existing payments

3. Transaction returns to Unallocated status

4. Execute Smart Allocate to re-evaluate with current loan states

5. Or create payments manually with new distribution logic

Best Practices

Daily Operations

• Create transactions promptly upon receiving funds

• Use Smart Distribution for standard cases

• Verify distribution before finalizing

• Review unallocated amounts regularly

Accuracy

• Verify document number matches source

• Ensure transaction date is accurate

• Double-check currency selection

• Review Credits tab after automatic distribution

• Confirm payment dates align with business rules

Transaction Management

• Process oldest unallocated transactions first

• Void unused transactions to maintain clean records

• Use transaction purposes and payment types to support complex distribution rules

Troubleshooting

Cannot Create Transaction

Possible causes:

• Client has no active loans with outstanding balance

• Permission restrictions

• Required fields incomplete

Solutions:

• Verify client has active loans with unpaid amounts

• Check user permissions

• Complete all required fields

Smart Distribution Not Working

Possible causes:

• Distribution rules misconfigured

• No eligible loans for distribution

• Technical error in distribution algorithm

Solutions:

• Check loan statuses

• Verify distribution rules with administrator

• Use manual distribution as alternative

Payment Not Creating

Possible causes:

• Amount exceeds unallocated balance

• Amount exceeds loan debt

• Loan status changed

• Concurrent modification by another user

Solutions:

• Refresh transaction page to view current state

• Verify amounts

• Check loan status

Cannot Cancel Payment

Possible causes:

• Concurrent modification by another user

• Payment already canceled

• System lock on transaction

Solutions:

• Refresh page and retry

• Verify payment status

• Contact administrator if issue persists

Transaction Shows Incorrect Status

Possible causes:

• Stale page data

• Recent payment changes not reflected

• Calculation error

Solutions:

• Refresh transaction page

• Verify unallocated amount manually

• Contact support if discrepancy persists

Related Configuration

• Payment Hub — Automatic Payment Allocation — SDK technical reference

Related Topics

• Payment Hub Overview — Business context and concepts

• Loan Tracking — Viewing loan details and balances