Account Updater result file

The Account Updater result file is encrypted if all of the following conditions are true:

The request file was encrypted.
There is a PGP key registered at your company-level, with the Purpose of AccountUpdater.

For more information on registering and managing PGP keys, see our PGP encryption documentation.
The result file contains a card number.

If the result file is not encrypted, then there will be no card number (PAN) in the file.

When parsing or validation errors occur, the result file has the structure described in batch result files with validation errors.

AccountUpdater line

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

Field #	Format	Description
1	Fixed value: `L`	Record type identifier.
2	Numeric	`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`	Account type. Defines the type of account the transactions are related to.
4	Alphanumeric	Specifies the merchant account name.
5	Allowed values: `ScheduleAccountUpdater` `AccountUpdaterAutoUpdate` `AccountUpdaterRealtime`	Specifies the requested transaction type: `ScheduleAccountUpdater`: returned when merchants submit a batch file request for account updates. `AccountUpdaterAutoUpdate`: returned when the account updater request is submitted via the Adyen automatic account updater service. This is not the same as the real time account updater service. `AccountUpdaterRealtime`: returned when the account updater request is submitted by Adyen real time account updater service in the authorisation.
6	Alphanumeric	A merchant reference, that is, a unique identifier associated to a specific transaction.
7	Allowed values: `Scheduled` `Error` `Success`	Transaction status. This field is not applicable when Field 5 is `AccountUpdaterRealtime` .
8	Alphanumeric	`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. This field is not applicable when Field 5 is `AccountUpdaterRealtime`.

AccountUpdater sub-line

Field #	Format	Description
1	Fixed value: `SL`	Record type identifier
2	Fixed value: `1`	`SL` sub-line record number reference within its parent line.
3	Allowed values: `AccountUpdaterResult` `AccountUpdaterAutoUpdateResult` `AccountUpdaterRealtimeResult`	`AccountUpdaterResult`: returned when merchants submit an batch file request for batch account updater. `AccountUpdaterAutoUpdateResult`: returned when the account updater request is submitted via the Adyen automatic account updater service or when the request is submitted via an API call. The automatic account updater service is not the same as the real time account updater service. When the result type is `AccountUpdaterAutoUpdateResult`, sub-line field #4 (see below) takes the PSP reference as a value. `AccountUpdaterRealtimeResult`: returned when the account updater request is submitted in real time in the authorisation request.
4	Alphanumeric	This value corresponds to the `pspReference` when [L] Line record field #5 is set to either `ScheduleAccountUpdater`, `AccountUpdaterAutoUpdate` or `AccountUpdaterRealtime`. It corresponds to the `merchantReference` when [SL] sub-line record field #3 is `AccountUpdaterResult`.
5	Allowed values: `Submitted` `Not Submitted`	The account update submission request status: `Submitted`: returned to inform you that the record was submitted and processed by the scheme. `Not Submitted`: returned to inform you that the request was not submitted. These values do not apply if [L] Line record field #5 is set to `AccountUpdaterRealtime`. The field is left blank in this scenario.
6	The sub-bullet items are the fields returned in the file. We categorize these fields into 6 groups represented by the bullet items. `NoChange`: `NoChange` `EitherExpiryChangedOrNoChange` `InvalidAmount` `TxInvalid` `RecordIdentifierInvalid` `BinNotParticipating` `CreditCardNumberInvalid` `CreditCardNumberNotFound` `IssuerNotSubscribed` `NoMatchFound` `UnknownResponseCodeProvided` `GenericTokenUseError` `InvalidCreditCard` `InvalidExpirationDate` `MerchantIsNotAuthorisedToUseTokens` `TokenIsInvalid` `TokenWasNotFound` `CloseAccount`: `CloseAccount` `CloseAccountThisAccountOnly` `PANChanged`: `CardChanged` `PANChanged` `CardExpiryChanged`: `CardExpiryChanged` `ContactCardAccountHolder`: `ContactCardAccountHolder` `Error`: `MerchantIdInvalid` `MerchantIdNotEnabled` `Error`	Account updater action result. You can check the description of the result groups below: `NoChange`: There is no change on the card. This value is not returned if Line record field 5 is set to `AccountUpdaterRealtime`. `CloseAccount`: The account has been permanently closed by the issuing bank. `PANChanged`: The account number has changed. In some cases, if the account number has changed, the expiry date has changed as well. `CardExpiryChanged`: The expiry date of the card has changed. `ContactCardAccountHolder`: (Visa only) The card has a new account number, expiry date, or both, but the customer has requested that the issuer not share updated card details with the merchant. `Error`: The Account Updater request process at Adyen experienced an error. This value does not apply if Line record field 5 is set to `AccountUpdaterRealtime`. For further details on account updater actions, see Account Updater.
7	YYYY-MM-DD	Processed date. This is the date that Adyen processed the file received from the scheme.
8	Alphanumeric	New alias. This field is only populated with an alias when either the card number is changed or there is a change to the expiry date of the card. Otherwise, it is empty.
9	Numeric	New expiry month. Format: `MM`, zero-padded (eg: 03).
10	Numeric	New expiry year. Format: `YYYY` (eg: 2020).
11	Alphanumeric	The refusal reason. For batch or automatic account updater, this field is the internal error or the implementation error. It contains reasons for the error in the account update request. This field is populated when sub-line field #5 in the Account Updater result is `Not Submitted`. For real time account updater, this field is the acquirer response code. It contains the acquirer response code (e.g. 00: Approved or Completed Successfully, or 05: Do Not Honor).
12	Alphanumeric	The new account number (PAN). This field is only populated if all of the following rules apply: The request file was encrypted There is an Account Updater PGP key configured at the company level. The result file contains a card number.

The following is a sample Account Updater batch response file:

FH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,AccountUpdater,FileHeaderEchoData
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference1,Success,EchoData
SL,1,AccountUpdaterResult,221234321234543H,Submitted,NoChange,2013-11-13,,,,,
L,2,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference2,Success,
SL,1,AccountUpdaterResult,221234321234543K,Submitted,CloseAccount,2013-11-13,,,,,
L,3,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference3,Success,EchoData
SL,1,AccountUpdaterResult,221234321234543J,Submitted,PANChanged,2013-11-13,D123456789123456,07,2018,,
L,4,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference4,Success,EchoData
SL,1,AccountUpdaterResult,221234321234543F,Submitted,CardExpiryChanged,2013-09-15,F098765432112345,03,2017,,
L,5,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference5,Success,EchoData
SL,1,AccountUpdaterResult,221234321234543T,Submitted,Error,2013-09-15,,,,,
L,6,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference6,Success,EchoData
SL,1,AccountUpdaterResult,221234321234543E,Not Submitted,Error,,,,,No registered account,
BT,6
FT,1