Library
List of Errors
We are unable to process the customer's transaction. Kindly advise the customer to ensure that payment gateway settings are correctly configured. For further assistance, kindly ask them reach out to Merchant Service Provider

Recommended Customer Message

We are unable to process the transaction. Kindly ensure that your payment gateway settings are correctly configured. For further assistance, kindly reach out to Merchant Service Provider

Description

The payment failed due to an invalid configuration in the merchant account or payment gateway settings. This can include incorrect API credentials, disabled payment methods, environment mismatches, or integration errors.

Recommended Customer Message

Your payment could not be processed due to a technical issue. Please try again later or contact support if the problem persists.

Root Cause

  • Incorrect merchant account configuration: Essential settings (such as API keys, credentials, or gateway rules) are missing or misconfigured.
  • Disabled payment methods: The requested payment method is not enabled in the gateway configuration.
  • Environment mismatch: A transaction is being sent to the wrong environment (e.g., production credentials used in sandbox).
  • Gateway integration errors: The integration code is passing unsupported or invalid parameters based on the current setup.

Troubleshooting and Solutions

  • Review the payment gateway configuration in your system or admin console.
  • Verify credentials, environment (test vs. live), payment method enablement, and webhook URLs.
  • Check the gateway documentation for any mandatory fields or setup steps you might have missed.
  • Ask the customer to retry the transaction once the configuration is corrected.
  • Contact Chargebee Support if the problem persists despite correct inputs.
  • If needed, contact the payment gateway or the Merchant Service Provider for assistance in resolving the misconfiguration.