Creating a Subscription Button

To generate the HTML for a subscription button

	Note
	You can set several of the fields in the form to default values using your seller preferences. For more information, see Configuring Default Button Values

1. Go to http://payments.amazon.com and log into your Amazon Payments Business Account. For more information, see Before You Begin.

2. From here, go to https://payments.amazon.com/sdui/sdui/subscriptionbutton to show the Amazon Simple Pay > Subscriptions page, which contains the following form for you to fill in.

   	Note
   	To create a button in the sandbox, go to https://payments-sandbox.amazon.com/sdui/sdui/subscriptionbutton instead.

   

3. Use the following table to fill in the entry fields that are shown in the figure.

   	Tip
   	You can also hold the mouse pointer over most fields of the online form to display usage tips in the right side of the form.

   Field	Action
   Charge	Enter the subscription payment, how often the subscriber will be charged, and the duration of the subscription, respectively. There is maximum of two decimal places in the Charge amount field. Note Payments will occur on the closest valid day for the subscription period. For example, for a monthly subscription, a payment on 2009-01-31 is followed by a payment on 2009-02-28. The same holds true for annual subscriptions. A payment on 2008-02-29 is followed by 2009-02-28. Corresponds to the amount field in the button html.
   Description	Describe this subscription for the subscriber. You can include the HTML tags to format your text: <b>, <i>, <u>, <ul>, <li>, <br>, <em>, <strong>, and <strike>. Amazon Simple Pay ignores all other HTML tags. Corresponds to the description field in the button html.
   Subscription Start Date	Optionally enter the starting date of the subscription. This field contains the date when Amazon will begin charging for the subscription. Important If you set a date in the future, you are providing a free trial period. Amazon will create the subscription immediately, but begin charging on the subscription start date. Corresponds to the recurringStartDate field in the button html.
   Reference ID	Optionally enter an ID for your records that uniquely identifies this subscription. Corresponds to the referenceId field in the button html.
   Return URL	Enter the URL where you will redirect subscribers after they complete the subscription payment. This field overrides the setting in Your Account > Edit My Account Settings > Manage Developer and Seller Preferences, as described in How to Configure Default Button Values.. Corresponds to the returnUrl field in the button html.
   Cancel URL	Optionally, enter the URL where senders should be redirected if they cancel their transaction. This field overrides the setting in Your Account > Edit My Account Settings > Manage Developer and Seller Preferences, as described in How to Configure Default Button Values.. Corresponds to the abandonUrl field in the button html.
   URL for Instant Payment Notification (IPN)	Optionally, type the URL of your host page to which Amazon Payments should send the IPN transaction information. This is an advanced feature. For more information, see Using Instant Payment Notification. This field overrides the setting in Your Account > Edit My Account Settings > Manage Developer and Seller Preferences, as described in How to Configure Default Button Values.. Corresponds to the ipnUrl field in the button html.
   Immediate Return	Optionally, if you want to skip the final status page in Amazon Payments, select this check box. If you select this option, you can parse the return values and display a final status page to the user yourself. For more information, see Using Immediate Return . Corresponds to the immediateReturn field in the button html.
   Collect the shipping address?	If you want Amazon Payments to return the buyer's shipping address as part of the transaction information, select this check box. Corresponds to the collectShippingAddress field in the button html.
   Allow trial period	If you want to provide an introductory subscription price, select this check box. Use the Charge, every, and for fields to specify the trial period and its costs. For example: Charge 1.00. every 1 month for 1 months. In this example, the introductory price, $1.00, is for the first month of the subscription only. Note that there is maximum of two decimal places in the Charge field. Corresponds to the noOfPromotionTransactions and promotionAmount fields in the button html.
   Your website background	Select the type of button background you need. The white option sets a white background. The color option produces a button with a transparent background (that is, your website theme colors will show).
   Button Type	Select the subscription button image you want to appear on your website. Corresponds to the src attribute for the image in the button html.

4. Click Generate HTML. Amazon Payments produces the application-specific HTML form for the subscription button, and displays it in the text area underneath the Generate HTML button. Typical HTML for a subscription button is shown in Subscription Button HTML Components

   Copy the HTML and paste it in the appropriate page on your website. It will be displayed on the web page as a Pay Now button.

5. When you have finished copying the generated HTML, you can clear the Amazon Simple Pay Subscription Creation Page user interface by clicking the Create Another Widget button. The form clears, and you can create another subscription button.

   	Note
   	You can continue to create as many subscription buttons as you need using this procedure. However, if you plan to add more than one button to a single web page, there are implementation issues for you to consider. For more information, see Creating More than One Button per Page.

   	Important
   	You are notified each time a subscriber starts a subscription request. For more information, see Getting Notification about Your Payments. Subscribers can use their Amazon Payments account at payments.amazon.com to track information about subscriptions they have purchased.