Are you looking for test card numbers?

Would you like to contact support?

Issuin icon

Generate and download Balance Platform Reports

Learn how to generate and get Balance Platform reports.

You can generate Balance Platform reports automatically according to a specific schedule, or manually on-demand.

Step 1: Generate reports

To automatically generate reports:
  1. Log in to your Balance Platform Customer Area.
  2. Go to Reports.
  3. Next to the name of the report you want to generate, select Automatic generation.
  4. Turn on the Automatic generation toggle.
The schedule depends on the report type and your platform configuration. When a report is generated, Adyen sends a balancePlatform.report.created notification.

Step 2: 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 notification contains the URL at which you can download the report.

Example notification 
{
  "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"
}

Step 3: 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 programmatically by making an HTTP GET request, or manually from your Balance Platform Customer Area.

To download reports programmatically:
  1. Ask your Adyen contact for your report credentials. You must use your report credentials to authenticate your GET request.
  2. Download the report with an HTTP GET request. Include:
    • The name of your report API credential.
    • The basic authentication password for your report API credential.
    • The URL from the downloadUrl field in the balancePlatform.report.created notification.
Here is how you would download a Balance Report for the API credential report_[123456]@BalancePlatform.YOUR_BALANCE_PLATFORM:
Download a Balance Report 
$ wget --http-user='report_[123456]@BalancePlatform.YOUR_BALANCE_PLATFORM' \
--http-password='YOUR_PASSWORD' \
https:\/\/balanceplatform-test.adyen.com\/balanceplatform\/reportDownload\/v1\/YOUR_BALANCE_PLATFORM\/balanceplatform_balance_report_2022_01_31.csv