Retrieve reports

Last updated: October 1, 2025

Checkout.com provides a range of reports to support your business operations and help you gain insight.

You can retrieve reports in the following ways:

Generate and download reports in the Dashboard, on demand or on schedule.
Retrieve reports programmatically using the Reports API.
Access reports using Secure File Transfer Protocol (SFTP).
Receive scheduled reports using webhooks.

For detailed information about the purpose and contents of a report, select it in the Report name column.

The following reports are available:

Report name	Description
Authentication Report	All authentications within the specified time frame
Balance Breakdown Report	All financial activity impacting your available balance within the specified time frame, which you can use for balance management and reconciliation
Balance Report	All your balances within the specified time frame, which you can use for balance management and reconciliation
Bank Payouts Report	All successful and declined bank payouts within the specified time frame
Card Payouts Report	All successful and declined card payouts within the specified time frame
Disputes Report	All disputes raised with you within the specified time frame
Fee Summary Report Available in the Dashboard only	All fees and taxes charged to your Checkout.com account within the specified time frame, including card scheme, interchange, and Checkout.com fees
Financial Actions by Date Range Report	All financial actions within the specified time frame that impacted your currency account's available balance, which you can use for balance management and reconciliation
Financial Actions by Payout ID Report	All financial actions for a specific payout, which you can use for reconciliation and settlements
Fraud Detection Report	A transaction-by-transaction summary of data points, rules triggered, outcomes at each stage, and any fraudulent transactions to help improve the performance of risk rules
Invoices	A monthly summary of Checkout.com fees for each of your active entities per currency, which you can submit as a tax document in applicable regions
Issuing: Authorization Activity Report	All transactional activities associated with your cards, including: Arbitrations Chargebacks Pre-arbitrations Presentments Representments
Issuing: Authorizations Report	All authorization, reversal, and advice messages within the specified time frame Note This report will be deprecated as of March 31, 2026 and is replaced by the Authorization Activity Report. For migration support, contact your account manager or request support.
Issuing: Cards Report	Information about all your issued cards within the specified time frame
Issuing: Chargebacks Report	All chargebacks raised after a dispute within the specified time frame Note This report will be deprecated as of March 31, 2026 and is replaced by the Clearing Activity Report. For migration support, contact your account manager or request support.
Issuing: Clearing Activity Report	All transactional activities associated with your cards, including: Arbitrations Chargebacks Pre-arbitrations Presentments Representments
Issuing: Clearing Summary Report	For processing-only clients, aggregated amounts for all transactional messages received within a specified time frame.
Issuing: Dispute Lifecycle Report	For processing-only clients, lifecycle events for all disputes you raised with merchants on issued cards
Issuing: Presentments Report	All presentments raised after a dispute within the specified time frame Note This report will be deprecated as of March 31, 2026 and is replaced by the Clearing Activity Report. For migration support, contact your account manager or request support.
Issuing: Quarterly Mastercard Report (QMR) Available in the Dashboard only	For processing-only clients, operational metrics that you must send to Mastercard every quarter
Issuing: Settlement Activity Report	For processing-only clients, all transactional messages generated within the specified time frame Note This report will be deprecated as of March 31, 2026 and is replaced by the Clearing Activity Report. For migration support, contact your account manager or request support.
Issuing: Settlement Summary Report	For processing-only clients, aggregated settlement amounts for all transactions within the specified time frame Note This report will be deprecated as of March 31, 2026 and is replaced by the Clearing Summary Report. For migration support, contact your account manager or request support.
Payments Report	All payment actions within the specified time frame, including refunds
Payouts Report	All payouts and related fees within the specified time frame, which you can use for reconciliation and settlements
Real Time Account Updater Report	All updates to cards made by the Real-Time Account Updater service within the specified time frame
Reported Fraudulent Transactions Report	All reported fraudulent transactions within the specified time frame
Retrievals Report	All retrieval requests within the specified time frame, which you can use to manage disputes
Settlement Breakdown Report	All financial activity that makes up your settlement, which you can use for reconciliation and settlements
Settlement Statement	An overview of your settlement, summarizing related financial activity (for example, payments, refunds, chargebacks, and fees), which you can use for reconciliation and settlements

Reports can contain a maximum of 1 million rows per CSV file. If the volume of data is greater than that, the report is split into multiple files of up to 1 million rows each.

Split files include a number at the end of the filename. For example, if a Financial Actions by Date Range Report contains 2.4 million rows, the following files are created:

financial-actions_{Entity ID}_{Start Date:YYYYMMDD}_{End Date:YYYYMMDD}_1.csv
financial-actions_{Entity ID}_{Start Date:YYYYMMDD}_{End Date:YYYYMMDD}_2.csv
financial-actions_{Entity ID}_{Start Date:YYYYMMDD}_{End Date:YYYYMMDD}_3.csv

All Checkout.com reports are available on demand or on schedule in the Dashboard.

To generate and download reports, you need one of the following user roles:

Admin
Custom role with the View and generate payment reports permission
Developer
Disputes manager
Read only
Risk manager
Support manager

Go to Reports > Dashboard reports.
Select Create report.
On the Generate report page, under:
- Report type, select the relevant report.
- Entity, select the required entity.
- Time zone, select either UTC or the Dashboard time zone (your local time).
Under Report details, use the Covered period calendar to select the date range to be covered in the report.
In the File name box, edit the file name if required. This may help you find the report later.
Under Customize included fields, select the fields you want to include in the report. Some of the fields are preselected by default. You can choose to select more fields or select all the fields.
Select Create.
The Dashboard reports page opens listing all generated reports, which you can filter by Report type, _Generated type, or Entity. You can also search for a report by Report type.
Select the Download icon next to the report to download it as a CSV file.

Information

Reports that contain a lot of data may take a while to generate.

You can use the Reports API to retrieve your reports programmatically at your chosen interval. For example, daily, weekly, or monthly. You can also automate reconciliation.

The following endpoints are available:

Endpoint name	Description
Get all reports	Returns a list of all your reports and their details
Get report details	Returns a specific report by passing its `id`
Get report file	Returns a specific file from a paginated report by passing the report `id` and the `fileId`

Reports are available in CSV format using Secure File Transfer Protocol (SFTP).

To set up access to your reports:

Contact your account manager or request support.
You must:
- Provide Checkout.com with an OpenSSH RSA public key.
- Create and securely store a private key.
- Specify the reports you want to receive, how often, and any filters you want applied.
We then give you:
- An SFTP server
- A port
- A username
- Access to your private key

In your command line, run the following command to create the key pair:
ssh-keygen -t rsa -b 4096 -f "checkout-sftp"
This generates two files:
- checkout-sftp.pub – The public key you need to share with Checkout.com
- checkout-sftp – Your private key for accessing your SFTP client
To retrieve the public key using the command line:
- For macOS or Linux, run cat.
- For Windows, run more.
  Alternatively, use your system's file explorer.
Send the public key to your account manager or request support.
Use the private key as a credential to sign in to your SFTP client.

Information

We recommend that you encrypt your secret key using the AES-256 cipher.

For targeted insight and efficient processing, you can pre-filter some scheduled reports by a single field and send them to specific recipients via SFTP. For example, pre-filter by issuing country and send each country's data to the relevant owner.

You can pre-filter the following reports:

You can create a report schedule to automatically generate reports at a specified frequency.

You can choose to receive the reports either in the Dashboard, or your SFTP server. If you choose to receive the reports in your SFTP server, you'll also be able to retrieve them using the Reports API.

Information

To schedule SFTP reports, ensure you configured an SFTP server and created a public and private key pair.

To create a report schedule:

Sign in to the Dashboard.
Go to Reports.
Open the Schedules tab.
Select Create schedule.
On the New schedule page under:
- Delivery type – Select if you want to create the report in the Dashboard, or delivered to your SFTP server.
- Time zone – Select either UTC or the Dashboard time zone (your local time).
- Report details – Under Frequency, select to generate the report Daily, Weekly, or Monthly.
  Optionally, provide a name for the schedule in Schedule name.
Under Customize included fields, select the fields you want to include in the report.
Select Create.
The Reports page opens listing all generated scheduled reports, which you can filter by Name, Status, or Type and search by keyword.

You can set up a webhook to receive scheduled reports when they are generated. For guidance, see:

Set up your webhook receiver
report_generated event reference

Retrieve reports

Reports overview

Note

Note

Note

Note

Note

Pagination

Generate reports in the Dashboard

Information

Retrieve reports using the API

Access reports using SFTP

Create a public and private key pair

Information

Pre-filter reports

Schedule reports

Information

Receive reports using webhooks