Welcome to Zuora Product Documentation

Explore our rich library of product information

Payment Method Updater batch details

Learn how to view batch details and understand the updater summary fields, including status, response codes, and payment method counts.

Batch summary fields

In Multiple batch view mode, click a single batch to view more information. The following table describes the fields in the batch summary.

Field name

Description

Zuora Batch Number

Unique batch identifier that Zuora generates and sends in the request file.

Updater Request ID

File identifier that indicates which request file the batch belongs to. Zuora uses this identifier to reconcile the batch with the report file that the updater service provider generates.

For example, if the Updater request ID is 110502 and the merchant ID is zuoramerchant, a response file named zuoramerchant.110502.au.response.pan.csv is available in the Report Search window of the Business Center.

Post Date

Date when the Updater batch status was posted.

Account Updater Service

Account Updater service provider that you use for this batch update.

Started On

Time when the batch started. This is the same as the time when the batch was created.

Completed On

Time when the batch finished processing. This field is empty when the batch is in Processing status.

Status

Current state of the batch. The possible values are:

  • Processing: The Updater batch is created but has not finished processing. A batch typically remains in Processing status for several days. If the batch fails at the submission or retrieval stage, it remains in Processing status and is retried automatically. After the maximum number of retries is exceeded, the status changes to Error. By default, the maximum number of retries is 3.

  • Completed: The response file for the Updater batch is received and processed, and the changes to payment methods are saved to the database.

  • Error: The Updater batch failed. This is a rare condition. Check the response code and response message on the batch detail page, and then take action as described in the Payment Method Updater troubleshooting guide.

Response Code

Zuora-defined response code returned after the Updater batch is completed. For a list of response codes and recommended actions, see CyberSource PMU troubleshooting.

Response Message

Message that provides more details about the response code. For a list of response codes and recommended actions, see CyberSource PMU troubleshooting.

Total Payment Methods Selected

Total number of payment methods that are selected in the batch.

Payment Methods Processing

Number of payment methods that are still processing.

Payment Methods Updated

Number of payment methods that were updated. Only payment methods that the merchant pays for are updated. Common reasons for an update include a new credit card number, a closed credit card, or a changed expiration date.

No Updates Available

Number of payment methods that were checked but did not require an update.

Warnings

Number of payment methods that you must review for possible errors. Warnings are generated in the following scenarios:

  • Batch processing failed. All records in the batch are marked as warnings, and you must submit the batch again.

  • Batch processing completed successfully, but some records are marked as warnings. These records fall into one of the following categories: invalid credit card, contact cardholder, no match, or other reasons.

Resubmit a batch manually

When you create a batch, the Updater automatically submits the data to the service. If the submission fails and the automatic retries are not frequent enough or have been exhausted, you can resubmit the batch manually.

To resubmit a batch, click more > Re-submit batch.

Note:

The more menu is not available when the batch status is Completed or Cancelled.

You can resubmit a batch only when the batch status is Error due to a submission failure. To view the submission status, create a data source export. For more information, see Create a data source export.

Retrieve batch results manually

After the data is submitted to the service, the results are usually available within a couple of days. The Updater automatically retrieves the results and retries the retrieval if necessary. You can also retrieve batch results manually.

To retrieve batch results, click more > Retrieve results.

Note:

The more menu is not available when the batch status is Completed or Cancelled.

You can retrieve a batch only when the batch status is Error but the submission succeeded. To view the submission status, create a data source export. For more information, see Create a data source export.