Search

Are you looking for test card numbers?

Would you like to contact support?

Feature icon

Account Updater result file

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

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 an account updater request.

  • AccountUpdaterAutoUpdate: returned when the account updater request is submitted via the Adyen automatic 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 account updater request.

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

5

Allowed values:

  • Submitted

The account update submission request status:

  • Submitted: returned to inform you that the record was submitted and processed by the scheme.

These values do not apply if [L] Line record field #5 is set to AccountUpdaterRealtime.

6

Allowed values:

  • NoChange
  • CloseAccount
  • CardChanged
  • CardExpiryChanged
  • ContactCardAccountHolder
  • Error

Account updater action result. This includes the matched response of the account updater request, where applicable.

  • NoChange: the issuer participates in account updater, but the card has not changed. This value is not returned if Line record field 5 is set to AccountUpdaterRealtime. The following value(s) indicate the NoChange action:
    • EitherExpiryChangedOrNoChange
    • InvalidAmount
    • TxInvalid
    • RecordIdentifierInvalid
    • BinNotParticipating
    • CreditCardNumberInvalid
    • CreditCardNumberNotFound
    • IssuerNotSubscribed
    • NoMatchFound
    • UnknownResponseCodeProvided
    • GenericTokenUseError
    • InvalidCreditCard
    • InvalidExpirationDate
    • MerchantIsNotAuthorisedToUseTokens
    • TokenIsInvalid
    • TokenWasNotFound
  • CloseAccount: the account has been permanently closed by the issuing bank. The following value(s) indicate the CloseAccount action:
    • CloseAccount
    • CloseAccountThisAccountOnly
  • CardChanged: the account number has changed. In some cases, if the account number has changed, the expiry date has changed as well. The following value(s) indicate the CardChanged action:
    • PANChanged
  • CardExpiryChanged: the expiry date of the card has changed. The following value(s) indicate the CardExpiryChanged action:
    • CardExpiryChanged
  • 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. The following value(s) indicate the ContactCardAccountHolder action:
    • ContactCardAccountHolder
  • 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. The following value(s) indicate Error:
    • MerchantIdInvalid
    • MerchantIdNotEnabled
    • Error

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.

This field is populated when sub-line field #5 in the account updater result is Not Submitted. It contains reasons for the error in the account update request. When Field 5 is set to AccountUpdaterRealtime this field 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 you are not using Adyen tokenization, and all of the following applies:

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,MerchantReference1,Submitted,NoChange,2013-11-13,,,,,
    L,2,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference2,Success,
    SL,1,AccountUpdaterResult,MerchantReference2,Submitted,CloseAccount,2013-11-13,,,,,
    L,3,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference3,Success,EchoData
    SL,1,AccountUpdaterResult,MerchantReference3,Submitted,PANChanged,2013-11-13,D123456789123456,07,2018,,
    L,4,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference4,Success,EchoData
    SL,1,AccountUpdaterResult,MerchantReference4,Submitted,CardExpiryChanged,2013-09-15,F098765432112345,03,2017,,
    L,5,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference5,Success,EchoData
    SL,1,AccountUpdaterResult,MerchantReference5,Submitted,Error,2013-09-15,,,,,
    L,6,MerchantAccount,TestMerchant,ScheduleAccountUpdater,MerchantReference6,Success,EchoData
    SL,1,AccountUpdaterResult,MerchantReference6,Not Submitted,Error,,,,,No registered account,
    BT,6
    FT,1