Welcome to Zuora Product Documentation

Explore our rich library of product information

Troubleshooting gateway errors

There are several ways to obtain information on gateway errors:

  1. See Merchant e-Solutions Payment Gateway Testing for information on the payment gateway error codes.
  2. Look up the transaction by the transaction ID number (in the Zuora payment detail page, this is the Reference ID and Secondary Reference ID numbers) in virtual terminal to see if more information is provided; often you will see more than just the response (reasons) code and response message in Zuora.
  3. For further assistance with gateway errors, you can contact the Merchant e-Solutions Support team for assistance.

Zuora recommends that you check the payment in Zuora to see how many times the same payment method has been retried for payment and failed. If there have been several retries, check the error messages from the beginning with the first failure and the more recent failures to determine if the error message is the same. If a merchant tries to process a payment against the same credit card too many times despite receiving errors, this could trigger warnings to the card-issuing bank. The card-issuing bank may place an alert on the account and not allow any further transactions from the merchant using that payment method. When a merchant has been flagged, the error received on the payment may be not state the reason why, instead it might be a generic error decline error. In this case, the merchant (Zuora customer) should work with Merchant e-Solutions to see if they can identify the problem with the payment method. If the processor does not know, then the merchant and/or the card holder can try calling their card-issuing bank to look into the issue.