Zahlen Home Page Help and Documentation

Learn how to navigate the Zahlen Home page, open operational workspaces, upload a CSV file, start an issuer diagnostics run, and review saved investigations.

Home Page Overview

The Zahlen Home page is the starting point for issuer diagnostics, investigation runs, monitoring, recovery intelligence, and operational workflows.

  • Open the major Zahlen workspaces.
  • Upload a CSV file for a new issuer analysis.
  • Review recent investigation runs.
  • Open previously completed runs and their saved outputs.
  • Access Help, Contact Us, registration, login, and system navigation.

Zahlen Workspace

Each workspace card includes an Open button. Select the button that matches the operational area you want to use.

Operator Dashboard

Provides a unified view of alerts, action queues, and escalation guidance.

Issuer Monitoring

Used to examine issuer behavior, Radar detections, timelines, profiles, and investigations.

Action Queue

Used to review processor actions, pending tasks, and operational follow-up work.

Network Intelligence

Displays issuer-network health and aggregated behavior intelligence.

Recovery Intelligence

Explains why declines recover, which issuers perform best, and when retry attempts are most effective.

System Health

Shows platform health, execution runs, snapshots, and readiness information.

Runtime Pathway Certification

Verifies that active subsystems can execute through their expected UI, API, worker, command-line, scheduler, runner, or event pathways.

Run History

Opens all saved CSV investigations and their generated artifacts.

Starting a New Issuer Diagnostics Run

  1. Select a CSV file.
  2. Confirm the Bank column setting.
  3. Choose whether state processing should be used.
  4. Choose whether spike alerts should be enabled.
  5. Choose whether AI mode should be enabled.
  6. Select Run issuer analysis.
  7. Keep the page open while Zahlen processes the file.
  8. Review the completed investigation run.

CSV File — Browse Button

The Browse… button is the first and most important control in the new-run workflow.

Browser wording may varyDepending on your browser or operating system, the button may appear as Browse…, Choose File, or Select File.

What the Browse Button Does

Selecting Browse opens your computer's normal file-selection window and lets you choose the CSV file Zahlen should analyze.

Selecting is not uploadingChoosing a file does not immediately send it to Zahlen. Upload begins only after you select Run issuer analysis.

How to Select a CSV File

  1. Select Browse….
  2. Navigate to the folder containing the transaction-event CSV.
  3. Select the correct file.
  4. Select Open, Choose, or the equivalent system button.
  5. Confirm that the filename appears in the file field.

Accepted File Type

The upload control accepts CSV files, normally ending in .csv.

issuer_declines.csv daily_transactions.csv retry_results_2026_06_14.csv

What Is a CSV File?

CSV means comma-separated values. It stores rows and columns in plain text. The first row usually contains column headings.

transaction_id,bank,decline_code,amount TX-1001,Example Bank,51,29.99 TX-1002,Example Bank,91,49.95

Verify the Correct File Before Submitting

  • Confirm the intended filename is displayed.
  • Make sure the file ends in .csv.
  • Verify the file contains the expected transaction-event data.
  • Confirm the first row contains headings.
  • Check that the Bank column setting matches the file.
  • Do not upload unrelated reports.
  • Remove unnecessary sensitive information.

File Privacy and Security

  • Avoid full payment-card numbers.
  • Do not include security codes, passwords, or authentication tokens.
  • Remove unnecessary personally identifiable information.
  • Do not upload data belonging to another tenant or organization.
  • Prefer masked values, tokens, or minimized data where possible.

Changing the Selected File

Before submitting, select Browse again and choose a different file. The new selection replaces the previous one.

Common File-Selection Problems

Filename does not appearReopen Browse, choose the file, and confirm with Open or Choose.
File is not visibleConfirm that it has a .csv extension.
File is an Excel workbookExport or save the workbook as CSV first.
Wrong file selectedSelect Browse again before submitting.
Unexpected columnsReview the heading row and Bank column setting.
Folder access is blockedMove the file or update browser file-access permissions.

Bank Column

The Bank column field tells Zahlen which CSV column contains the bank or issuer value. The default is:

bank

Other possible headings include:

issuer issuing_bank bank_name
Match the CSV exactlyAn incorrect Bank column value may prevent Zahlen from grouping or interpreting issuer data correctly.

Run Settings

Use State

Controls whether stateful processing is used where supported. The default is true.

Enable Spike Alerts

Evaluates uploaded data for unusual increases in issuer or decline activity. This option is selected by default.

Enable AI Mode

Enables configured AI-assisted analysis. Use it only when AI integration is available and the data is approved for AI-assisted processing.

Run Issuer Analysis

Select Run issuer analysis after reviewing the file and all settings.

  • Run metadata
  • Input-file information
  • Findings
  • Status information
  • Generated artifacts
  • Related monitoring or Recovery Intelligence data

Upload and Processing Progress Dialog

After submission, the button is disabled, its label changes to Processing…, and a modal dialog appears.

What the progress bar meansThe animated bar confirms that upload and processing are active. It is an activity indicator and may not represent an exact percentage.
  • Uploading and reading the CSV
  • Validating and normalizing rows
  • Creating the investigation record
  • Detecting issuer-specific patterns
  • Saving findings and artifacts
  • Populating related intelligence data

Keep the Page Open

Do not close, refresh, or navigate away while the progress dialog is visible.

No Cancel Button

The current version intentionally has no Cancel button. This avoids partially cancelled runs and unsafe deletion of records that may already have been written.

Duplicate Submissions

The submit button is disabled during processing so the same CSV cannot be submitted repeatedly by accident.

Recent Runs

Job IDThe unique investigation identifier.
StatusCreated, Running, Completed, or Failed.
CreatedThe date and time the run was created.
Input FileThe uploaded CSV filename.
ActionA link or button to open the run.

View All Runs

Select View all runs to open the complete Run History page.

Recommended Home Page Workflow

  1. Open the Home page.
  2. Review Recent Runs statistics.
  3. Select Browse in the CSV file field.
  4. Choose the authorized CSV file.
  5. Verify the displayed filename.
  6. Confirm the Bank column value.
  7. Leave Use state set to true unless instructed otherwise.
  8. Enable or disable spike alerts.
  9. Enable AI mode only when appropriate.
  10. Select Run issuer analysis once.
  11. Keep the page open while processing is active.
  12. Review the completed investigation.
  13. Use Recent Runs or View All Runs to reopen it later.