home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Payment Method Updater

Payment Method Updater Troubleshooting

This document provides guidance on troubleshooting the Zuora Payment Method Updater, including batch error handling and understanding user information logged in records.

Payment Method Updater console

Zuora provides the Payment Method Updater (PMU) console to help you track and manage the batch files and payment method information that Zuora sends to the CyberSource Account Updater service. You also use the console to troubleshoot issues with the updater service.

To open the console, navigate to Zuora > Payments > Payment Method Updater.

Because the CyberSource, Vantiv, and WorldPay updater services use different setups, the troubleshooting steps differ for each service. The following items vary by updater service:

  • Reconciling the Zuora PMU with the enrolled updater service.

  • Reviewing response codes specific to the account updater service.

For service-specific troubleshooting steps, see one of the following topics:

Batch error handling

Zuora returns simple error messages with detailed responses that identify both customer-resolvable issues and issues that require Zuora Support. The Response Code field uses a Zuora-defined three-digit numbering system.

Note: If you parse the Zuora Updater Response Code, parse only the response code. The accompanying response messages vary by case and by updater service.

In the following example, the response code is 501.

Figure 1. Response code example in the PMU console
PMU console record showing a response code of 501 in the Response Code field.

User information logged in the record

The PMU updates payment method records differently depending on whether the card number changes:

  • If the card number changes, the PMU creates a new payment method. The created_by and updated_by fields on the new payment method are copied from the old payment method. The PMU then closes the old payment method and sets its updated_by field to the system user 3.

  • If the card number remains the same, the PMU updates the expiration date on the existing payment method and sets the updated_by field to the system user 3.

Last updated: June 1, 2026