Retrieve reports
Last updated: April 2, 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 |
|---|---|
All authentications during the selected timeframe | |
All financial activity impacting your available balance during the selected timeframe, which you can use for balance management and reconciliation | |
All your balances during the selected timeframe, which you can use for balance management and reconciliation | |
All successful and declined bank payouts during the selected timeframe | |
All successful and declined card payouts during the selected timeframe | |
All disputes raised with you during the selected timeframe | |
Available in the Dashboard only | All fees and taxes charged to your Checkout.com account during the selected timeframe, including card scheme, Interchange, and Checkout.com fees |
All financial actions during the selected timeframe that impacted your currency account's available balance, which you can use for balance management and reconciliation | |
All financial actions for a specific payout, which you can use for reconciliation and settlements | |
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 | |
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 | |
All authorization, reversal, and advice messages during the selected timeframe | |
Information about all your issued cards during the selected timeframe | |
All chargebacks raised after a dispute during the selected timeframe | |
Lifecycle events for all disputes processing-only clients raised with merchants on issued cards | |
All presentments raised after a dispute during the selected timeframe | |
Issuing: Quarterly Mastercard Report (QMR) Available in the Dashboard only | Operational metrics that processing-only clients must send to Mastercard every quarter |
All transactional messages generated for processing-only clients during the selected timeframe | |
Aggregated settlement amounts for all transactions for processing-only clients during the selected timeframe | |
All payment actions during the selected timeframe, including refunds | |
All payouts and related fees during the selected timeframe, which you can use for reconciliation and settlements | |
All updates to cards made by the Real-Time Account Updater service during the selected timeframe | |
All reported fraudulent transactions during the selected timeframe | |
All retrieval requests during the selected timeframe, which you can use to manage disputes | |
All financial activity that makes up your settlement, which you can use for reconciliation and settlements | |
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.csvfinancial-actions_{Entity ID}_{Start Date:YYYYMMDD}_{End Date:YYYYMMDD}_2.csvfinancial-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:
- Go to Reports > All reports.
- If this is your first report, select Generate reports.
- If you have already generated reports, select New report.
- If this is your first report, select Generate reports.
- On the New report page under:
- Create your report – From the Select type dropdown, select the relevant report.
- Time zone – Select either UTC or the Dashboard time zone (your local time).
- To generate the report now and/or on a schedule, select the relevant heading:
- Now – From the Covered period calendar, select the date range for the report to cover.
If you want to edit the file name, enter your changes in the File name box. This may help you find the report later. - Scheduled – Under Frequency, select to generate the report Daily, Weekly, or Monthly.
If you want to edit the schedule name, enter your changes in the Schedule name box.
- Now – From the Covered period calendar, select the date range for the report to cover.
- Under Customize included fields, select the fields you want to include in the report.
- Select Generate report.
The All reports page opens listing all generated reports, which you can filter by Name, Status, or Type and search by keyword. - To download the relevant CSV file, select the Download icon on that row.
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 |
|---|---|
Returns a list of all your reports and their details | |
Returns a specific report by passing its | |
Returns a specific file from a paginated report by passing the report |
Reports are available in CSV format using Secure File Transfer Protocol (SFTP).
To set up access to your reports:
- Contact your account manager or [email protected].
- 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.comcheckout-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.
- For macOS or Linux, run
- Send the public key to your account manager or [email protected].
- 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 set up a webhook to receive scheduled reports when they are generated. For guidance, see:
- Set up your webhook receiver
- report_generated event reference