You can generate Balance Platform reports automatically according to a specific schedule, or manually on-demand.
Step 1: Generate reports
- Log in to your Balance Platform Customer Area.
- Go to Reports.
- Next to the name of the report you want to generate, select Automatic generation.
- Turn on the Automatic generation toggle.
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 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"
}
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.
- Ask your Adyen contact for your report credentials. You must use your report credentials to authenticate your GET request.
- 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.
report_[123456]@BalancePlatform.YOUR_BALANCE_PLATFORM
: