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

Update the status of payment stuck in processing

Update the payment status manually

Learn how to manually update the payment status in Zuora when automatic resolution is not possible.

Updating status manually is only available in Zuora UI with New Zuora Experience disabled.

Zuora supports idempotent retry or inquiry call on some gateway integrations to automatically resolve payments stuck in Processing status. This process usually takes up to 48 hours. If the payment has been stuck in processing for more than 48 hours, regardless of whether the gateway integration supports idempotent retry or inquiry call, an Update Payment Status link will be available next to the Status field and the Error Message field on the Payment Detail page. Complete the following steps to manually update the payment status.

The payment status can be manually updated only once. After you update the status by using the following procedure, the payment status cannot be changed anymore. If you update the payment status incorrectly, create an external payment or refund to balance the amount.

  1. On the Payment Detail page, click the Update Payment Status link next to the Status field or the Error Message field.
  2. On the Stuck Payment Status Update page, fill in the following fields. The values of the following fields are generated by the gateway provider. Check your gateway console or contact the gateway support to retrieve the values.

    • Transaction ID : Optional. If the payment was processed successfully on the gateway side, the gateway associates a transaction ID with the payment request from Zuora, and will validate this ID during the refund. If the payment has not been received by the gateway, leave this field empty.

    • Gateway State : Required . If the payment has been processed successfully on the gateway side and you want to update the payment status to Processed, select Submitted . Otherwise, select Not Submitted to set the payment to Error and start the retry.

    • Gateway Response Code : Optional. The response code returned by the gateway for the payment.

    • Gateway Response MSG : Optional. The response message returned by the gateway to further explain the Gateway Response Code.

    • Transaction Result Code : Required . If the payment has reached the gateway and you want to update the payment status to Processed, select Approved . Otherwise, select another value that you get from the gateway to set the payment to Error and start the retry.

  3. Click Add Transaction Log and Update Payment .

The payment status will be updated to either Processed or Error, and the information you provided will be populated to the following fields of the transaction log in Zuora.

Information from gateway

Field in Zuora transaction log

Transaction ID

Gateway Transaction ID

Gateway State

Gateway State

Gateway Response Code

Gateway Response Code

Gateway Response MSG

Gateway Response Code Description

Transaction Result Code

This field will be saved in Zuora but cannot be retrieved through any query or reporting tools.

Last updated: March 9, 2026