Troubleshooting SaaS products - AWS Marketplace

Troubleshooting SaaS products

The following topics explain how to troubleshoot common SaaS product issues and error messages in AWS Marketplace.

Common SaaS error messages

The following table lists the most common SaaS error messages and their solutions.

Error Message Solution
Agreement creation failed due to seller compliance issues or an unsupported offer currency in your region. Contact the seller to ensure the correct offer is extended to you.

By design, AWS Marketplace prevents sellers from buying their own products. Please use a different account and allow list that account to your product for testing purposes.

For more information, see Configuring SaaS product settings in AWS Marketplace.

UsageBasedPricingTerm can't be updated until xxx-xx-xxT00:00:00Z because you have requested a price increase in the past 120 days.

Your product might have active subscriptions. Due to these active subscriptions, you need to wait for the effective change date to pass before modifying your listing. This is a standard procedure to ensure service continuity for your current subscribers.

If you have questions or need further assistance, contact the AWS Marketplace seller operations team.

INVALID_FULFILLMENT_URL

Provide the correct format for the fulfillment URL. Begin with 'https://'

Ensure URL starts with https:// or http://

Validate URL format and accessibility

Test fulfillment endpoint before submission

Correct format: https://your-saas-app.com/fulfillment

For more information, refer to Configuring SaaS product settings in AWS Marketplace.

You do not have sufficient permissions to access this page.

If you encounter an error when choosing the Offers tab in the AWS Marketplace Management Portal, ensure that you meet the prerequisites at

For more information, refer to How can a seller resolve errors when access the Offers tab in the Private offer FAQ, earlier in this guide.

INVALID_MEDIA_LOCATION

Ensure Amazon S3 URLs are accessible and properly formatted

https://s3.amazonaws.com/your-bucket/your-logo.png

Logo requirements:

  • Format: PNG, JPG, GIF

  • Size: Under 500 KB

  • Publicly accessible Amazon S3 location

Remove unsupported characters

¦, §, ', , ,

Use standard ASCII characters in product descriptions

For more information, see Providing metadata for AWS Marketplace products earlier in this guide.

DUPLICATE_SELLER_ENTITY

A seller entity already exists for this account.

Check existing seller registration status

Use UpdateSeller instead of CreateSeller for modifications

Contact AWS Marketplace support if duplicate registration persists

For more information, refer to Registration process earlier in this guide.

SELLER_ENTITLEMENT_EXISTS

This principal already has entitlements to be a seller in AWS Marketplace.

Verify current seller status in the AWS Marketplace Management Portal

Use appropriate update operations instead of creation

Review IAM permissions and roles

For more information, refer to Registration process earlier in this guide.

UNSUPPORTED_DELIVERY_OPTION

The existing default URL-based SaaS products cannot be updated to use API delivery options.

Create new product for API-based delivery

Cannot convert between URL-based and API-based SaaS products

Plan product architecture before initial creation

INCOMPATIBLE_DELIVERY_OPTION_TYPES

You provided an ApiDeliveryOption for a product that already contains SaaSUrlDeliveryOptions.

Create separate products for different delivery types

Choose either API or URL-based delivery at product creation

Review product requirements before setup