Feature icon

Batch Account Updater

Learn how you can update card information through the Batch Account Updater.

With Batch Account Updater, you can send batch files to get updates for your shoppers' cards. We obtain the updates from Visa, Mastercard, and Cartes Bancaires, and send you batch response files with the new card details.

To update shopper card details through the Batch Account Updater:

  1. Send a batch request file, or an API call if you only need an update for a single card.
  2. Receive the response in the batch file.
  3. Update the card details through a payments request.

Set up an SFTP server

You need to have an SFTP server set up to send and receive the batch files.

To set up an SFTP directory, contact our Support Team. You need to provide your IP address, and SSH and PGP keys. For more information, see Advanced SFTP batch files.

Use batch request files

The process of sending a batch request file and receiving updates in the batch result file is as follows:

  1. Generate a batch request file and upload it to your SFTP directory.

    The following is a sample Account Updater batch request file:

    After receiving the batch request file, we run validation checks and generate a batch acknowledgement file (ACK).

  2. Optionally check the results of the validation check in the ACK file.

    When the batch request files are successfully validated, we obtain the updated card information from Visa, Mastercard, and Cartes Bancaires, and add the updated information to a batch result file. This process takes minimum two days from when you receive the ACK file.

  3. Fetch the batch result file to retrieve the updated card information.

    The following is a sample Account Updater batch response file:

  4. Based on the batch result file, update the old card details.

Use API calls

To receive account updates for a single card, you can send an API request instead of a batch request file.

  1. Make a POST /scheduleAccountUpdater request, specifying either:

    • Card data: all fields in the card object are mandatory.
    • Adyen token data: the shopperReference and selectedRecurringDetailReference fields are mandatory.

    The response indicates we received your request.

    We now forward the request to Visa, Mastercard, and Cartes Bancaires.

  2. Fetch the batch result file to retrieve the updated card information.

  3. Based on the batch result file, update the old card details.

Account Updater statuses

When we perform an account update, we send a status in the batch result file. The status indicates what action you need to take based on what changed in the card details.

Status Alternative values for the status Description
NoChange
  • EitherExpiryChangedOrNoChange
  • InvalidAmount
  • TxInvalid
  • RecordIdentifierInvalid
  • BinNotParticipating
  • CreditCardNumberInvalid
  • CreditCardNumberNotFound
  • IssuerNotSubscribed
  • NoMatchFound
  • UnknownResponseCodeProvided
  • GenericTokenUseError
  • InvalidCreditCard
  • InvalidExpirationDate
  • MerchantIsNotAuthorisedToUseTokens
  • TokenIsInvalid
  • TokenWasNotFound
The card has not changed.
CloseAccount
  • CloseAccount
  • CloseAccountThisAccountOnly
The account has been permanently closed by the issuing bank.
PANChanged
  • CardChanged
The account number has changed.
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 shopper has asked the issuer to not share updated card details.
Error
  • MerchantIdInvalid
  • MerchantIdNotEnabled
Our Account Updater process experienced an error.

Update old card details

There are three scenarios that can occur as a result of an account update:

To enable this flow, contact our Support Team. Not doing so will result in an API error when attempting the update.

No updates on the card

If there are no updates on the card, you don't need to take any further actions and all the card details remain unchanged.

Card details are updated

You can receive updates of the following information on your shoppers' cards:

  • Card number
  • Expiry date of the card
  • Both card number and expiry date

The following examples show how you can update card details through a payment request.

Make sure that you include the new alias in the paymentMethod.number field when you update the card number.

Card details are disabled

You can get an update that certain cards have been disabled. This can occur if the card is reported as stolen, or if the shopper informed the bank they no longer authorize transactions from you. We don't disable the storedPaymentMethodId or recurringDetailReference. Instead we provide the update to you, and you need to disable the card details.

For instructions, see Disable stored payment details.

Get a report on card updates

The Account Updater results report shows a summary of Account Updater results from a particular period of time. Use this report to check the outcomes and statuses of account updates, and get a summary of both Real Time Account Updater and Batch Account Updater results. You can also analyze the fees charged for the Account Updater.

See also