You can connect to our SSH File Transfer Protocol (SFTP) servers to get reports. When SFTP is set up for your account, you can access your SFTP directory to retrieve reports, or submit batch data.
Keep in mind that an SFTP connection requires a higher degree of technical knowledge and further development resources. You can download reports automatically without using SFTP.
Requirements
Before you begin, take into account the following requirements, limitations, and preparations.
| Requirement | Description |
|---|---|
| Integration type | All Adyen integrations. |
| Customer Area roles | Make sure that you have the following role(s)
|
| Limitations | The SFTP server gives you access to all the reports generated for your company. You cannot restrict access to reports from specific merchant accounts or sub-merchant accounts. |
| Setup steps | Before you begin:
|
Set up your SFTP server access
Contact our Support Team with a request to create a SFTP directory where you can access your reports. Include the following information in your request:
- Your Customer Area company account.
- Your source IP addresses: The IP addresses of the servers from which you want to access the SFTP server. Make sure that these are external IP addresses, and that the allowlisted IP range is static. For available options, refer to the documentation of your provider:
- Your public SSH key: The length of your SSH key must be 2048 bits or 4096 bits.
- Request to disable re-sync (Optional): By default, all reports that you subscribe to are synchronized to your SFTP folder. Enabling this option will prevent reports from being re-synchronized after they have been deleted.
You will receive a response from Support when your SFTP server is configured and ready for you to access from your source IP addresses.
Connect to the SFTP server
Use the details below to connect to the relevant SFTP server.
If you have issues connecting to the SFTP server, check out the troubleshooting steps.
Test
To connect to the test SFTP server, use:
- Host:
sftp-test.adyen.com - Port:
5892 - User: the user provided to you by Support. For example,
sftpreport_123456@Company.YOUR_COMPANY_ACCOUNT. - Allowlist IP:
213.52.172.120
Live
To connect to the live SFTP server from all regions except of India, use:
- Host:
sftp-live.adyen.com - Port:
5631 - User: the user provided to you by Support. For example,
sftpreport_123456@Company.YOUR_COMPANY_ACCOUNT. - Allowlist IP:
82.199.87.148
India live
If you process live payments in India, you need to connect to the India-specific SFTP to comply with data localization requirements. To connect to the India live SFTP server, use:
- Host:
sftp-live-in.adyen.com - Port:
5631 - User: the user provided to you by Support. For example,
sftpreport_123456@Company.YOUR_COMPANY_ACCOUNT. - Allowlist IP:
147.12.20.251
Directory structure
Your SFTP directory is configured for your company account. Adyen will create a subdirectory for each of your merchant accounts and sub-merchant accounts, after they have generated their first report.
Reports for company accounts are located in the root directory. Reports for merchant accounts and sub-merchant accounts are located in directories corresponding to their names.
The SFTP directory only contains reports that were generated after you set it up. To include reports that were generated before you set up your SFTP connection, regenerate them in your Customer Area.
The reports in your SFTP directory are also visible in your Customer Area, unless you have write access and delete them from your SFTP directory.
The following table shows the directory structure:
| Directory | Structure |
|---|---|
| Company account directory | /REPORT_NAME.csv.gz |
| Merchant account directory | ./YOUR_COMPANY_ACCOUNT/YOUR_MERCHANT_ACCOUNT/REPORT_NAME.csv.gz |
| Sub-merchant account directory | ./YOUR_COMPANY_NAME/YOUR_MERCHANT_NAME/YOUR_SUB_MERCHANT_NAME/REPORT_NAME.csv.gz |