Welcome to Zuora Product Documentation

Explore our rich library of product information

Error handling for Payment Form

This document provides a detailed description of potential errors on the Payment Form, including their causes and recommended actions.

The following table describes the errors that may return on the Payment Form:

HTTP response code

Type

Code

Message

Possible reasons

Recommended action

400

invalid_request_error

invalid_request

The message text varies based on the context of the request.

  • A missing required parameter

  • An invalid parameter value

Fix the error in your integration.

Related articles:

402

transaction_error

transaction_declined

Your transaction was declined.

  • Failed payment method verification

  • Failed payment

  • Payment gateway downtime

  • Try again later.

  • Change the payment method and try again.

401

invalid_request_error

unauthorized_access

Unauthorized access.

  • Expired publishable key

  • Invalid access token

Fix the error in your integration.

Related articles:

429

invalid_request_error

too_many_request

You have exceeded the number of allowed requests.

  • Rate limit exceeded

  • Blocked by security measurement

Try again later.

Related article: Security measures for Payment Form

500

api_error

internal_server_error

Internal server error.

Internal system error

Zuora Global Support Contact Zuora Global Support .

N/A

client_error

invalid_configuration

Invalid client configuration.

Invalid client configuration in the client integration, such as missing or invalid parameters or callback.

Fix the error in your integration.

Related articles:

N/A

client_error

internal_client_error

Internal client error.

Unexpected client errors such as network error

Try again later.