AWS Marketplace SaaS Listing Process & Integration Guide AWS Marketplace SaaS Guide / SaaS...

download AWS Marketplace SaaS Listing Process & Integration Guide AWS Marketplace SaaS Guide / SaaS Contract

of 17

  • date post

    20-May-2020
  • Category

    Documents

  • view

    32
  • download

    8

Embed Size (px)

Transcript of AWS Marketplace SaaS Listing Process & Integration Guide AWS Marketplace SaaS Guide / SaaS...

  • © 2019, Amazon Web Services, Inc. or its affiliates. All rights reserved.

    AWS Marketplace

    SaaS Listing Process &

    Integration Guide

    1

  • © 2019, Amazon Web Services, Inc. or its affiliates. All rights reserved.

    1. Register as a seller and submit tax & banking information. This step is required before you can request to list a

    paid product.

    2. Become familiar with the AWS Marketplace Management Portal (AMMP). This is the tool that you use to

    register as a seller and manage the products that you sell on AWS Marketplace.

    3. Learn about tools available to you as an AWS Marketplace seller.

    4. Determine your product s pricing model. SaaS products can be created with one of three pricing options:

    Contract, Contract with Consumption, or Subscription.

    AWS Marketplace SaaS Guide / About this guide

    About this guide

    Audience

    This guide is for independent software vendors (ISVs), selling SaaS products in AWS Marketplace. We have included

    essential information to help you navigate each step of the listing process and understand what s required to

    integrate with AWS Marketplace. In this guide, you will find integration diagrams for each pricing model, code

    examples for interacting with our APIs, a list of frequently asked seller questions, and links to external resources that

    help you deep dive into the concepts presented throughout. Thank you for choosing to list with us and we look

    forward to welcoming you to AWS Marketplace!

    Contents

    2

    SaaS Contract (upfront billing) Code examples

    Frequently Asked Questions (FAQs)

    External resources

    Listing process & integration requirements

    Integration diagram

    SaaS Contract with Consumption

    Listing process & integration requirements

    Integration diagram

    SaaS Subscription (pay-as-you-go)

    Listing process & integration requirements

    Integration diagram

    ResolveCustomer

    GetEntitlement

    BatchMeterUsage

    Before Getting Started

    There are some prerequisites you ll need to complete before submitting your SaaS product and reviewing this guide:

    Click here to learn more about Contract pricing Click here to learn more about Subscription pricing

    Click here to learn how to register & submit tax and banking information.

    Click here to learn about AMMP.

    Click here for your seller toolkit.

    (or)

    https://docs.aws.amazon.com/marketplace/latest/userguide/saas-contracts.html https://docs.aws.amazon.com/marketplace/latest/userguide/saas-subscriptions.html https://docs.aws.amazon.com/marketplace/latest/userguide/seller-registration-process.html https://docs.aws.amazon.com/marketplace/latest/userguide/user-guide-for-sellers.html#management-portal https://docs.aws.amazon.com/marketplace/latest/userguide/additional-seller-tools.html

  • © 2019, Amazon Web Services, Inc. or its affiliates. All rights reserved.

    SaaS Contract Listing process &

    integration requirements

    Integration diagram

    AWS Marketplace SaaS Guide / SaaS Contract

    3

  • © 2019, Amazon Web Services, Inc. or its affiliates. All rights reserved.

    1

    2

    3

    Collect Assets Before submitting a product, you will need to provide:

     Product logo URL

     End User License Agreement (EULA) URL

     SaaS fulfillment URL (redirect page customers will be sent to after subscribing)

     Metadata

     Support information

    Submit via Management Portal Create a product page using a seller account that has access to the AWS Marketplace

    Management Portal (AMMP).

    Product Page Published to Limited The AWS MP Ops team will publish your submission as a limited product page visible to

    you and any AWS accounts you have requested to be whitelisted. Prices will be

    temporarily reduced to enable you to test the purchase flow without incurring high

    charges. The Ops team will send you the following via email to enable this testing:

     Product code

     SNS topic(s)

     Product page URL

    4 Validate New Customers After a customer subscribes to your product, they will be redirected to the fulfillment URL.

    The redirect is a POST request & includes a temporary token. Your app then needs to:

     Exchange the token for a customerID by calling ResolveCustomer in the AWS

    Marketplace Metering Service.

     After obtaining a customerID, persist it in your application for future calls.

     With the customerID, call GetEntitlement in the AWS Marketplace Entitlement Service

    to verify which dimension the customer is subscribed to and the quantity, if applicable.

    Onboard New Customers After successfully verifying a customer s subscription, onboard them onto your

    application. For example, have them fill out a form to create a new user account. Or,

    provide them with next steps to get access to the application.

    5

    AWS Marketplace SaaS Guide / SaaS Contract / Listing Process & Integration Requirements

    Listing Process

    4

    Integration Requirements

    SaaS Contract

    Monitor for Changes Setup an SQS queue and subscribe to your product s SNS topic. This topic provides

    notifications about changes to customers subscription and entitlement statuses. This

    enables you to know when to provide and revoke access for specific customers. Possible

    scenarios include: unsubscribes, upgrades, renewals, & failed subscription.

    7

    Handle No Entitlement Scenarios If no entitlement is returned from GetEntitlement, either during onboarding or

    ongoing verification, determine how to manage access & their experience.

    6

    Listing Process (continued after completion of integration)

    End-to-end testing with AWS Marketplace After you have completed all the integration requirements and tested the solution,

    notify the AWS Marketplace Ops team. They will then test the solution by verifying you

    have successfully called GetEntitlement and sufficiently onboard new customers.

    After end-to-end testing is complete, you will have the chance to review the product

    page with the original prices. After giving approval, the AWS Marketplace Ops team will

    make the product page live in the public catalog.

    8

    Note: Each item refers to a step in the diagram (see next page)

  • © 2019, Amazon Web Services, Inc. or its affiliates. All rights reserved.

    Verifying

    Customers

    Decide to List

    SaaS Product

    Review SaaS Seller Guide

    Determine

    pricing & offer

    type

    Collect Assets

    Submit

    Product

    via

    AMMP

    AWS MP

    Publishes

    Product to

    Limited

    SaaS

    Integration

    AWS MP End-

    to-End

    Testing

    Product Live

    1 2 3

    Accepting New

    Customers

    Accept HTTP POST

    request

    x-amzn-marketplace-

    token

    MS

    ES

    = Seller (ISV) Action

    = AWS Marketplace Entitlement Service API

    Key:

    = AWS Marketplace Metering Service API

    = AWS Marketplace Ops Team Action

    Grant access to

    product based on

    dimensions returned

    in entitlement

    New customers in

    onboarding workflow

    Existing customers

    already using product

    DB

    Listen for:

    Call

    ResolveCustomer

    MS

    Store CustomerID Setup new

    queue in SQS

    If no entitlement returned

    Handle each scenario

    If active entitlement

    Call GetEntitlement

    to verify active

    subscription ES

    Check customer s

    entitlement

    entitlement-updated

    message

    With CustomerID

    Subscribe

    to:

    Entitlement

    SNS topic

    4 X = Code example (see code example pages)

    A

    B

    = AWS Service

    X = Steps (see previous page)

    5

    AWS Marketplace SaaS Guide / SaaS Contract / Integration Diagram

    8

    Monitoring for

    Subscription Changes

    SaaS Contract (cont.)

    Example SNS Topic

    arn:aws:sns:us-east-1:287250355862:aws-mp-

    entitlement-notification-PRODUCTCODE

    5

    7

    6

    https://docs.aws.amazon.com/marketplace/latest/userguide/software-as-a-service-based-products-saas.html

  • © 2019, Amazon Web Services, Inc. or its affiliates. All rights reserved.

    SaaS Contract

    with Consumption Listing process &

    Integration requirements

    Integration diagram

    AWS Marketplace SaaS Guide / SaaS Contract with Consumption

    6

  • © 2019, Amazon Web Services, Inc. or its affiliates. All rights reserved.

    1

    2

    3

    Collect Assets Before submitting a product, you will need to provide:

     Product logo URL

     End User License Agreement (EULA) URL

     SaaS fulfillment URL (redirect page customers will be sent to after subscribing)

     Metadata

     Support information

    Submit via Management Portal Create a product page using a seller account that has access to the AWS Marketplace

    Management Portal (AMMP).

    4 Validate New Customers After a customer s