Reporting Overview
Overview
Lithic provides several reporting products to support your reconciliation, accounting, and compliance workflows. Each serves a distinct purpose, operates on a different cadence, and is sourced from different underlying data. This page explains what each product does and how to choose between them.
Reporting products
Settlement API
The Settlement API provides programmatic access to settlement activity at multiple levels of granularity — individual transaction records, daily aggregate summaries, and official network totals. It is the primary tool for daily reconciliation and for confirming that cash movements from your settlement accounts match your transaction history.
Settlement Reporting
Settlement Reporting is the passthrough of raw network settlement files — such as VSS reports from Visa and T-series files from Mastercard — delivered to your institution directly via SFTP. These are the source files as received from the networks, forwarded by Lithic without transformation. Clients use these files to obtain settlement totals ahead of their wire drawdown and to meet bank-level reporting requirements.
Lithic Reporting Suite
Lithic Reporting Suite are daily flat files delivered via SFTP, generated from Lithic data. They provide card transaction detail, network summaries, ACH activity, ledger balances, and more — giving banks the data they need for internal accounting, regulatory reporting, and similar workflows. Lithic Reporting Suite are included by default when Lithic acts as Program Manager, and available as a paid add-on for other program types.
Quarterly Network Reporting
Quarterly Network Reporting provides the data needed to complete network-mandated quarterly submissions — the Quarterly Mastercard Report (QMR) for Mastercard and the Global Operating Certificate (GOC) for Visa. These reports contain program-level summaries of card transaction volume, interchange, and fees as reported by each network. This is a paid add-on used for network compliance submissions and program cost analysis.
Choosing the right report
| I need to… | Use |
|---|---|
| Get settlement totals before my wire drawdown | Settlement Reporting (Settlement API or SFTP report) |
| Confirm exact cash movement amounts (if you manage your own network settlement) | Network Totals (Settlement API or SFTP report) |
| Reconcile transaction-level settlement activity | Settlement Details (Settlement API) |
| Know when settlement processing is complete | Settlement Summaries + is_complete webhook |
| Produce regulatory reports for my bank | Bank Reports |
| Complete my quarterly network submissions (QMR / GOC) | Quarterly Network Reporting |
How the systems relate
All settlement data originates from files delivered by the card networks — Mastercard, Maestro, Visa, Interlink, and Amex. Lithic processes these files into the Settlement API records and summaries. Bank Reports are generated downstream from that same data.
Settlement Reporting is an exception: it forwards raw network files directly to you via SFTP and is independent of Settlement API processing. It is the fastest deliverable for clients who need pre-wire settlement totals.
Delivery timing
All times are Eastern. These windows reflect observed delivery times under normal conditions — see each product's page for detail on timing variability and delays.
| Deliverable | Typical availability | Deadline |
|---|---|---|
| Settlement Reporting (SFTP) | ~10:00 AM | 6:00 PM |
| Settlement Records (API) | ~10:30–11:00 AM | 6:00 PM |
| Settlement Summaries (API/Webhook) | ~10:30 AM–1:30 PM | End of day ET† |
| Bank Reports (SFTP/Email) | ~11:00 PM | 12:01 AM |
† Lithic will declare an incident on the status page if Settlement Summaries are not marked complete by end of day Eastern time.
Bank Reports have a hard dependency on settlement processing. If settlement processing is delayed, Bank Report delivery will be delayed accordingly. Settlement Reporting and Network Totals are independent of this — Settlement Reporting is the primary tool for clients who need pre-wire settlement totals, while Network Totals (via the Settlement API) are the most reliable option for clients who manage their own network settlement.
Access and availability
| Product | Tier | How to access |
|---|---|---|
| Settlement API | Enterprise | API |
| Settlement Reporting | Enterprise | Configured per program |
| Bank Reports | Included for banks where Lithic is Program Manager; paid add-on otherwise | Configured per program |
| Quarterly Network Reporting | Paid add-on | Configured per program |
For more information, please contact [email protected]
Webhooks and event subscriptions
The Settlement API supports event webhooks for key state changes. Subscribe to these to avoid polling:
settlement_report.updated— fires when a Settlement Summary is updatednetwork_total.created— fires when a new Network Total record is availablenetwork_total.updated— fires when a Network Total'sis_completeflag transitions totrue
See Event Subscriptions → for setup instructions.
Updated about 4 hours ago
