No momento, esta página não está disponível em português
Adyen-for-platform icon

Get platform reports

Learn how to generate and download reports for your balance platform automatically or manually.

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:
  • Report service user API key with the BalancePlatform Report Download role
Customer Area roles Make sure that you have the following roles:
  • Download Balance Platform reports
  • Generate Balance Platform reports
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.

  1. Log in to your Customer Area and make sure you are on the correct merchant account.
  2. Go to Reports.
  3. Select the name of the report you want to generate
  4. Select Manage report.
  5. Select Manual (one time usage).
  6. (Optional) Depending on the report type, select:
    1. Bulk to generate multiple reports.
    2. The date or time period that the report should cover.
    3. The balance account and/or account holder to filter the report on.
    4. The time zone that you want to base the report on.
  7. 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.

Example webhook
Expand view
Copy link to code block
Copy code
Copy code
{
"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:

  1. Log in to your Customer Area and make sure you are on the correct merchant account.
  2. Go to Reports.
  3. Select the name of the report type you want to download.
  4. In the Generated reports table, select the arrow in the Download column of the specific report you want to download.