Using AI coding agents like Claude Code or Cursor? Try the official Chargebee Agent Skills to speed up your development.Try now
List of ErrorsThe payment failed due to an unknown or unclassified error from the payment gateway. This occurs when the gateway returns an error without a detailed explanation, an unhandled exception occurs during processing, or third-party systems experience temporary issues.
gateway.general.unknown
Recommended Customer Message
Your payment could not be completed at this time. Please try again later or use a different payment method. If the issue persists, contact your bank for more information.Root Cause
- Unclassified error: The gateway returned an unspecified error without a detailed explanation.
- Unexpected system behavior: An unhandled exception or unknown failure occurred during transaction processing.
- Third-party integration issues: External systems involved in payment processing might be experiencing downtime or instability.
Troubleshooting and Solutions
- Advise the customer to retry the transaction after some time, as the issue may be temporary.
- Recommend using an alternative payment method to complete the transaction.
- Review transaction logs and API responses to check for any hidden error patterns or failures.
- Contact the payment gateway support team for clarification and assistance in identifying the root cause of the unknown error.