Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...

  Documentation

Header and trailer

Header and trailer fields:

File

A batch file should be enclosed by a File Header and a File Trailer lines.

Field Number Format Required Description

1

Fixed value: FH

-white_check_mark-

Record type identifier

2

Alphanumeric

 

-white_check_mark-

Merchant account name

3

Numeric

-white_check_mark-

File submission number

4

Fixed value: FH

-white_check_mark-

End-of-record type identifier

Trailer

Field Number Format Required Description

1

Fixed value: FT

-white_check_mark-

Record type identifier

2

Alphanumeric

-white_check_mark-

Merchant account name

3

Numeric

-white_check_mark-

File submission number

4

Numeric

-white_check_mark-

Number of blocks in file

5

Fixed value: FT

-white_check_mark-

End-of-record type identifier

Example

FH,TestMerchant,201,FH
...
...
FT,TestMerchant,201,1,FT 

Block

A batch file can contain one or more blocks that are defined by a block header and a block trailer. A block groups a number of line items per currency.

Header

Field Number Format Required Description

1

Fixed value: BH

-white_check_mark-

Record type identifier

2

Alphanumeric

-white_check_mark-

Merchant account name

3

Numeric

-white_check_mark-

File submission number

4

Numeric

-white_check_mark-

Block number started at 1 and incremented by 1

5

Fixed value: BH

-white_check_mark-

End-of-record type identifier

Trailer

Field Number Format Required Description

1

Fixed value: BT

-white_check_mark-

Record type identifier

2

Alphanumeric

-white_check_mark-

Merchant account name

3

Numeric

-white_check_mark-

File submission number

4

Numeric

-white_check_mark-

Block number same as the one defined in Block Header

5

Numeric

-white_check_mark-

Number of lines records in block

6

Numeric

-white_check_mark-

Sum of the line item amounts in block

7

Alphabetic

[A-Z]{3}

-white_check_mark-

The three-character ISO currency code.

8

Fixed value: BT

-white_check_mark-

End-of-record type identifier

Example

FH,TestMerchant,201,FH
BH,TestMerchant,201,1,BH
...
BT,TestMerchant,201,1,3,4398,EUR,BT
BH,TestMerchant,201,2,BH
...
BT,TestMerchant,201,2,8,2560,USD,BT
FT,TestMerchant,201,2,FT