AccountUpdater result file

For account updater, the result file, which includes the full PAN (i.e. 'PANChanged') is encrypted.

If the result file does not include PAN, a non-encrypted result file is created.

Example:

The file is encrypted if the merchant passed full PAN in the request AND the result file has full PAN.

The file is not encrypted if:

  • The merchant passes full PAN in the request, and the result file has no PAN.
  • The merchant did not pass full PAN but used ‘AccountUpdaterRecurring’ in the result file.

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 [0-9]+

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

Alphabetic data [A-Z, a-z]

Specifies the merchant account name.

5

Allowed values:

  • ScheduleAccountUpdater
  • AccountUpdaterAutoUpdate
  • AccountUpdaterRealtime

Specifies the requested transaction type:

  • ScheduleAccountUpdater: returned when merchants submit a standard 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

Alphabetic data [A-Z, a-z]

A unique identifier associated to a specific transaction.

When Field 5 is AccountUpdaterRealtime , this field will contain the merchant reference.
7

Allowed values:

  • Scheduled
  • Error
  • Success

Transaction status.
A Pending status means that the modification request needs to be postponed for processing.

This is not applicable when Field 5 is AccountUpdaterRealtime.

8

Alphabetic data [A-Z, a-z]

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 is not applicable when Field 5 is AccountUpdaterRealtime.

AccountUpdater sub-line

Field #

Format

Description

1

Fixed value: SL

Record type identifier

2

Numeric [0-9]+

SL sub-line record number reference within its parent line.

The counter starts at 1, and it increments sequentially by one unit.

3

Allowed values:

  • AccountUpdaterResult
  • AccountUpdaterAutoUpdateResult
  • AccountUpdaterRealtimeResult
  • AccountUpdaterResult: returned when merchants submit a standard account updater request.
    When the result type is AccountUpdaterResult, sub-line field #4 (see below) takes the merchant reference as a value.

  • 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

Numeric [0-9]+

This value corresponds to the pspreference when [L] Line record field #5 is set to either ScheduleAccountUpdater, AccountUpdaterAutoUpdate or AccountUpdaterRealtime.

It corresponds to the merchant reference when [SL] sub-line record field #3 is AccountUpdaterResult.

5

Allowed values:

  • Not Submitted
  • Submitted

The account update submission request status:

  • Not Submitted: returned to inform you that Adyen has already received the same request in the past 7 days.  
  • Submitted: returned to inform you that the record was submitted and processed by the scheme.

These values do not apply if Field 5 is set to AccountUpdaterRealtime.

6

Allowed values:

  • NoChange
  • CloseAccount
  • PANChanged
  • 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 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: t he 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 Field 5 is set to AccountUpdaterRealtime.

For further details on account updater actions, see the Account Updater Manual.

7 YYYY-MM-DD

Processed date. This is the date that Adyen processed the file received from the scheme.

8

Alphabetic data [A-Z, a-z]

New alias. This field is only populated when an existing alias is updated with a new value. Otherwise, it is empty.

9

Numeric [0-9]+

New expiry month.

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

Numeric [0-9]+

New expiry year.

  • Format: YYYY (eg: 2020).
11

Alphabetic data [A-Z, a-z]

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
Alphabetic data [A-Z, a-z]

The new account number (PAN).

This field is only populated if you:

  • are not using tokenization or recurring contracts, and:
    • have requested an update for a new, valid PAN in an encrypted batch file, or
    • have scheduled an account update using the account updater API request, or
    • have activated Real Time Account Updater.


Response:
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