---
title: "Batch request file"
url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file"
source_url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file.md"
canonical: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file"
last_modified: "2026-06-01T15:33:16+02:00"
language: "en"
---

# Batch request file

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

The following fields are common across all batch request files, regardless of the [transaction type](/development-resources/batch-processing/advanced-sftp-batch-files/batch-file-naming-and-structure) being submitted. They must be included in each batch request file.

```text
FH,1.0,TEST,Company,TestCompany,Default,2,ws@Company.TestCompany,Authorisation,FileHeaderEchoData
BH,1,BlockHeaderEchoData
...
BT,5
FT,1
```

#### File Header \[FH]

Contains information that is crucial to successfully process the batch file:

* It identifies the merchant account the transactions refers to;
* It specifies the [file submission number](/development-resources/batch-processing/advanced-sftp-batch-files/batch-file-naming-and-structure);
* It defines the [transaction type](/development-resources/batch-processing/advanced-sftp-batch-files/batch-file-naming-and-structure) that needs to be processed.

| Field # | Format                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Required                                                                                    | Description                                                                                                                                                                                                                                                             |
| ------- |   | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Fixed value: \`FH\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Record type identifier.                                                                                                                                                                                                                                                 |
| 2       | Fixed value: \`1.0\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Version number. This field enables version control for the release of future enhancements for batch processing.                                                                                                                                                         |
| 3       | Allowed values:* `TEST`

* `LIVE`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | It specifies the environment: either test or live/production.                                                                                                                                                                                                           |
| 4       | Fixed value: \`Company\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Account type.                                                                                                                                                                                                                                                           |
| 5       | Alphanumeric                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Specifies the company account name.                                                                                                                                                                                                                                     |
| 6       | Alphanumeric                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Submission platform. The value specified in the file should match the corresponding value in the file name.                                                                                                                                                             |
| 7       | Numeric                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | File sequence number. The value specified in the file should match the corresponding value in the file name.                                                                                                                                                            |
| 8       | Alphanumeric                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The username of the API credential linked to your Adyen company account.                                                                                                                                                                                                |
| 9       | Allowed values:* [Authorisation](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/authorisation-request-file)

* [Payout](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payout-request-file)

* [RefundWithData](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/refundwithdata-request-file)

* [Modification](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file)

* [PayoutModification](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payoutmodification-request-file)

* [AccountUpdater](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/accountupdater-request-file) | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | File type. Defines the type of transactions that are submitted for further processing.                                                                                                                                                                                  |
| 10      | Alphanumeric                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | \`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. |

#### File Trailer \[FT]

Specifies the number of blocks in the batch file.

| Field # | Format            | Required                                                                                    | Description                   |
| ------- | ----------------- | ------------------------------------------------------------------------------------------- | ----------------------------- |
| 1       | Fixed value: `FT` | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Record type identifier.       |
| 2       | Numeric           | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Number of blocks in the file. |

#### Block Header \[BH]

Notifies the Adyen payments platform about a new grouping of transactions that should be expected.

| Field #                                                  | Format            | Required                                                                                    | Description                                                                                                                                                                                                                                                           |
| -------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1                                                        | Fixed value: `BH` | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Record type identifier.                                                                                                                                                                                                                                               |
| 2                                                        | Numeric           | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Block number.                                                                                                                                                                                                                                                         |
| Its value increments sequentially by one unit per block. |                   |                                                                                             |                                                                                                                                                                                                                                                                       |
| 3                                                        | Alphanumeric      | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | `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. |

#### Block Trailer \[BT]

Specifies the number of lines in the block it refers to.

| Field # | Format            | Required                                                                                    | Description                          |
| ------- | ----------------- | ------------------------------------------------------------------------------------------- | ------------------------------------ |
| 1       | Fixed value: `BT` | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Record type identifier.              |
| 2       | Numeric           | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Number of line records in the block. |

After preparing the batch file as outlined above, you can upload it to the *in* sub-folder of your SFTP folder. The Adyen payments platform can then fetch the file and add it to the processing queue.
