Creating a Checkout Button (HTML Integration)
Checkout by Amazon has been discontinued Announcement: Checkout by Amazon (CBA) was discontinued effective April 1, 2017. To learn about migrating from Checkout by Amazon to Login and Pay with Amazon, read our FAQ. |
The easiest way to use Checkout by Amazon is to place a Checkout button on your website. This button enables your customers to buy the items you are selling. You can create a Checkout button by using the Create Checkout Button feature, which prompts you for information about your item, and then creates the code for the button. After you generate the button code, you paste the code for the individual button onto your website.
When a customer clicks the Checkout button to purchase an item, the following occurs:
- An order is created containing just that one item (no multiple items per order).
- The checkout process is started, so the customer can choose the payment method and shipping address.
- When the order is confirmed by the customer, the payment method is charged and you can view and manage the order on the Manage Orders page. If you have set up a custom pop-up "Thank you" page, your customer also sees a "Thank you" message. See Creating a Custom Pop-up Thank You Page for more information.
Checkout by Amazon can provide an even faster way to check out, with 1-Click. Your customers can click the Checkout button and instantly complete the purchase, with no need to go through the checkout pipeline.
Note:
- The Checkout button is HTML code that sets up a button image and also describes the item, including its SKU, price, title, shipping and tax rates, and promotions. You can generate the Checkout button automatically by using the Create Checkout Button feature, or you can create the button yourself by following the button creation requirements.
- Only the title and price are required for seller-fulfilled orders. If you are signed up to use Fulfillment by Amazon, you must also supply a SKU for orders that are fulfilled by Fulfillment by Amazon.
To use Checkout buttons, you first create them and then paste the button code into your website. As an optional step, you can also test your Checkout buttons to be sure that they work correctly.
Note: If you are simply selling items on your website, creating the Checkout buttons with the Create Checkout Button feature is probably your best choice. If you want to customize the Checkout buttons, then you need to understand the Checkout button requirements. See Integration Methods for more information.
The Create Checkout Button feature is a handy tool when you are selling just a few items whose price and other details do not change often. If you are selling many items, or you change the information often, you might want to consider automating your button creation. See Integration Methods for more information.
Creating the Button
You can create a Checkout button by using the Create Checkout Button feature on the Integration link. The Create Checkout Button feature walks you through the steps to create a button. First, you pick a style of button. Then, you describe your item. Finally, you click to create your button, and paste the resulting code into your website.
Button Styles
When you create a button, you can select the button color and size, and pick a button that matches your website background the best.
You can create a button that sells just one item, or a button that lets your customer select a variation, such as a red, blue, or green shirt.

Button Information
When you create a button, you need to know the following information for each item:
Element | Definition | Example |
---|---|---|
Item Title | The name or brief description of your item. The Item Title is mandatory. | Red Shirt, XL Soccer ball, Acme brand |
Seller SKU | The SKU (stock-keeping unit): an ID created and managed by the seller. Each item you sell must have a unique SKU, which can be from 1 to 64 characters long. The SKU is optional, unless you are using Fulfillment by Amazon to fulfill your orders. If this is the case, then SKU is mandatory. | MSHRT-RED-XL A101-01B |
Price | Cost for the item, expressed as dollars and cents. It must include the period and two-digit decimal value, even if the value is zero (".00"). No currency sign or commas are allowed. The Price is mandatory. | 29.00 9.04 1249.39 |
Weight | The weight of the item expressed as pounds. This is used to calculate shipping costs. | 3 |
Description | The item details. You can use the same information as the item detail that you show on your website. | Natural cotton makes this shirt a great choice for an outdoor lifestyle. A rugged boot with real leather top and synthetic sole. Comes in Men's sizes 8-13, B - EEE. |
Fulfilled by Amazon | If you fulfill (pick, pack, and ship) this item yourself, leave this box blank. If you have signed up for Fulfillment by Amazon and Amazon fulfills this item, then check this box. Note: This column appears only if you are signed up to use Fulfillment by Amazon with your Checkout by Amazon orders. |
When you click the button to create the Checkout button, you get a block of code to paste into your website. You need one set of code for each button you want to use. You cannot re-use the existing code from one button for any other item on your website, unless you want to sell the same item in more than one place.
Resulting code
<script type="text/javascript"
src="https://images-na.ssl-images-amazon.com/images/G/01/cba/js/jquery.js"></script>
<script type="text/javascript"
src="https://images-na.ssl-images-amazon.com/images/G/01/cba/js/widget/devo/widget.js"></script>
<form method=POST action="https://payments.amazon.com/checkout/AEIOU1234AEIOU">
<input type="hidden" name="order-input"
value="type:cba-signed-order/sha1-hmac/1;order:
PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLTgnPz48T3JkZXIgeG1sbnM9J2h0dHA6
Ly9wYXltZW50cy5hbWF6b24uY29tL2NoZWNrb3V0LzIwMDgtMDYtMTUvJz48Q2FydD48SXRlbXM+
PEl0ZW0+PE1lcmNoYW50SWQ+QTM2Vk9MSzY2UDgzMVc8L01lcmNoYW50SWQ+PFRpdGxlPlJlZCBT
aGlydDwvVGl0bGU+PFByaWNlPjxBbW91bnQ+MTkuOTk8L0Ftb3VudD48Q3VycmVuY3lDb2RlPlVT
RDwvQ3VycmVuY3lDb2RlPjwvUHJpY2U+PFF1YW50aXR5PjE8L1F1YW50aXR5PjxGdWxmaWxsbWVu
dE5ldHdvcms+TUVSQ0hBTlQ8L0Z1bGZpbGxtZW50TmV0d29yaz48L0l0ZW0+PC9JdGVtcz48L0Nh
cnQ+PC9PcmRlcj4= ;signature:nkF7jX88/JR+cT+C4xte3W1VyZk=">
<input alt="Checkout
with Amazon Payments"
src="https://payments.amazon.com/gp/cba/button?ie=UTF8&color=orange&background=white&size=medium"
type="image"> </form>
Note: When you click the button to create the Checkout button code, the resulting code is unique to that combination of button style and item information, and the code is not saved anywhere. You must copy the code before you leave the page or perform another task, or you will lose the code and must start over.
Before you create a Checkout button, be sure you have selected your Production website from the Website drop-down box.
Detailed Steps for Creating a Checkout Button
- In Seller Central, on the Website drop-down list (the light blue bar at the top), click Your Checkout Website. Selecting Your Checkout Website creates a production button. Selecting Your Checkout Website (Sandbox) creates a testing button. You should always verify that you are creating the right type of button.
- Click Integration, and then click Create Checkout Button.
- Under Choose a color for the button, select the color you want, orange or tan.
- Under Indicate your website background, select the type of background on which you will place the button on your site. Pick "white" if your website background is white; pick "other" if your website background is set to any other color.
- Under Choose a size for the button, select either the small or the medium size.
- Under Describe your item, enter the appropriate product information, including the Item Name, the Seller SKU, the Price, the Item Description, and the Item Weight.
- (Optional) If you are selling an item with variations (such as a shirt that comes in Red, Green, or Blue), click the Add item variations button. You can add item descriptions for each item variation that you add. If you add too many variations, just click the Delete button next to the item that you do not want. If you want to add more variations, click the Add item variation button again.
- (Optional) If you want to set specific promotion values or shipping costs for this button, click the plus sign [+] next to Click here if you want to override your default settings for promotions and shipping to set up Promotions and Shipping costs for this specific item. You do not have to set these; if you leave these blank, your global settings in Seller Central for promotions and shipping will apply to the sale of this item. To modify your global settings, click Settings in Seller Central, click Manage Promotions, Manage Taxes, and Shipping Settings, and follow the prompts.
- Click the Create Checkout button to generate the HTML code.
- (Optional) Click the Click here to preview your Checkout button link to see an example of how the button will look on your website.
- In the Now add the button code to your website section, click the box to select the code, copy it to your Clipboard, and then paste it to the website where you want the button to appear.
Advanced Options for Checkout
By default, when customers click a Checkout button, the resulting order uses the default promotions, shipping costs, item weight, and tax settings for all items on your site.
If these default settings are not what you want for an individual item, you can override them with the Checkout button advanced options. These options let you choose a unique promotion type, set a fixed shipping cost, and specify the item weight.
Note: While Amazon Payments is providing you a means to determine and apply sales taxes to your transactions, we do not warrant that these tax amounts will fully satisfy your sales and use tax reporting obligations. For a final determination on these matters, please seek assistance from your tax advisor.
You can override your default shipping rates with the advanced options. These settings change your shipping cost for the entire shipment. There is no per-item shipping rate.
You can set these advanced options when you create the Checkout button.
Setting the Checkout Button Options
- In Seller Central, click Integration, and then click Checkout Button.
- Select your button color, website background, and size for your button.
- Click the "+" (plus) sign next to Click here if you want to override your default settings for promotions, shipping, and taxes.
- Click the radio button next to Promotion or Shipping Cost to select the option you want, and enter the desired information. The advanced shipping option allows you to specify a set shipping amount for the item. You cannot set a specific weight-based shipping rate using the Checkout button advanced option.
- Click Create Checkout button and then paste the resulting code into your website.
Building and Testing a Checkout Button in the Sandbox
Before you start accepting orders with your Checkout buttons, it is a good idea to test the buttons to be sure that they work correctly. When you test the buttons, verify the following:
- The button initiates the Checkout process, going from product selection to the checkout process.
- The button buys the right item, with the right Item Name, Price, SKU, and Weight.
- If you have multiple Checkout buttons for an item (for example, for a shirt that comes in three sizes), all of the options select the right item.
- If you have advanced options on the button, the button calculates the amount correctly for promotions, shipping cost, tax rate, and item weight.
A good way to test the button is to use the Sandbox, a safe place to test orders that do not accrue charges. This means you can use your credit card to create test orders and go through the checkout pipeline to be sure everything works correctly, but your credit will not be charged for the order.
- At the top of the Seller Central menu bar, click the Choose Website drop-down box and select Your Sandbox Website.
- Enter your product information as normal for your button.
- Click Create Checkout button and paste the resulting code onto the page you want to use for testing. Note that you should keep your testing pages hidden from public view.
- View the webpage with the test Checkout button, and use the button to create orders.
Note: If you use Sandbox buttons to create test orders, be sure to replace them with Production buttons when you are done testing. Otherwise, your customers will click your Checkout buttons, trying to place orders, but their credit cards will never be charged and you will never be paid for any order. To switch to the Production Create Checkout Button feature, simply click the Choose Website drop-down box and click Your Checkout Website.