You can generate balance platform reports automatically according to a specific schedule, or manually on-demand.
Requirements
Requirement | Description |
---|---|
API credential roles | To Download reports make sure that you have the following role:
|
Customer Area roles | Make sure that you have the following roles:
|
Webhooks | Subscribe to the following webhook(s): |
Generate reports
You can manually generate reports anytime in the Customer Area. Some reports have additional options, such as generating in bulk, selecting a date range, or filtering.
- Log in to your Customer Area and make sure you are on the correct merchant account.
- Go to Reports.
- Select the name of the report you want to generate
- Select Manage report.
- Select Manual (one time usage).
- (Optional) Depending on the report type, select:
- Bulk to generate multiple reports.
- The date or time period that the report should cover.
- The balance account and/or account holder to filter the report on.
- The time zone that you want to base the report on.
- Select Generate report.
Generating a report can take up to a few minutes.
Get updates when a report is available
To get updates when a balance platform report is generated and available for download, listen to the balancePlatform.report.created webhook. The webhook contains the URL at which you can download the report.
{ "data": { "balancePlatform": "YourBalancePlatform", "creationDate": "2022-01-02T02:01:08+02:00", "id": "balanceplatform_balance_report_2022_01_01.csv", "downloadUrl": "https://balanceplatform-test.adyen.com/balanceplatform/reportDownload/v1/YourBalancePLatform/balanceplatform_balance_report_2022_01_01.csv", "reportType": "balanceplatform_balance_report", "fileName": "balanceplatform_balance_report_2022_01_01.csv" }, "environment": "test", "type": "balancePlatform.report.created" }
Download reports
All reports are generated in CSV format. You can also generate the Accounting report in TSV format. We recommend that you create a script to load the reports and reconcile into your systems. Alternatively, you can use any spreadsheet software to open the file and reconcile manually.
You can download reports manually from your Customer Area, or programmatically by making an HTTP GET request.
You can download all generated balance platform reports from the Reports page of your Customer Area.
To download reports manually:
- Log in to your Customer Area and make sure you are on the correct merchant account.
- Go to Reports.
- Select the name of the report type you want to download.
- In the Generated reports table, select the arrow in the Download column of the specific report you want to download.