{"title":"Batch result file","category":"default","creationDate":1697794920,"content":"

You can get the batch result file two days after receiving the batch acknowledgement (ACK) file<\/a> with a successful validation.<\/p>\n

The following fields are included in all batch result files:<\/p>\n

File Header\u00a0[FH]<\/h3>\n

The File Header\u00a0[FH] record\u00a0contains the data that was passed in the batch request file header<\/a>.<\/p>\n

Field #<\/p><\/th>

Format<\/p><\/th>

Description<\/p><\/th><\/tr><\/thead>

\n

1<\/p>\n<\/td>

\n

Fixed value: FH<\/code><\/p>\n<\/td>

\n

Record type identifier.<\/p>\n<\/td><\/tr>

\n

2<\/p>\n<\/td>

\n

Fixed value: 1.0<\/code><\/p>\n<\/td>

\n

Version number.
This field enables version control for the release of future enhancements for batch processing.<\/p>\n<\/td><\/tr>

\n

3<\/p>\n<\/td>

\n

Allowed values:

  • TEST<\/code><\/li>
  • LIVE<\/code><\/li><\/ul><\/p>\n<\/td>
\n

It specifies the environment: either test or live\/production.<\/p>\n<\/td><\/tr>

\n

4<\/p>\n<\/td>

\n

Allowed values:<\/p>\n

    \n
  • MerchantAccount<\/code><\/li>\n
  • Company<\/code><\/li>\n<\/ul>\n<\/td>
\n

Account type, as submitted in the request file<\/a>.<\/p>\n<\/td><\/tr>

\n

5<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

The merchant or the company account name, as submitted in the request file<\/a>.<\/p>\n<\/td><\/tr>

\n

6<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

The submission platform<\/a> value provided in the request file<\/a>.<\/p>\n<\/td><\/tr>

\n

7<\/p>\n<\/td>

\n

Numeric<\/p>\n<\/td>

\n

The file sequence number<\/a> value provided in the request file<\/a>.<\/p>\n<\/td><\/tr>

\n

8<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

The API credential name specified to upload the file to the SFTP.
For example: strong>ws@Company.<\/strong<\/a><\/span>[YourCompanyAccount]<\/strong><\/p>\n<\/td><\/tr>

\n

9<\/p>\n<\/td>

\n

Allowed values:

\n

The file type<\/a> value provided in the request file<\/a>.<\/p>\n<\/td><\/tr>

\n

10<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

The file\u00a0header\u00a0EchoData<\/code>\u00a0value\u00a0provided in the corresponding\u00a0request file<\/a>. If you do not pass any value in the corresponding field in the\u00a0request\u00a0file, this field is blank.\u00a0<\/p>\n<\/td><\/tr><\/tbody><\/table>\n

File Trailer [FT]<\/h3>\n

The File Trailer\u00a0[FT] record specifies the number of blocks in the file.<\/p>\n\n\n\n\n\n\n
Field #<\/th>\nFormat<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nFixed value: FT<\/code><\/td>\nRecord type identifier<\/td>\n<\/tr>\n
2<\/td>\nNumeric<\/td>\nNumber of blocks in the file.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Block Header [BH]<\/h3>\n

The Block Header\u00a0[BH] record specifies the information that was passed in the batch request block header.<\/p>\n<\/colgroup>

Field #<\/p><\/th>

Format<\/p><\/th>

Description<\/p><\/th><\/tr><\/thead>

\n

1<\/p>\n<\/td>

\n

Fixed value: BH<\/code><\/p>\n<\/td>

\n

Record type identifier<\/p>\n<\/td><\/tr>

\n

2<\/p>\n<\/td>

\n

Numeric<\/p>\n<\/td>

\n

Block number.
\nIts value increments sequentially by one unit per block.<\/p>\n<\/td><\/tr>

\n

3<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

The block\u00a0header\u00a0EchoData<\/code>\u00a0value\u00a0provided in the corresponding\u00a0request file<\/a>. If you do not pass any value in the corresponding field in the\u00a0request\u00a0file, this field is blank.\u00a0<\/p>\n<\/td><\/tr><\/tbody><\/table>\n

Block Trailer [BT]<\/h3>\n

The Block Trailer\u00a0[BT] record specifies the number of lines in the block.<\/p>\n\n\n\n\n\n\n
Field #<\/th>\nFormat<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nFixed value: BT<\/code><\/td>\nRecord type identifier<\/td>\n<\/tr>\n
2<\/td>\nNumeric<\/td>\nNumber of line records in the block.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
FH,1.0,TEST,MerchantAccount,TestCompany,Default,1,ws@Company.TestCompany,Authorisation,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\n...\nBT,5\nFT,1<\/code><\/pre>","url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file","articleFields":{"id":"24216668","type":"page","_expandable":{"operations":""},"status":"current","feedback_component":true,"filters_component":false,"page_id":"f6279c58-2052-4177-91d7-222a2795cf63","last_edit_on":"20-10-2023 11:42"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file","title":"Batch result file","content":"You can get the batch result file two days after receiving the batch acknowledgement (ACK) file with a successful validation.\nThe following fields are included in all batch result files:\nFile Header\u00a0[FH]\nThe File Header\u00a0[FH] record\u00a0contains the data that was passed in the batch request file header.\nField #FormatDescription\n1\n\nFixed value: FH\n\nRecord type identifier.\n\n2\n\nFixed value: 1.0\n\nVersion number. This field enables version control for the release of future enhancements for batch processing.\n\n3\n\nAllowed values:TESTLIVE\n\nIt specifies the environment: either test or live\/production.\n\n4\n\nAllowed values:\n\nMerchantAccount\nCompany\n\n\nAccount type, as submitted in the request file.\n\n5\n\nAlphanumeric\n\nThe merchant or the company account name, as submitted in the request file.\n\n6\n\nAlphanumeric\n\nThe submission platform value provided in the request file.\n\n7\n\nNumeric\n\nThe file sequence number value provided in the request file.\n\n8\n\nAlphanumeric\n\nThe API credential name specified to upload the file to the SFTP.  For example: strong>ws@Company.<\/strong[YourCompanyAccount]\n\n9\n\nAllowed values:AuthorisationPayoutRefundWithDataModificationPayoutModificationAccountUpdater\n\nThe file type value provided in the request file.\n\n10\n\nAlphanumeric\n\nThe file\u00a0header\u00a0EchoData\u00a0value\u00a0provided in the corresponding\u00a0request file. If you do not pass any value in the corresponding field in the\u00a0request\u00a0file, this field is blank.\u00a0\n\nFile Trailer [FT]\nThe File Trailer\u00a0[FT] record specifies the number of blocks in the file.\n\n\n\nField #\nFormat\nDescription\n\n\n\n\n1\nFixed value: FT\nRecord type identifier\n\n\n2\nNumeric\nNumber of blocks in the file.\n\n\n\nBlock Header [BH]\nThe Block Header\u00a0[BH] record specifies the information that was passed in the batch request block header.\nField #FormatDescription\n1\n\nFixed value: BH\n\nRecord type identifier\n\n2\n\nNumeric\n\nBlock number.\nIts value increments sequentially by one unit per block.\n\n3\n\nAlphanumeric\n\nThe block\u00a0header\u00a0EchoData\u00a0value\u00a0provided in the corresponding\u00a0request file. If you do not pass any value in the corresponding field in the\u00a0request\u00a0file, this field is blank.\u00a0\n\nBlock Trailer [BT]\nThe Block Trailer\u00a0[BT] record specifies the number of lines in the block.\n\n\n\nField #\nFormat\nDescription\n\n\n\n\n1\nFixed value: BT\nRecord type identifier\n\n\n2\nNumeric\nNumber of line records in the block.\n\n\n\nFH,1.0,TEST,MerchantAccount,TestCompany,Default,1,ws@Company.TestCompany,Authorisation,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\n...\nBT,5\nFT,1","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Development resources","lvl2":"Batch processing","lvl3":"Submit transaction batch files through SFTP","lvl4":"Batch result file"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/development-resources","lvl2":"https:\/\/docs.adyen.com\/development-resources\/batch-processing","lvl3":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files","lvl4":"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file"},"levels":5,"category":"Development Resources","category_color":"green","tags":["Batch","result"]}}