Join the Chargebee Developers Discord — Connect, ask questions, and build faster.Join
List of ErrorsAn incorrect account hierarchy or configuration issue. This happens when the bank account has not been fully set up, permissions are missing, or there is a misconfiguration in the payment gateway or merchant account settings.
gateway.bank_account.setup_hierarchy
Recommended Customer Message
We've identified a setup issue with your account. Please contact our customer support for further assistance.Root Cause
- Incomplete account setup: The bank account has not been fully configured to support the required transaction types.
- Incorrect hierarchy configuration: The account is linked under an incorrect hierarchy or parent-child relationship within the payment system.
- Missing account permissions: The necessary permissions or roles required for processing transactions are not assigned to the account.
- Gateway misconfiguration: The payment gateway configuration in Chargebee has incomplete or incorrect hierarchy settings impacting transaction processing.
Troubleshooting and Solutions
- Review and correct the account hierarchy configuration in the payment gateway or your internal system.
- Ensure all necessary permissions and roles are properly assigned to the account.
- Retry the transaction only after confirming that the account setup is complete and correctly configured.
- If the issue persists, contact the payment gateway and Chargebee support team for further investigation and resolution.