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

Desktop Product Exceptions

The following table lists several types of exceptions that your product must handle.

Exception Description How to Handle

Errors related to the activation key

When the product tries to activate itself, the activation key the customer provides could be expired, invalid, or incorrect. Activation keys expire one hour after creation.

For information about handling these situations, see Errors.

Invalid or expired user token

If the user token is invalid or expired, the Amazon Simple Storage Service returns an error.

Reactivate the product (see the following procedure).

Missing user token, Secret Access Key, or Access Key ID

When the product tries to retrieve the customer's credentials, any of them could be missing.

Reactivate the product (see the following procedure).

Authentication Error

When AWS authenticates an Amazon S3 request, an authentication error could occur (e.g., if the wrong key is used or the credentials are corrupted).

Reactivate the product (see the following procedure).

If at any time the product consistently receives an error, the product should attempt to reactivate itself.

Reactivating the Product

Your product must be prepared to reactivate itself when certain exceptions listed in the preceding table occur.

To reactivate the product

  1. Prompt the customer to go to the activate URL to get a new activation key (for an example of this page, see The Application Activation Page).

  2. Prompt the customer for the new activation key.

  3. Request ActivateDesktopProduct with the new activation key and other required parameters.

  4. Delete the old user token, Secret Access Key, and Access Key ID for that customer.

  5. Store the new user token, Secret Access Key, and Access Key ID appropriately and use them for future Amazon S3 requests for that customer.