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 configuration

Set up the BlueSnap Account Updater

Configure the BlueSnap Account Updater for use with Zuora Payment Method Updater (PMU) for Visa and MasterCard.

  1. In the top-right corner, click your username, and then go to Settings > Payments > Set Up Payment Method Updater.
  2. From the Updater Type list, select BlueSnap, 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 approval, Zuora automatically sends BlueSnap payment methods to the BlueSnap gateway for updates.
    • Active: Select Active to activate the BlueSnap Account Updater in Zuora. When this checkbox is selected, PMU automatically submits credit card information for updates.
    • Name: Enter the name that you want to use to identify the updater.
    Note: If you configure multiple active updaters, they might submit the same cards and receive duplicate updates.
  4. In the credentials area, enter the following information:
    • In the Username field, enter the username that BlueSnap assigned to identify the application that sends batch updater requests.
    • In the Password field, enter the password that BlueSnap assigned to identify the application that sends batch updater requests.
  5. Select the updater services that you want to use. Zuora supports both Visa and Mastercard updater services.
    • Select the Visa Account Updater (VAU) checkbox.
    • Select the Mastercard Automatic Billing Updater checkbox.
  6. In the rules area, configure the following options:
    • In the Start Payment Method Updater service days prior to the Bill Cycle Day field, enter a value. Zuora recommends a value of 5 to 7 days because the BlueSnap Account Updater service takes approximately 5 days to process credit card account information.
    • Select Only update payment methods for customer accounts associated to this gateway/processor to include credit cards only for customer accounts that meet either of the following conditions. Clear this checkbox to send all credit card information to BlueSnap.
      • The default payment gateway of the customer account is set to BlueSnap 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 BlueSnap.
    • 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 across all customer accounts, regardless of whether AutoPay is enabled.
  7. Click Save Updater Information to save the updater configuration.

    For more information about updater services and rules, see Payment Method Updater overview.

Submit and retrieve PMU batches

Zuora collects payment methods every day at 18:00 Pacific Standard Time (PST). To view the submitted batches, go to Payments > Payment Method Updater. Batches that are in progress display the Processing status in the batch list.

A BlueSnap scheduled job runs every day at 18:00 PST. This job retrieves the completed batch from BlueSnap through SFTP. When Zuora sends the batch successfully, the status changes to Completed.

If Zuora does not receive a response from the gateway within 7 days, the submitted batch expires.

Note: If you resubmit batches within one hour before the daily scheduled batch processing time of 18:00 PST, Zuora returns an error. Wait until the daily batch processing completes before you resubmit.

For information about how to manually create PMU batches, resubmit batches, and retrieve batch results, see Use Payment Method Updater.

Troubleshoot BlueSnap Account Updater

For information about troubleshooting Account Updater errors in Zuora, see Troubleshoot Payment Method Updater.

The following BlueSnap documentation is provided as a reference:

Last updated: May 29, 2026