home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableZuora AIRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableZuora AIRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Payment Method Updater for Adyen

Set up Adyen Payment Method Updater

Learn how to configure the Adyen Account Updater in Zuora to automatically update payment methods through the Adyen gateway.

Before you configure the Payment Method Updater (PMU) service for Adyen, complete the following prerequisites:

  • Confirm that you are in a region where the Adyen Account Updater service is supported.

  • Work directly with Adyen Support to set up your updater account and SFTP server. For more information, see Account Updater and Advanced SFTP batch files. If Adyen returns an unencrypted PMU result file, Zuora cannot process that file format. The PMU batch can fail, and closed-account notifications or other updates in that file might not be applied.

  • Ask Adyen Support to enable the genericBatchAlwaysEncryptResultIfReceivedEncrypted setting for your merchant account. This setting ensures that Adyen uploads encrypted PMU result files to the SFTP server. If this setting is not enabled and a batch contains no card updates, Adyen can return an unencrypted result file, which the current Zuora Adyen PMU integration does not process. As a result, the batch can fail, and closed-account notifications or other updates in that file might not be applied.

  • Ask Adyen Support to enable the genericBatchAlwaysEncryptResultIfReceivedEncrypted setting for the merchant account that you use for Adyen Payment Method Updater (PMU). This setting ensures that Adyen always returns PMU result files in encrypted format, including batches with no card updates.

  • To use the Batch Account Updater from Adyen, confirm that the Merchant Recurring Role permission is enabled on your Adyen merchant account.

  • Download the public PGP key files provided by Zuora for Sandbox and Production, and add the key files to your Adyen account.

  • Download the public SSH key files provided by Zuora for Sandbox and Production, and add the key files to your Adyen SFTP account.

    Note: Zuora deletes the response file from the SFTP server after processing it. Therefore, you cannot associate multiple tenants with the same SFTP server.

  • Configure outbound IP addresses from Zuora based on your region for IP allowlisting. For more information, see Inbound and outbound IP addresses.

Note:

In some Adyen PMU scenarios where no card updates are returned, Adyen can generate an unencrypted result file. Zuora's current Adyen PMU integration does not process this unencrypted file format. This can cause the batch to fail and can prevent closed-account notifications or other updates in that file from being applied.

You can set up Adyen Account Updater in the Zuora UI.

  1. Click your username at the top right, and then navigate to Settings > Payments > Set Up Payment Method Updater.
  2. Select Adyen from the Updater Type list, and then click add payment method updater.
  3. In the Basic information area, configure the following fields:

    • Processor: Your gateway or processor must approve the PMU functionality. After PMU is enabled, Zuora automatically sends Adyen payment methods to the Adyen gateway for updates.

    • Select Active to activate the Adyen Account Updater in Zuora. When this checkbox is selected, PMU automatically submits credit card information for updates.

      Note: If multiple active updaters are configured, they might submit the same cards and receive the same updates.

    • In the Name field, enter the name that you want to use to identify the updater.

  4. In the Credentials area, configure the following fields:

    • In the Merchant Account Name field, enter the merchant account name assigned by Adyen.

    • In the Company Account Name field, enter the company account name assigned by Adyen.

    • In the SFTP Username field, enter the SFTP user name used for account updates.

    • In the File Submission Platform field, enter a unique identifier for the server that you use to submit batch files to Adyen. Do not enter the identifier for a server that hosts multiple Zuora tenants. If you do not have any specific setting, enter Zuora.

  5. In the Updater services area, select the updater services that you want to use:

    • Select Visa Account Updater (VAU).

    • Select MasterCard Automatic Billing Updater.

    Zuora supports both Visa and Mastercard services.

  6. In the Rules area, configure the following fields:

    • In the Start Payment Method Updater service days prior to the Bill Cycle Day field, specify a value. Zuora recommends a value of 5 to 7 days because the Adyen Account Updater service takes approximately 5 days to process credit card account information for updates.

    • Select Only update payment methods for customer accounts associated to this gateway/processor to include only the credit cards for customer accounts that meet either of the following conditions. Clear this checkbox to send all credit card information to Adyen.

      • The default payment gateway of the customer account is set to Adyen in the Billing and Payment Info section on the Customer Account page.

      • The default payment gateway of the customer account is not configured, but the default payment gateway of the tenant is set to Adyen.

    • Select Only update the default payment method for AutoPay customer accounts to include only the default credit card payment methods for customer accounts that have AutoPay enabled. Clear this checkbox to submit data for all credit cards for all customer accounts, regardless of whether AutoPay is enabled.

  7. Click save updater information to save your configuration.

The Adyen Account Updater is configured in Zuora. For more information about updater services and rules, see Using Payment Method Updater.

Last updated: August 10, 2026