Amazon Simple Pay
Advanced User Guide (API Version 2010-08-28)
AWS Documentation » Amazon Simple Pay » Advanced Guide » Working with Amazon Simple Pay Buttons » Working with Subscription Button Advanced Features » Modifying Subscriptions
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Modifying Subscriptions

If you offer a variety of subscriptions, subscribers might want to upgrade or downgrade them. For example, if your service offers stock market reports, a subscriber might like to upgrade to a subscription that offers more reports.

The Amazon Simple Pay system does not directly support the modification of an active subscription, but there is a way to offer this functionality. You can create a new subscription using Amazon Simple Pay and then use the Amazon Flexible Payments Service CancelSubscriptionAndRefund API to cancel the current subscription.

Modifying a Subscription using CancelSubscriptionAndRefund

1

Create a modify subscription button that sends the same request that the subscription button sends.

All your buttons should have a unique value for the referenceID parameter. The response to your subscription request contains this value. Pairing the value for referenceID with the ID of the subscriber enables you to detect a subscription modification.

2

Parse the subscription modification response. If Amazon Payments returns success, and if it represented a modification, send a CancelsubscriptionandRefund request to cancel the old subscription.

In the CancelsubscriptionandRefund request, you also have the option of including a refund using the refundAmount parameter. This parameter can equal zero, and in the case of a modification, it likely will. For more information, see CancelSubscriptionAndRefund.

3Amazon Payments sends email messages for the creation of the new subscription as well as the cancellation of the older subscription to both the subscriber and seller.

Document Conventions
Terms of Use		Did this page help you?  Yes  No   Tell us about it...