Tools-2 icon

AccountUpdater request file

The structure of a batch request file from the Account Updater is as follows.

AccountUpdater lines

The line record [L] holds the metadata information that applies to its corresponding sub-line [SL] records.

Field #

Format

Required

Description

1

Fixed value: L

-white_check_mark-

Record type identifier.

2

Numeric

-white_check_mark-

L line record number reference within the batch file block it belongs to.The counter starts at 1, and it increments sequentially by one unit.

3

Fixed value: MerchantAccount

-white_check_mark-

Account type.
Defines the type of account the transactions are related to.

4

Alphanumeric

-white_check_mark-

Specifies the merchant account name.

5

Fixed value: AccountUpdater  

-white_check_mark-

Processing type.
Defines the type of action that is required for the specified transaction.

If the column shows ValidationError, then the file shall have the structure of the batch result file (ValidationError) instead.

6

Alphanumeric

-white_check_mark-

A merchant reference, that is, a unique identifier associated to a specific transaction.

7

Alphanumeric

-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.

AccountUpdater sub-lines

There are two kinds of Account Updater requests: AccountUpdaterRecurring request and AccountUpdaterSingle request.

AccountUpdaterRecurring request

You can make an AccountUpdaterRecurring request when no payment details for the shopper are available.
The AccountUpdaterRecurring request stores shopper payment details in a recurring contract.

Mandatory sub-lines

Field #

Format

Required

Description

1

Fixed value: SL

-white_check_mark-

Record type identifier

2

Numeric

-white_check_mark-

`SL` sub-line record number reference within its parent line.
The counter starts at 1, and it increments sequentially by one unit.

3

Fixed value: AccountUpdaterRecurring

-white_check_mark-

Transaction type.
Defines the required field types for the specific sub-line.

4

Alphanumeric

-white_check_mark-

A shopper's reference, which is the unique identifier for a shopper.

5

Allowed values:

  • If the card details are not stored - The card alias
  • If the card details are stored:
    • recurringDetailReference Or
    • LATEST

-white_check_mark-

Allowed values:

  • If the card details are not stored - The card alias
  • If the card details are stored:

    • recurringDetailReference Or
    • LATEST

Example

FH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,AccountUpdater,FileHeaderEchoData
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,AccountUpdater,MerchantReference1,EchoData1
SL,1,AccountUpdaterRecurring,s.hopper@email.com,LATEST
BT,1
FT,1

AccountUpdaterSingle request

You can make an AccountUpdaterSingle request when the shopper's card details are at least partially available in your records.

You can send live/actual card numbers with your batch file only if you encrypt the file with PGP before submitting it.

Mandatory sub-lines

This sub-line holds information about single, ad-hoc account update requests.

Field #

Format

Required

Description

1

Fixed value: SL

-white_check_mark-

Record type identifier

2

Numeric

-white_check_mark-

`SL` sub-line record number reference within its parent line.
The counter starts at 1, and it increments sequentially by one unit.

3

Fixed value: AccountUpdaterSingle

-white_check_mark-

Transaction type.
Defines the required field types for the specific sub-line.

4

Alphanumeric

-white_check_mark-

Card number or card alias.

5

Numeric

-white_check_mark-

Expiry month.

  • Format: MM, zero-padded (eg: 03)

6

Numeric

-white_check_mark-

Expiry year.

  • Format: YYYY (eg: 2016)

7

Numeric

-x-

CVC code.
Leave this field blank.

8

Alphanumeric

-white_check_mark-

Cardholder name.

9

Numeric

-x-

Start month.

  • Format: MM, zero-padded (eg: 03)

Maestro UK only.

10

Numeric

-x-

Start year.

  • Format: YYYY (eg: 2016)

Maestro UK only.

11

Numeric

-x-

One-digit card issue number.

Maestro UK only.

Example

FH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,AccountUpdater,FileHeaderEchoData
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,AccountUpdater,MerchantReference1,EchoData1
SL,1,AccountUpdaterSingle,4111111111111111,06,2016,,CardHolderName,,,
BT,1
FT,1