No momento, esta página não está disponível em português
Developer-resource icon

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 plataforma de pagamentos da Adyen 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 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,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