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 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. Select the name of the report you want to generate.

  4. Select Manage report.

  5. Select Automatic (schedule based).

    Keep the Automatic generation toggle selected. If you deselect this option, the schedule for generating reports is deleted.

  6. Select Close.

The schedule depends on the report type and your platform configuration. When a report is generated, Adyen sends a balancePlatform.report.created webhook.

Step 2: Get updates when a report is available

To get updates when a 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 
{
  "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 webhook.

Here is how to download a Balance Platform 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