Product Foundation
Understand the product narrative, retry philosophy, and platform architecture.
View foundation docsZahlen Financial Documentation
Product, operator, API, and governance help in one place.
Use this documentation center to learn the Zahlen platform, guide first-time operators, understand deterministic retry operations, integrate APIs, review governance safeguards, and troubleshoot production workflows.
Operator Guides
Follow practical workflows for CSV ingestion, investigations, dashboards, and recovery operations.
View operator docsAPI Reference
Build against authentication, payment events, retry decisions, outcomes, webhooks, and quotas.
View API docsGovernance & Support
Review governance concepts, public transparency guidance, runbooks, and troubleshooting.
View support docs1. Product foundation
Strategic overview documents that explain what Zahlen is, why deterministic retry matters, and how the platform is structured.
Executive Product NarrativeIntroduces Zahlen Financial’s product story, target problem, recovery opportunity, and commercial value.
Deterministic Retry PhilosophyExplains why predictable retry logic, safe timing, and repeatable decisions matter for payment recovery.
Platform Architecture OverviewMaps the major system components, operator surfaces, intelligence services, and integration boundaries.
2. First-time workflows
Step-by-step onboarding resources for operators learning how to upload data, launch investigations, and interpret results.
First-Time Operator WorkflowGuides a new operator through the recommended first path across the Zahlen application.
CSV Ingestion GuideExplains CSV upload preparation, field expectations, ingestion behavior, and validation tips.
First Investigation WalkthroughWalks through the first decline investigation from uploaded records to interpreted recovery intelligence.
3. Operator page documentation
Detailed help for the primary dashboards and operator workspaces inside the Zahlen interface.
Dashboard DocumentationExplains the main operator dashboard, summary cards, recent runs, and workspace navigation.
Monitor Console DocumentationCovers monitoring views used to review issuer signals, radar activity, and operational intelligence.
Investigation Workspace DocumentationExplains how investigation evidence, run details, outcomes, and supporting context are presented.
Action Queue DocumentationDescribes recommendation queues, action states, prioritization, and operational follow-through.
Supervisor Dashboard DocumentationExplains supervisor-level oversight, operational status, escalations, and team coordination views.
Network Intelligence Dashboard DocumentationCovers network intelligence, issuer patterns, ecosystem trends, and cross-merchant insights.
System Health DocumentationDocuments system health views, service status, ingestion health, and operational reliability signals.
4. Core concepts library
Reference material for the ideas behind issuer cognition, recovery curves, replay safety, governance, and federation trust.
Core Concepts LibraryA central glossary-style guide to the key product and intelligence concepts used across Zahlen.
Deterministic Retry SystemsDefines deterministic retry systems and explains how repeatable recovery decisions are governed.
Issuer CognitionExplains issuer behavior recognition, issuer memory, classification, and signal interpretation.
Recovery CurvesDescribes how recovery probability changes over time and how operators should read recovery patterns.
Replay SafetyCovers safe replay behavior, duplicate protection, idempotency expectations, and operational safeguards.
Governance IntegrityExplains data ownership boundaries, audit discipline, and confidence controls for governed operations.
Ecosystem IntelligenceIntroduces multi-source ecosystem signals, aggregation concepts, and network-level observability.
Federation Trust DomainsExplains trust boundaries, federation assumptions, and safe cross-domain intelligence principles.
5. Operations and governance
Operational guidance for incidents, governance confidence, verification, and survivability.
Incident CoordinationGuides coordinated response when operational, issuer, ingestion, or recovery issues require attention.
Governance ConfidenceExplains confidence scoring, evidence handling, governance review, and responsible operational decisions.
Replay Verification OperationsCovers verification practices for replayed events, regenerated outputs, and operational consistency checks.
Operational SurvivabilityDescribes continuity practices, reliability safeguards, and resilient operating patterns.
6. Integration and data movement
Technical integration guides for schemas, APIs, event streaming, and exports.
CSV SchemasDefines supported CSV fields, expected values, normalization behavior, and schema preparation guidance.
API IngestionExplains API-based data submission, authentication expectations, and ingestion flow design.
Event StreamingCovers streaming ingestion concepts, event flow, durability expectations, and operational boundaries.
Export APIsDocuments export concepts for retrieving investigation, recovery, and reporting data safely.
7. Public intelligence and transparency
Guidance for safe public-facing issuer health, aggregation, transparency, and confidence indicators.
Public Issuer HealthExplains how issuer health can be communicated safely and responsibly in public contexts.
Public Safe AggregationDescribes aggregation practices that protect tenant boundaries while allowing useful public insights.
Ecosystem TransparencyCovers transparency principles for ecosystem behavior, reporting, and public trust.
Confidence VisibilityExplains how confidence levels should be surfaced so readers understand evidence strength.
Public Governance IndicatorsDefines governance indicators suitable for public review without exposing sensitive tenant data.
8. Troubleshooting, runbooks, and application help
Operator support documents, application help pages, troubleshooting references, and glossary resources.
Troubleshooting GuideHelps diagnose common upload, investigation, API, dashboard, and operational issues.
Operational RunbooksProvides repeatable runbook procedures for recurring operational tasks and incident response.
GlossaryDefines terms used across recovery operations, issuer intelligence, APIs, governance, and dashboards.
Home Help DocumentationExplains the main help experience and how operators should navigate the documentation system.
Operator Dashboard HelpDetailed page-level help for the operator dashboard and its key metrics.
Recovery Intelligence HelpExplains expected revenue recovery, retry intelligence, recovered outcomes, and recovery evidence.
Issuer Monitoring HelpGuides operators through issuer monitoring signals, radar output, and classification views.
Action Queue HelpExplains recommendation review, queue handling, action status, and operational follow-up.
Incident Workspace HelpCovers the incident workspace used for coordination, evidence, ownership, and resolution.
Issuer Health Runs HelpExplains health run history, status interpretation, and issuer health evidence.
Issuer Supervisor HelpDocuments supervisor-level issuer review, escalation visibility, and monitoring oversight.
Job Run HelpExplains job run details, processing states, artifacts, results, and completion context.
Network Issuer Dashboard HelpGuides operators through network-level issuer dashboard views and ecosystem intelligence.
API user guide
Developer documentation for commercial API usage, authentication, quotas, payment events, retry decisions, webhooks, SDK examples, and appendices.
Chapter 1 — IntroductionIntroduces the Zahlen API, core use cases, product scope, and integration model.
Chapter 2 — Getting StartedCovers initial setup, first calls, required headers, and practical onboarding steps.
Chapter 3 — AuthenticationExplains API key usage, tenant-scoped access, secure handling, and authentication failures.
Chapter 4 — Usage PlansDocuments commercial usage plan concepts, entitlement boundaries, and plan-driven access.
Chapter 5 — Rate Limits and QuotasExplains request limits, quota enforcement, usage tracking, and 429 response expectations.
Chapter 6 — Payment Events APIDescribes payment event ingestion endpoints, request payloads, validation, and event modeling.
Chapter 7 — Retry Decision APIExplains retry decision requests, decision outputs, timing recommendations, and confidence signals.
Chapter 8 — Retry Outcome APIDocuments outcome reporting for retry attempts, recovery state, and result tracking.
Chapter 9 — Investigation Runs APICovers investigation run creation, status retrieval, artifacts, and operational result review.
Chapter 10 — WebhooksExplains webhook event delivery, endpoint configuration, payload expectations, and delivery safety.
Chapter 11 — Error HandlingDocuments HTTP errors, validation failures, retry-safe responses, and troubleshooting patterns.
Chapter 12 — Audit and ComplianceCovers audit trails, tenant isolation, governance controls, and compliance-minded operations.
Chapter 13 — SDK ExamplesProvides Python, curl, and JavaScript examples for common integration workflows.
Chapter 14 — Production Best PracticesReviews key rotation, retry strategies, monitoring, resilience, and production readiness practices.
Appendix A — OpenAPI SpecificationProvides the OpenAPI reference for endpoint discovery, schema review, and developer tooling.
Appendix B — JSON ExamplesCollects representative request and response JSON examples for implementation reference.
Appendix C — TroubleshootingProvides API-focused troubleshooting guidance for authentication, validation, quotas, and integrations.
Need help finding the right document?
Contact Zahlen Financial for support with product documentation, operator onboarding, API usage, or implementation planning.