Summary:

Improve the error message displayed to users attempting to install or subscribe to an app when they encounter the specific scenario where they lack the necessary billing admin permissions. The current error message is vague and does not guide the user on how to resolve the issue.

Current Issue:

• Users attempting to install or subscribe to an app after it has been uninstalled or deactivated may encounter the error message: "We ran into a little trouble. Unfortunately, we're unable to process your request. Please retry again in some time."

• Internal logs may show a "401 Unauthorized" error related to the order payload having 'ACCOUNT_MODIFICATION_ORDER'.

• This scenario is not a bug but a known issue where the app subscription fails due to mismatched invoice groups between the deactivated app entitlement and the parent product.

• Users performing the resubscription need to be billing admins for both invoice groups.

Proposed Improvement:

• Enhance the error message to provide clear guidance to the user about the lack of billing admin permissions and what steps they need to take to resolve the issue.

Proposition of error message:

"We encountered an issue processing your request due to insufficient billing permissions. To proceed with subscribing to the app, please ensure you are a billing admin for both the app's invoice group and the parent product's invoice group. You can manage your billing permissions by accessing your admin portal at: https://admin.atlassian.com/billing. Once you have the necessary permissions, please try again."