---
title: "Batch acknowledgement file"
url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-acknowledgement-file"
source_url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-acknowledgement-file.md"
canonical: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-acknowledgement-file"
last_modified: "2019-04-29T16:55:00+02:00"
language: "en"
---

# Batch acknowledgement file

[View source](/development-resources/batch-processing/advanced-sftp-batch-files/batch-acknowledgement-file.md)

We describe the fields included in the [batch acknowledgment (ACK) file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-file-naming-and-structure).

After validating the submitted batch request file, an ACK file generates:

* If the batch request file successfully passes the validation check, the ACK file provides a report overview of the processed data.
* If one or more lines in the requested file do not pass the validation check, they are included in the generated ACK file so you can review them.

## ACK - Validation successful

After receiving a batch request file, the Adyen payments platform carries out a series of validation checks. If all validation checks are successful, a batch acknowledgment (ACK) file generates and returns with the fields described below.

```text
FH,1.0,TEST,Company,TestCompany,CaptureOverAuthAmount,1,ws@Company.TestCompany,Modification,EchoData_BatchAck
R,2,8
N,NextFileSubmissionNumber,2
```

#### File Header \[FH]

The File Header \[FH] record marks the start of the ACK file.

| Field # | Format                                                                                                                    | Description                                                                                                                                                                                                                                                           |
| ------- | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Fixed value: `FH`.                                                                                                        | Record type identifier.                                                                                                                                                                                                                                               |
| 2       | Numeric                                                                                                                   | Version number. This field enables version control for the release of future enhancements for batch processing.                                                                                                                                                       |
| 3       | Allowed values:- `TEST`
- `LIVE`                                                                                          | It specifies the environment: either test or live/production.                                                                                                                                                                                                         |
| 4       | Fixed value: `Company`                                                                                                    | Account type.                                                                                                                                                                                                                                                         |
| 5       | Alphanumeric                                                                                                              | Specifies the company account name.                                                                                                                                                                                                                                   |
| 6       | Alphanumeric                                                                                                              | Submission platform. The value specified in the file should match the corresponding value in the file name.                                                                                                                                                           |
| 7       | Numeric                                                                                                                   | File sequence number. The value specified in the file should match the corresponding value in the file name.                                                                                                                                                          |
| 8       | Alphanumeric                                                                                                              | The username of the API credential linked to your Adyen company account.                                                                                                                                                                                              |
| 9       | Allowed values:- `Authorisation`
- `Payout`
- `RefundWithData`
- `Modification`
- `PayoutModification`
- `AccountUpdater` | File type. Defines the type of transactions that are submitted for further processing.                                                                                                                                                                                |
| 10      | Alphanumeric                                                                                                              | `EchoData` In this field you can specify any data you may want to be returned with the result file. When this field is populated, its content is returned exactly as is. The Adyen payments platform does not use this data. Maximum character length: 80 characters. |

#### Record Line \[R]

The File Trailer record specifies the number of blocks and lines in the ACK file.

| Field # | Format           | Description                       |
| ------- | ---------------- | --------------------------------- |
| 1       | Fixed value: `R` | Record type identifier.           |
| 2       | Numeric          | Number of processed blocks.       |
| 3       | Numeric          | Number of processed line records. |

#### Next File Submission Number \[N]

This line specifies the number of the next file to process in a batch submission sequence. File sequence numbers are associated with the submission platform the files originate from, and they sequentially increment by one unit after each successful file submission.

The `NextFileSubmissionNumber` sub-line is always included in an ACK file, regardless of the file validation outcome:

* When a file in a batch process is submitted successfully and without errors, the submission number for the next file in the process increases sequentially.

* When a file in a batch process contains errors, the system tries to guess the submission number for the next file in the sequence. Therefore, this value may be incorrect.

A correct file in a batch submission process satisfies the following minimum requirements:

* The file name adheres to the naming conventions for batch acknowledgement files (ACK).

* The file data matches the expected data type and format.

The submission number is always incorrect when it is not possible to read or parse the header of a file. This can happen in the following cases:

* The file sequence number is missing or it is incorrectly formatted in the file name.

* The submission platform name is missing or it is incorrectly formatted in the file name.

* A database exception might occur during file insertion.

| Field # | Format                                  | Description                                                                    |
| ------- | --------------------------------------- | ------------------------------------------------------------------------------ |
| 1       | Fixed value: `N`                        | Record type identifier                                                         |
| 2       | Fixed value: `NextFileSubmissionNumber` | Record content definition.                                                     |
| 3       | Numeric                                 | The number corresponding to the next expected file in the submission sequence. |

## ACK - Validation failed

When one or more validation errors occur, an error line gets generated per line in the requested file that did not pass validation.

```text
E,L,5,5000,Invalid Merchant Account 
E,L,6,5000,Invalid Merchant Account 
N,NextFileSubmissionNumber,2
```

#### Error Line \[E]

The File Header record contains marks the start of the ACK file.

| Field # | Format                                   | Description                                                                                                                                                                                                                                                    |
| ------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Fixed value: `E`                         | Record type identifier                                                                                                                                                                                                                                         |
| 2       | Allowed values:- `FH`
- `L`
- `SL`
- `F` | The record type where the error occurred:- `FH`: the error occurred in the *file header*.
- `L`: the error occurred in a *line* record.
- `SL`: the error occurred in a *sub-line* record.
- `F`: the error occurred as the file was incomplete or unreadable. |
| 3       | Numeric                                  | The file line number where the error occurred.                                                                                                                                                                                                                 |
| 4       | Numeric                                  | The error code associated with the error.                                                                                                                                                                                                                      |
| 5       | Alphanumeric                             | The error description.                                                                                                                                                                                                                                         |

#### Next File Submission Number \[N]

This line specifies the number of the next file to process in a batch submission sequence. File sequence numbers are associated with the submission platform the files originate from, and they sequentially increment by one unit after each successful file submission.

The `NextFileSubmissionNumber` sub-line is always included in an ACK file, regardless of the file validation outcome:

* When a file in a batch process is submitted successfully and without errors, the submission number for the next file in the process increases sequentially.

* When a file in a batch process contains errors, the system tries to guess the submission number for the next file in the sequence. Therefore, this value may be incorrect.

A correct file in a batch submission process satisfies the following minimum requirements:

* The file name adheres to the naming conventions for batch acknowledgement files (ACK).

* The file data matches the expected data type and format.

The submission number is always incorrect when it is not possible to read or parse the header of a file. This can happen in the following cases:

* The file sequence number is missing or it is incorrectly formatted in the file name.

* The submission platform name is missing or it is incorrectly formatted in the file name.

* A database exception might occur during file insertion.

| Field # | Format                                  | Description                                                                    |
| ------- | --------------------------------------- | ------------------------------------------------------------------------------ |
| 1       | Fixed value: `N`                        | Record type identifier                                                         |
| 2       | Fixed value: `NextFileSubmissionNumber` | Record content definition.                                                     |
| 3       | Numeric                                 | The number corresponding to the next expected file in the submission sequence. |
