Menu
Amazon DevPay
Getting Started Guide (API Version 2007-12-01)

The Steps to Using DevPay

This section summarizes the overall process you follow to use DevPay. The tasks are listed in the following table. For the specific details of the individual tasks, go to the Amazon DevPay Developer Guide. We list the relevant sections in that guide that you should read when performing each task.

Note

The typical getting started guide for AWS services shows code for accessing the service. Because Amazon DevPay isn't a web service itself, this guide instead discusses the process for using DevPay. We recommend you use the guide to help you understand what is required at a high level and plan for your integration.


When actually performing these tasks, you'll need to follow the instructions in the Amazon DevPay Developer Guide.

Make Business Decisions about the Product

First, you must understand the business aspects of DevPay and make some decisions about the business side of your product. For example, you must determine the pricing for the product, if you want to provide customer support, the contact information for the product, etc.

Related Topics in the Amazon DevPay Developer Guide

Register Your Product with DevPay

Once you've determined the business information about the product, you register your product with DevPay.

Note

Registration does not make your product visible to the world. Customers can't sign up for it until you advertise the purchase URL (which is where customers sign up). AWS doesn't automatically advertise it anywhere. For more information about advertising, see Advertise and Sell Your Product to the Public.

During registration, you provide the product's price, the product's description, any terms and conditions customers must agree to, contact information, and other product information. If your product uses Amazon EC2, you also specify which types of AMIs you want to sell and where (e.g., Linux/UNIX, Windows, in the U.S., Europe, etc.).

In return for registering your product, you receive three items:

  • The purchase URL for the product, which is where customers sign up for the product

  • A product code, which is an eight-character identifier for the product

  • A product token, which is a long value prefixed with the literal string {ProductToken}

You need these items when updating your web site and integrating your product with DevPay.

Note

After your register your product, it must be approved by AWS. Product approval typically occurs within one business day. During this time, you can begin integrating your product with DevPay. When the product is approved, the purchase URL becomes functional. However, customers still can't purchase your product until you advertise the purchase URL yourself. AWS doesn't automatically advertise the URL anywhere.

Related Topics in the Amazon DevPay Developer Guide

Prepare Your Amazon Payments Account

When you register your first DevPay product, we create an Amazon Payments Business Account for you. This account is associated with the login and password you used when you registered the product. In the documentation and elsewhere we refer to this account as your Amazon Payments account.

This task in the overall process of using DevPay covers a couple procedures that prepare your Amazon Payments account so it works with DevPay:

  • Required: Verify your e-mail address with Amazon Payments

  • Optional: Associate a bank account with your Amazon Payments account, and verify that bank account.

The instructions for these two tasks are covered as part of the product registration instructions (go to Registering Your Product in the Amazon DevPay Developer Guide). However, we call out the tasks separately here to emphasis their importance. If you don't verify your e-mail address with Amazon Payments, you can't use DevPay or Amazon Payments. If you don't associate a bank account with your Amazon Payments account and then verify that bank account, you can't withdraw money from your Amazon Payments account, and you can receive only up to $10,000 total each month from all your DevPay customers.

Note

If you start to approach the $10,000 limit during a given month, we'll send you e-mails that remind you to associate a bank account with your Amazon Payments account and then verify that bank account.

Related Topics in the Amazon DevPay Developer Guide

Integrate Your Product with DevPay

After you register your product, you can begin integrating the product with DevPay. The task varies based on whether your product uses Amazon EC2 or the Amazon Simple Storage Service.

Amazon EC2

If your product uses Amazon EC2, you simply associate your product code with each AMI that you want to sell. Amazon EC2 provides a command line function and an API function for this.

Related Topics in the Amazon DevPay Developer Guide

Amazon S3

If your product is a desktop or web product using Amazon S3, you complete the tasks in the following table.

Process to Integrate an Amazon S3 Product

1

You embed the product token in the code of the product so the token is easily retrievable when the product makes any AWS requests.

2

You update your application to call the License Service each time a customer signs up for the product (we provide a library for the License Service in the sample code). The License Service activates your product for use by that particular customer. Activation means you retrieve credentials required to make Amazon S3 requests on behalf of that customer.

3

You update your own Amazon S3 library or application to make Amazon S3 requests as required by DevPay. This involves:

  • Adding two new HTTP headers to the request

  • Adding the two new headers to the string that is the basis of the request's HMAC signature

We've provided a simple Amazon S3 library that includes these changes.


Related Topics in the Amazon DevPay Developer Guide

Update Your Product Support System (Optional)

If you want to restrict customer support just to those who are currently subscribed to your product, you can add a programmatic function that verifies your customers' status. Simply update your product support system to use the License Service. The service provides a function that returns the current subscription status of a customer.

Related Topics in the Amazon DevPay Developer Guide

Update Your Web Site

You need to update your web site to include information about your product, the purchase URL, contact information, and where customers can get information about their bills for your product.

Related Topics in the Amazon DevPay Developer Guide

Test Your Entire System

When testing, include your web site, your purchase pipeline, your product's integration with DevPay and the License Service, and your customer support system. Amazon DevPay does not provide a sandbox; therefore your testing is on your own live product (recall that the public doesn't know where to purchase your product until you tell them).

Related Topics in the Amazon DevPay Developer Guide

Make Any Changes to the Product

You might find during testing that you want to change the price or other information about the product. Make those changes now.

Related Topics in the Amazon DevPay Developer Guide

When you're ready to go into production, you make the purchase URL available to the public. AWS doesn't automatically advertise your product or purchase URL anywhere. It's up to you to do it.

To advertise an Amazon S3 application

  • Post information about the application in the Solutions Catalog on the AWS Developer Connection site.

To advertise an Amazon EC2 paid AMI

For information about co-marketing your product with AWS, go to the co-marketing area of the Developer Connection site.

Monitor Your Product's Usage and Get Paid

When customers start purchasing and using your product, you can view usage data and the corresponding revenue you expect to receive. This information is displayed on your DevPay Activity page (at http://aws.amazon.com/devpayactivity). When the monthly billing cycle occurs, your customers are billed for their usage and you receive their payments (minus the fixed DevPay transaction fee). Also, you're charged for the costs of the AWS service your product has used and the percentage-based DevPay fee. You can view your DevPay transaction history and your Amazon Payments account balance. You can also monitor how much of your expected revenue for a given month we've actually collected.