AWS Marketplace

Complete guide to managing your AWS Marketplace presence with Automatum.

New to AWS Marketplace?

If you're not yet an approved AWS seller with a published listing, start with Before You Begin — it covers seller registration, tax, and banking prerequisites first.

Overview

Automatum provides deep integration with AWS Marketplace, enabling you to manage listings, private offers, contracts, and metering from a unified platform.

Supported Offer Types

SaaS Products

• Subscription: Recurring monthly/annual charges
• Contract: Upfront payment with flexible terms
• Contract with Consumption: Upfront + usage-based
• Free Trial: Time-limited free access

AMI Products

• Hourly Pricing: Pay-per-hour usage
• Annual Subscription: Discounted yearly rate
• BYOL: Bring Your Own License

Container Products

• ECS/EKS: Container orchestration pricing
• Fargate: Serverless container pricing

Listing an AMI or container product?

Pick the checklist that matches your product — each has step-by-step requirements, AWS documentation references, a responsibility matrix (what Automatum does vs. what your team owns), and effort estimates:

• AMI (Server) Checklist — software shipped as an Amazon Machine Image
• Container Checklist — images or Helm charts on ECS / EKS / Fargate

Quick Start

1. Connect AWS Account

Follow the AWS Setup Guide

2. Sync Products

Import existing products:

1. Go to Listings
2. Click Sync from AWS
3. Select products
4. Click Import

3. Create Private Offer

1. Select a listing
2. Click Create Private Offer
3. Enter customer AWS Account ID
4. Configure pricing
5. Submit to AWS

Key Features

Product Management

• View all AWS products
• Edit descriptions and metadata
• Update pricing tiers
• Manage dimensions (metered)
• Track product versions

See Listings Management Guide for complete details.

Buy with AWS Integration

Embed purchase buttons and forms directly on your website to enable seamless purchasing from AWS Marketplace.

• Configure "Buy with AWS" buttons
• Set up "Try free with AWS" buttons
• Collect private offer requests via embedded forms
• Request product demos
• Track analytics and conversions

See Buy with AWS Integration Guide for complete setup instructions.

Private Offers

Create custom pricing with flexible payment schedules, multi-year contracts, channel partner offers, and reseller agreements.

See Private Offers Guide for complete details on creating and managing AWS private offers.

Customer Management

Track AWS account IDs, view entitlements, monitor subscriptions, and manage renewals.

See Customer Management Guide for complete details.

Usage Metering

Report SaaS consumption with automatic validation, retries, and audit logging.

See Metering Guide for complete details on usage reporting.

AWS-Specific Configuration

IAM Role Setup

Automatum requires an IAM role with:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:*",
        "aws-marketplace-management:*"
      ],
      "Resource": "*"
    }
  ]
}

Trust Relationship

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::AUTOMATUM_ACCOUNT:role/AutomatumRole"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_EXTERNAL_ID"
        }
      }
    }
  ]
}

Required Permissions

Permission	Purpose
aws-marketplace:DescribeEntity	Read product info
aws-marketplace:StartChangeSet	Create/update offers
aws-marketplace:DescribeChangeSet	Track submission status
aws-marketplace:BatchMeterUsage	Report consumption
aws-marketplace:DescribeAgreement	Read agreement details (channel/reseller/CPPO)
aws-marketplace:GetAgreementTerms	Read agreement terms (channel/reseller/CPPO)
aws-marketplace:SearchAgreements	Find agreements (channel/reseller/CPPO)

Managed Policy Covers These

The AWSMarketplaceFullAccess managed policy already grants all of the actions above (including the agreement actions used for channel-partner, reseller, and CPPO flows). The explicit list is provided for teams building a least-privilege policy of their own.

Private Offer Configuration

AWS Marketplace supports flexible private offer configurations including:

• Multiple discount types (percentage, absolute, custom pricing)
• Flexible payment schedules (upfront, monthly, quarterly, annual)
• Contract durations from 1 to 36+ months
• Channel partner and reseller agreements

Buyer Requirements:

• AWS Account ID (12 digits)
• Appropriate IAM permissions
• Payment method configured

For detailed information on creating and configuring private offers, see the Private Offers Guide.

Metering Integration

AWS Marketplace supports usage-based billing through custom dimensions. Define dimensions in your product (e.g., Users, API Calls, Storage) and report usage via the Automatum API.

Key Constraints:

• Report promptly — AWS stamps each usage record at submission time, so reporting soon after consumption keeps records accurate
• Dimension must exist in product

AWS enforces additional limits on its BatchMeterUsage API: a maximum of 25 records per batch, and quantities must be positive integers. These are AWS-side limits, not Automatum validations.

For complete metering documentation including API examples, see the Metering Guide.

Compliance & Security

Data Handling

• Customer data encrypted at rest
• API calls over TLS
• Audit logging enabled
• SOC 2 compliance

AWS Marketplace Policies

Ensure compliance with:

• AWS Acceptable Use Policy
• AWS Marketplace Seller Agreement
• Product guidelines

Troubleshooting

Common Issues

"Entity not found" error:

• Verify product code
• Check AWS account permissions
• Ensure product is published

"Invalid buyer" error:

• Verify AWS Account ID format
• Check buyer has valid payment method
• Ensure buyer isn't already subscribed

Metering failures:

• Check dimension exists
• Verify timestamp is recent
• Confirm customer has entitlement

Support Resources

• AWS Marketplace Support
• AWS Documentation
• Contact hello@automatum.io for assistance

API Integration

Automatum provides a comprehensive OAuth 2.0 API for programmatic access to AWS Marketplace operations:

• Create and manage private offers
• Report usage metering
• Retrieve customer entitlements
• Access analytics data

Quick Example:

# List private offers
GET https://api.automatum.io/api/v1/private-offers?limit=20
Authorization: Bearer YOUR_ACCESS_TOKEN

For complete API documentation:

• API Authentication - OAuth 2.0 setup
• API Reference - All available endpoints including private offers and metering

Best Practices

1. Test in sandbox - Use AWS Marketplace sandbox first
2. Monitor metering - Set up alerts for failures
3. Track renewals - Start 90 days before expiry
4. Keep products updated - Sync regularly
5. Document offers - Maintain offer records

Related Documentation

• AMI (Server) Listing Checklist
• Container Listing Checklist
• AWS Setup Guide
• Buy with AWS Integration
• Private Offers
• Usage Metering
• Customer Management

Need Help?

Contact hello@automatum.io for AWS Marketplace assistance.