Batch acknowledgement file

We describe the fields included in the batch acknowledgment (ACK) file.

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.

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.

Record Line [R]

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

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.

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.

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.

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.