---
title: "AccountUpdater request file"
url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/accountupdater-request-file"
source_url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/accountupdater-request-file.md"
canonical: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/accountupdater-request-file"
last_modified: "2019-10-21T13:05:00+02:00"
language: "en"
---

# AccountUpdater request file

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

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-](/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-") | `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-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Account type. Defines the type of account the transactions are related to.                                                                                                                                                                                                                                                                                   |
| 4           | Alphanumeric                    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Specifies the merchant account name.                                                                                                                                                                                                                                                                                                                         |
| 5           | Fixed value: `AccountUpdater`   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-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)](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file/modification-result-file-validationerror) instead. |
| 6           | Alphanumeric                    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A merchant reference, that is, a unique identifier associated to a specific transaction.                                                                                                                                                                                                                                                                     |
| 7           | 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.                                                                                        |

## 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](/online-payments/classic-integrations/classic-api-integration/tokenization).

### Mandatory sub-lines

| Field # | Format                                                                                                                                                  | Required                                                                                    | Description                                                                                                                                             |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Fixed value: `SL`                                                                                                                                       | ![-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-") | \`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-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Transaction type. Defines the required field types for the specific sub-line.                                                                           |
| 4       | Alphanumeric                                                                                                                                            | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-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:

  * recurring`DetailReference` Or
  * `LATEST` | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Allowed values:- If the card details are not stored - The card alias

- If the card details are stored:

  * recurring`DetailReference` Or
  * `LATEST` |

### Example

```text
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](/development-resources/batch-processing/advanced-sftp-batch-files#pgp-encryption) 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-](/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-") | \`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-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Transaction type. Defines the required field types for the specific sub-line.                                                        |
| 4           | Alphanumeric                        | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Card number or card alias.                                                                                                           |
| 5           | Numeric                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Expiry month.- Format: `MM`, zero-padded (eg: *03*)                                                                                  |
| 6           | Numeric                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Expiry year.- Format: `YYYY` (eg: *2016*)                                                                                            |
| 7           | Numeric                             | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | [CVC code](https://www.cvvnumber.com/cvv.html). Leave this field blank.                                                              |
| 8           | Alphanumeric                        | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Cardholder name.                                                                                                                     |
| 9           | Numeric                             | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | Start month.- Format: `MM`, zero-padded (eg: *03*)Maestro UK only.                                                                   |
| 10          | Numeric                             | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | Start year.- Format: `YYYY` (eg: *2016*)Maestro UK only.                                                                             |
| 11          | Numeric                             | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | One-digit card issue number.Maestro UK only.                                                                                         |

### Example

```text
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
```
