Page 1

Standard Checkout Button Creation Wizard Implementation Guide

U.S. Version 2010-09-15


2 | Checkout by Amazon | Introduction


Checkout by Amazon | TOC | 3

Contents Overview of Checkout by Amazon...................................................................................................................... 5 Who Should Read This Document...........................................................................................................5 Prerequisites............................................................................................................................................. 5 Your Tasks When Using Checkout by Amazon...................................................................................... 5 Other Documentation............................................................................................................................... 5 What's New in This Document.................................................................................................................6

Chapter 1: Setting Up Your Checkout by Amazon Account.......................7 Signing Up for Checkout by Amazon...................................................................................................... 8 Logging In to Your Checkout by Amazon Account................................................................................ 8 Log In to Seller Central................................................................................................................ 8 Your Sandbox and Production Settings................................................................................................... 9 Switching Between Production and the Sandbox...................................................................... 11 Your Account and Your Info & Policies................................................................................................11 Set Up Your Account Settings................................................................................................... 11 Set Up Your Info & Policies Settings........................................................................................ 13 Your Checkout Pipeline Settings........................................................................................................... 14 Set the Return URLs.................................................................................................................. 15 Toggle the Shopping Cart Security............................................................................................ 15 Set the Integration URLs............................................................................................................15 Set the Order Report Type and Frequency.................................................................................16 Basic Seller Central Settings for Shipping, Taxes, and Promotions...................................................... 16 Set Your Seller Central Shipping Rates..................................................................................... 16 Set Your Seller Central Tax Rates............................................................................................. 17 Set Your Seller Central Promotions........................................................................................... 17 Setting User Permissions for Your Seller Central Account................................................................... 18 Step One: The Account Manager Sends the Invitation.............................................................. 18 Step Two: The User Receives a Confirmation Code................................................................. 18 Step Three: The User Accesses Seller Central and Creates an Account....................................18 Step Four: The Account Manager Sets User Permissions..........................................................19 Setting Up Your E-mail Whitelist.......................................................................................................... 19 Set Up Your Whitelist................................................................................................................ 19 Setting Up Your Buyer (Testing) Account............................................................................................ 20 Set Up Your Buyer (Testing) Account.......................................................................................20 Set Up PayPhrase for Your Buyer Account............................................................................... 21 Enabling PayPhrase on Your Website................................................................................................... 22

Chapter 2: Integrating with Checkout by Amazon.................................... 23 Steps to Integrating Checkout by Amazon with Your Website ............................................................ 24 Sandbox Setup........................................................................................................................................24 Create a Sandbox Checkout Button........................................................................................... 24 Place the Sandbox Checkout Button Code on Your Test Web page......................................... 25 Test Your Sandbox Button by Placing a Test Order.................................................................. 26 Production Setup.................................................................................................................................... 27 Create a Production Checkout Button........................................................................................ 27 Place the Production Checkout Button Code on Your Test Webpage....................................... 28 Test Your Production Button by Placing a Test Order.............................................................. 30 Cancel Your Test Production Order...........................................................................................31 Place the Production Checkout Button Code on Your Live Webpage...................................... 31


4 | Checkout by Amazon | TOC

Chapter 3: Handling Settlements................................................................. 33 Chapter 4: Post-Setup Exit Criteria.............................................................35 Exit Criteria............................................................................................................................................ 36

Appendix A: Button Styles............................................................................37 White Background..................................................................................................................................38 Light Background...................................................................................................................................39 Dark Background................................................................................................................................... 40


Overview of Checkout by Amazon Welcome to the Standard Checkout - Button Creation Wizard Guide. This section describes who should read this guide, how the guide is organized, and other resources related to Checkout by Amazon.

Who Should Read This Document This document gives you the information and steps you need to integrate your website with Checkout by Amazon. Before you begin integration, you must decide what method you will use to integrate: using the Create Checkout Button page in Seller Central, using HTML-based code you build yourself, or using XML-based code you build yourself. • • •

If you want to integrate building your own XML-based code, then please download and read the Standard Checkout - XML Implementation Guide. If you want to integrate building your own HTML-based code, then please download and read the Standard Checkout - HTML Implementation Guide. If you want to use the Create Checkout Button page, then please continue reading this document.

Prerequisites This guide assumes you--or your development staff--can manage simple editing of HTML-based web pages. Before you can use Checkout by Amazon, your systems must meet the following prerequisites: •

You must create your shopping cart using HTML (you'll copy and paste the code from the Create Checkout Button page in Seller Central).

Your Tasks When Using Checkout by Amazon You have four basic tasks to accomplish when using Checkout by Amazon on your site: 1. 2. 3. 4.

Set up your Checkout by Amazon account. Complete your Seller Central settings. Integrate your site with Checkout by Amazon. Test and sign off your integration.

The rest of this document discusses how to accomplish these tasks.

Other Documentation You can read our downloadable PDFs to understand more about Checkout by Amazon. More Resources for Checkout by Amazon Resource

Audience, Purpose, and Goals

Getting Started Guide

For merchants who want to use a simple, step-bystep approach in setting up Checkout by Amazon on their websites. The Getting Started Guide walks


6 | Checkout by Amazon | Overview of Checkout by Amazon

merchants through the process, from gathering the required information for signing up for an account to setting up a button on their websites. Standard Checkout - Button Creation Wizard Implementation Guide Standard Checkout - HTML Implementation Guide Standard Checkout - XML Implementation Guide

For merchants and developers who want a detailed list of ways to integrate their website with Checkout by Amazon. The Implementation Guide provides the information needed for programming and code development. Note that there are three versions of this document: one for those who just want to paste the button code built using the Create Checkout Button feature in Seller Central, one for HTML-based code, and one for XMLbased code.

Using Seller Central

For merchants who want an overview of Seller Central.

Best Practices Guide

Tips for setting up your website to use Amazon Payments, with advice for planning, setting up, and day-to-day operations.

Managing Orders

A guide to assist you in the day-to-day operations for managing orders generated by Checkout by Amazon.

What's New in This Document Table of Changes Ver

Date

Changes

1.4

2010-10-11

Added information about using Checkout by Amazon on mobile-optimized websites.

1.3

2010-09-15

Revisions for updated checkout functionality.

1.1

2010-06-30

Revisions for Amazon Payments site functionality.

1.0

2010-02-14

Initial release.

Copyright Š 2010 by Amazon.com, Inc, or its affiliates.


Chapter

1 Setting Up Your Checkout by Amazon Account Topics: • • • • • •

• • • •

Signing Up for Checkout by Amazon Logging In to Your Checkout by Amazon Account Your Sandbox and Production Settings Your Account and Your Info & Policies Your Checkout Pipeline Settings Basic Seller Central Settings for Shipping, Taxes, and Promotions Setting User Permissions for Your Seller Central Account Setting Up Your E-mail Whitelist Setting Up Your Buyer (Testing) Account Enabling PayPhrase on Your Website

You have six required tasks (and two optional, but recommended, tasks) when you initially set up your Checkout by Amazon account on Seller Central. In this section you'll learn about the following required tasks: 1. 2. 3. 4. 5. 6.

Sign up for your Checkout by Amazon account. Switch between the Production and Sandbox modes. Set up your Info & Policies. Set up your Checkout Pipeline Settings. Set up your basic settings for Shipping Rates, Tax Rates, and Promotions. Set up your Buyer (testing) Account.

You'll also learn about the following optional, but recommended, tasks: 1. Set up your Role-based Permissions. 2. Modify your e-mail client's whitelist to accept e-mail from Amazon Payments.


8 | Checkout by Amazon | Setting Up Your Checkout by Amazon Account

Signing Up for Checkout by Amazon To get started integrating your website with Checkout by Amazon, you must first sign up for your Checkout by Amazon account. If you have not already signed up for Checkout by Amazon, please download and read the Getting Started Guide for Checkout by Amazon. It contains the information you need and steps to follow.

Logging In to Your Checkout by Amazon Account After you've signed up for your account, you use your account credentials (your e-mail and password) to sign in to Seller Central to manage your account. Seller Central is the "homepage" for your account. It's where you set up your basic settings for your account, such as your info & policies, or your checkout pipeline experience, and so on. In Seller Central, you can perform the following actions: • • • • •

Switch between the Sandbox and Production View and fulfill orders Create a Checkout with Amazon button View your payments Edit your account settings

Log In to Seller Central You log in to Seller Central when you want to manage orders, view reports, or manage your account settings. Note: You can also manage orders and view reports programmatically. For more information about how to do so, please see Managing Orders. Follow these steps to log in to Seller Central: 1. Go to https://sellercentral.amazon.com. You'll see the Seller Central log-in page:


Checkout by Amazon | Setting Up Your Checkout by Amazon Account | 9

Figure 1: The Seller Central Log-in Page 2. Enter your Seller Central account credentials (the e-mail and password you used to sign up for the Checkout by Amazon account). 3. Click Sign in. You'll see the Seller Central home page:

Figure 2: Seller Central Home Page For more information about using Seller Central, please download and read Using Seller Central.

Your Sandbox and Production Settings After you have signed in to Seller Central you are ready to edit your account settings.


10 | Checkout by Amazon | Setting Up Your Checkout by Amazon Account

However, before you begin setting up your account, it's important for you to understand that there are two basic methods of operation, Sandbox and Production. • •

You use the Sandbox for testing your setup and your code. Nothing you do in the Sandbox generates paid orders. You use Production to generate orders. Anything you do in Production is treated as a real order--you must either fulfill or cancel all Production orders within 30 days.

The basic difference between the Sandbox and Production is that anything you do in the Sandbox cannot generate an order that is charged to a payment method. That is, you can "buy" an item in the Sandbox mode, but the credit card you use to buy the item can never be charged for the item. If you buy an item in Production, you are placing a real order that must be either fulfilled or canceled--that is, you must either ship it or cancel the order. Important: You cannot use your merchant account (the account you use to sign in to Seller Central) to place an order in Production. If you want to place orders in Production so you can test the end-to-end experience and make sure your fulfillment systems are working, you must create and use a separate "buyer" account. See Setting Up Your Buyer (Testing) Account on page 20 for more information about setting up and using a buyer account. This table illustrates the functions available in the Sandbox and in Production. Table 1: Functions Available in the Sandbox and in Production Function

Sandbox

Production

Notes

Generate orders

Yes

Yes

Build functional* Checkout buttons

Yes

Yes

"Functional" here means that you can click the Checkout button and go through the order pipeline.

Create an order using a payment method

Yes

Yes

You can use your payment method in the Sandbox, but your payment method will never be charged.

View orders

Yes

Yes

All orders in the Sandbox are marked as "Pending."

Fulfill orders

No

Yes

All orders in the Sandbox are marked as "Pending"; you cannot fulfill "Pending" orders.

Give feedback on an order

No

Yes

Cancel an order as a customer

Yes

Yes

Cancel an order as a merchant

No

Yes

Have a payment method charged for an order

No

Yes

View and download order-related reports

No

Yes

When you set up your account, you must set up your Sandbox and Production settings separately. To set them up, you must switch between Production and Sandbox mode in Seller Central. Note:


Checkout by Amazon | Setting Up Your Checkout by Amazon Account | 11

When you first set up your Checkout by Amazon account, you are in the Production mode. You must explicitly switch to the Sandbox mode. The mode you pick (Production or Sandbox) is "sticky"; that is, if you select a mode, log off from Seller Central, and then log in again, you return to the same mode.

Switching Between Production and the Sandbox Follow these steps to switch between Production and the Sandbox 1. Locate the Website drop-down box near the top left:

Figure 3: The Website drop down box 2. Click the Website drop-down box to display the available websites:

Figure 4: The Website drop down box displaying the available websites 3. To select the Production mode, click Your Checkout Website. 4. To select the Sandbox mode, click Your Checkout Website (Sandbox).

Your Account and Your Info & Policies Your Checkout by Amazon account has two separate account settings that you set up before you accept your first order: • Your Account Settings: Used to set up your account settings we use to transact business with with you, such as your business name or your bank account information. • Your Info & Policies Settings: Used to set up the information your customers see about you, such as your refunds and return policy Note: Be sure you switch to the correct mode before you change these settings. To learn more about switching between modes, please see Your Sandbox and Production Settings on page 9 in this document.

Set Up Your Account Settings The Account Information page lets you change the following options:


12 | Checkout by Amazon | Setting Up Your Checkout by Amazon Account

Notification Options • • • • •

Order notifications Out-of-stock notifications Business updates Claims notifications (e-mail address) Technical notifications (e-mail address)

Business Information • • • • •

Your business display name Your business legal name Customer service e-mail Customer service reply-to e-mail Customer service phone number

Business Profile • • • • • •

Type of ownership Business category Website URL Date established Estimated $ volume / month Average transaction $ amount

Bank Account Information Important: It is critical that you enter your bank account information in your Account Settings page in Production-we cannot pay you unless you set up a valid U.S.-based checking account. Important: Amazon Payments may require that you maintain a minimum balance (or reserve) in your account to secure the performance of your payment obligations. Please see the Amazon Payments Reserve Policy topic for information on how this reserve is calculated and managed. Note: Changing your Bank Account information will start an automatic 14-day hold on disbursements. See How often am I paid? for more information. Credit Card Information (select or update only) Note: You can view but not change the information in the Credit Card section. If you want to change your credit cart information or add a new credit card, you do so on the Amazon.com site by going to https://www.amazon.com/ gp/css/account/cards/view.html and following the instructions on that page. Follow these steps to set up your account settings: 1. Verify that you have selected the correct mode, Production or Sandbox. Note: Be sure you switch to the correct mode before you change these settings. To learn more about switching between modes, please see Your Sandbox and Production Settings on page 9 in this document. 2. In Seller Central, click Settings > Account Info. The Account Info page appears:


Checkout by Amazon | Setting Up Your Checkout by Amazon Account | 13

Figure 5: The Account Info page 3. Under Notification Options, verify that Order Notifications and Out-of-stock Notifications are enabled. If notifications are not enabled, click the Edit button in the Notification Options section, enable the notifications, and click Update. 4. Verify that your information is correct for your Business Information, your Business Profile, your Bank Account Information and your Credit Card Information. To change the information, click the Edit button in the appropriate section, make the necessary changes, and click Update.

Set Up Your Info & Policies Settings The Your Info & Policies page lets you change the following attributes about your company. This information appears in the checkout pipeline: Page link

Used for

About Seller

Tell your customer about yourself.

Seller Logo

Add your company logo 120 x 30 pixels (GIF, JPG, or PNG).

Returns & Refunds

Describe your returns and refund policy.

Shipping

By default, your shipping costs page in the checkout pipeline shows your shipping costs (from Seller Central Manage Shipping). However, you can use this page to describe more about your shipping policies.

Privacy Policy

Describe your privacy policy.

Frequently Asked Questions

List any frequently asked questions and answers you might have.


14 | Checkout by Amazon | Setting Up Your Checkout by Amazon Account

Page link

Used for

Custom Help Pages

Add any additional help pages you'd like customers to see if they want more information within the checkout pipeline. Important: Changes you make to the pages on the Your Account & Policies page take about 24 hours to appear.

Follow these steps to set up your Info & Policies settings. 1. Verify that you have selected the correct mode, Production or Sandbox. Note: Be sure you switch to the correct mode before you change these settings. To learn more about switching between modes, please see Your Sandbox and Production Settings on page 9 in this document. 2. In Seller Central, click Settings > Your Info & Policies. The Your Information & Policies page appears:

Figure 6: The Your Information Page 3. For each section in the Your Information & Policies page, click the link to that page, enter the information, and click Save. Note that if you don't see a page you want, you can create Custom Help Page with the content you specify.

Your Checkout Pipeline Settings With Checkout by Amazon, you can set the following options for your checkout pipeline: • Set the URL for successful payments (the page on your site where customers land after completing their purchase). • Set the URL for canceled payments (the page on your site where customers land if they cancel the order before completing their purchase).


Checkout by Amazon | Setting Up Your Checkout by Amazon Account | 15

• •

Set the URL for your customers' account information (the page on your site where you show customers their account information) Set whether you want to accept only signed carts (carts with a calculated signature).

Set the Return URLs Follow these steps to set the three Return URLs. Note: The Your Account Return URL points to a location on your site where you display information to your customers about their accounts. Customers can go to the Amazon Payments Your Account page (https:// payments.amazon.com/sdui/sdui/overview) to see their order status for all payments made using Checkout by Amazon anywhere on the internet. 1. In Seller Central, click Settings > Checkout Pipeline Settings. The Checkout Pipeline Settings page appears. 2. Click the first Edit button on the page (the one immediately under the Instant Order Processing Notification Settings heading). 3. In the Successful Payment Return URL box, type the URL you want to send your customers to after they successfully complete payment. 4. In the Cancel Payment Return URL box, type the URL you want to send your customers to if they cancel the order before they successfully complete payment. 5. In the Your Account Return URL box, type the URL on your you want to send your customers to when they want to inquire about their account. 6. Click Update.

Toggle the Shopping Cart Security Follow these steps to toggle your shopping cart security setting. Note: You can choose to accept signed carts whether you integrate using the Checkout buttons created in Seller Central, HTML-based Checkout buttons, or XML-based Checkout buttons. If you use Checkout buttons created in Seller Central and you toggle the security settings (below) to accept only signed carts, the buttons you create in Seller Central are automatically signed. 1. In Seller Central, click Settings > Checkout Pipeline Settings. The Checkout Pipeline Settings page appears. 2. Click the first Edit button on the page (the one immediately under the Instant Order Processing Notification Settings heading). 3. Next to Shopping Cart Security, click the Accept only digitally signed XML shopping carts check box to set the checkmark (accept only signed carts) or to clear the checkmark (accept all carts). 4. Click Update.

Set the Integration URLs If you (or your integrator/developer) are using the Instant Order Processing Notifications, you must specify where you want these notifications to go. You can send them to your own website or to your integrator's website. Note: Choose either your own website or your integrator's website, but not both, or else you will get multiple order processing messages


16 | Checkout by Amazon | Setting Up Your Checkout by Amazon Account

1. In Seller Central, click Settings > Checkout Pipeline Settings. The Checkout Pipeline Settings page appears. 2. Click the first Edit button on the page (the one immediately under the Instant Order Processing Notification Settings heading). a) In the Merchant URL box, type the URL (on your website) where you want notifications to be sent. b) Or, in the Integrator URL box, type the URL (on your integrator's or developer's website) where you want notifications to be sent. 3. Click Update.

Set the Order Report Type and Frequency You can set your order report type and frequency in Seller Central to match your needs. 1. In Seller Central, click Settings > Checkout Pipeline Settings. The Checkout Pipeline Settings page appears. 2. Click the second Edit button on the page (the one immediately under the Order Reports Setting heading). The Order Reports Setting page appears. 3. Next to Order Report Type, click the radio button for the type of report you want. If you are working with an integrator, they will give you the correct format to choose. 4. Next to Order Report Schedule, pick the frequency of your reports. 5. Click Update.

Basic Seller Central Settings for Shipping, Taxes, and Promotions Your Checkout by Amazon account uses Seller Central to manage basic settings for shipping rates, tax rates, and promotions. The rates and options you set in Seller Central determine what shipping rates, tax rates, and promotions apply to orders processed using Checkout by Amazon. If you do not otherwise set these values (whether in the button code you build using overrides or by using callbacks), these values will be used to calculate shipping, tax, and promotional discounts. There are a few default settings already applied when you first create your Checkout by Amazon account, but it's a good idea to review them to be sure that you know what to expect when you begin accepting orders. Important: If you are planning to programmatically control these rates and settings (using overrides, callbacks, or third-party cart management solutions), it's still a good idea to review these options, because if Checkout by Amazon can't process the overrides you supply programmatically, the defaults set in Seller Central will be used as a backup.

Set Your Seller Central Shipping Rates Follow these steps to review and set your Seller Central Shipping Rates: 1. In Seller Central, go to Settings > Shipping Settings. The Shipping Settings page appears, showing your current shipping rates. 2. You can change the following options: • Set your shipping model (per-item/weight-based or price-banded) • Edit your shipping regions and service levels • Set your shipping rates Tip: For complete information about setting shipping rates, please see Configure Shipping Rates & Restrictions in Seller Central.


Checkout by Amazon | Setting Up Your Checkout by Amazon Account | 17

Note: For more fine-grained shipping rates, you can use overrides or callbacks. Shipping rates you set in overrides or callbacks replace existing rates set in Shipping Rates in Seller Central.

Set Your Seller Central Tax Rates DISCLAIMER: 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. Follow these steps to review and set your Seller Central Tax Rates: 1. In Seller Central, go to Settings > Manage Taxes. The Manage Sales Taxes page appears, showing your current tax rates. (There are no default tax rates set up.) 2. You can change the following options: • Set a tax rate for all national sales • Set a tax rate for an individual state or District of Columbia Tip: For complete information about setting tax rates, please see Tax Settings in Seller Central. Note: You can set tax rates only at the state level with the Manage Tax feature. For more fine-grained tax rates, you can use overrides or callbacks. Tax rates you set with overrides or callbacks replace existing tax rates set in Manage Taxes in Seller Central.

Set Your Seller Central Promotions Follow these steps to review and set your Seller Central Promotions (discounts): 1. In Seller Central, go to Settings > Manage Promotions. The Manage Promotions page appears, showing your current promotions. 2. You can change the following options: • Add a fixed-amount-off promotion • Add a percent-off promotion • Add a free-shipping promotion • Add a tiered promotion • Add a fixed-price promotion Tip: For complete information about setting promotions, please see Offer Promotions in Seller Central. Note: You can set promotions in Seller Central, overrides, callbacks, or a combination of all three. Promotions set using overrides or callbacks are additive to the promotions set in Manage Promotions. That is, if you have an existing promotion in Seller Central and a promotion in your override, and both can apply to the order, then both will be applied, resulting in a doublediscount.


18 | Checkout by Amazon | Setting Up Your Checkout by Amazon Account

Setting User Permissions for Your Seller Central Account When you first set up your Seller Central account, only the original registered user can access the features of Seller Central. But as time goes by, you might find that you want others to access your account. For example, you might want a co-worker to manage your orders or to handle your shipping confirmations. To add users or adjust user permissions, you use the User Permissions feature. Seller Central uses an invitation model to manage user accounts. First, users are invited to create an account on Seller Central to access your storefront; then, the account manager (also called the account administrator) configures the permissions for that user. By inviting users into the system and then configuring their permissions, you are assured that the appropriate user accounts are linked to the right owners, and that the correct permissions apply to the intended users. The invitation model also helps you to fully manage user accounts without assistance from an Amazon Payments administrator. To set up users, first the account manager must set up the initial account using the Checkout by Amazon registration process. After setting up the initial account, the account manager then compiles a list of people who can access the system and determines the respective rights for those users. At this point, the account manager is ready to invite new users to Seller Central. This invitation process takes three steps: 1. The account manager sends an e-mail invitation to each user that contains a link to Seller Central. 2. The user clicks the link and navigates to a page giving access to a unique confirmation code. At this stage, the user is a pending user. 3. The user enters the confirmation code and establishes the account. At this stage, the user is now a current user. After the invitation process is complete, the user has a username and password to access the system. The final step is for the account administrator to assign the appropriate rights to that user. Note: The username and password are combined together to identify a unique user account. For example, myname@isp.com + password1 and myname@isp.com + password2 are different user accounts.

Step One: The Account Manager Sends the Invitation The first step is to invite the user. 1. On the Settings tab, click User Permissions. The User Permissions page appears. 2. Under Add a New Seller Central User, type the e-mail address of the user you want to invite to the account. 3. Click Send Invitation. The e-mail invitation is sent to the e-mail address you specified. A confirmation message appears. 4. Click Continue.

Step Two: The User Receives a Confirmation Code After clicking the link in the invitation e-mail, the invited user navigates to a web page that asks the user to either sign in with an existing Amazon account or to create a new account. After this is done, a page appears containing a confirmation code. The user then shows or sends the confirmation code to the account manager, and the account manager approves the user and grants rights to the user.

Step Three: The User Accesses Seller Central and Creates an Account After the account manager confirms the user, the user can go to https://sellercentral.amazon.com/ to log in to the account.


Checkout by Amazon | Setting Up Your Checkout by Amazon Account | 19

Step Four: The Account Manager Sets User Permissions After creating the user, the account manager can edit user permissions, granting rights to any and all tools. 1. On the Settings tab, click User Permissions. The User Permissions page appears. 2. On the User Permissions page, click Edit next to the account you want to change. The Add or Edit User page appears. 3. On the Add or Edit User page, click the button next to each tool you want to allow the user to access. 4. When you are finished, click Continue. A confirmation message appears confirming the modifications. Note: The original account holder -- ithe one who first signed up for the account -- is always the default account manager. The account manager can always grant rights to others to be co-account managers; however, the original owner/account manager cannot be changed or removed.

Setting Up Your E-mail Whitelist E-mail is the default means of communication from Amazon Payments to you. For example, each time a customer places an order, we send you an order notification e-mail. We also send e-mails when there is a dispute about a transaction. There are other e-mails you can receive from Amazon Payments concerning your account and transactions. Because e-mail is an important means of communication, it's important that you're getting these e-mails from Amazon Payments. To be sure that you can receive these e-mails, you can set your e-mail client to always accept e-mails from Amazon Payments by adding the sender (amazon.com) to your e-mail client's "whitelist." (A whitelist is a set of permitted e-mail addresses that can send e-mail to you, no matter what content they send.)

Set Up Your Whitelist Follow these general steps to set up your e-mail client's whitelist. Note: These steps assume you are using Microsoft Outlook 2010. If you use another e-mail client, check the application's online help for more information. 1. In Microsoft Outlook 2010, click Home > Junk > , and then click Junk E-mail Option. The Junk Mail Options box appears. 2. Click the Safe Recipients tab, click Add, type @amazon.com, and then click OK. Your Safe Recipients list will look something like this:


20 | Checkout by Amazon | Setting Up Your Checkout by Amazon Account

Figure 7: Junk E-mail Whitelist in Outlook 2010 3. Click OK.

Setting Up Your Buyer (Testing) Account Before you begin taking orders on your website, you should test your order and fulfillment systems to be sure that you can reliably accept and fulfill orders. And when you create test orders, you must use a separate account from the one you use when you signed up for Checkout by Amazon. Note: For more information about testing procedures, please see #unique_35. Be sure you understand that orders placed in the Production environment must be either fulfilled by you as the merchant or canceled using the buyer account. See Cancel Your Test Production Order on page 31 for more information.

Set Up Your Buyer (Testing) Account Important: Do not use the same e-mail address for your buyer (testing) account that you are using for your seller or merchant account. Amazon Payments allows only one account per e-mail account. That is, if you use someone@mail.com for your seller account, don't use the same e-mail address when you create a new buyer (testing) account.


Checkout by Amazon | Setting Up Your Checkout by Amazon Account | 21

Note: If you already have a separate buyer account (different than the one you used to sign up for Checkout by Amazon) that you use for buying on Amazon.com, you can skip these steps. Follow these steps to set up your buyer (testing) account: 1. Go to the Amazon Payments site at https://payments.amazon.com/ 2. Click the Personal tab. The Personal tab page appears:

Figure 8: The Personal tab page 3. On the right side of the page click Create account. The Amazon.com Sign In page appears. 4. Enter your e-mail address, click I am a new user, and click Sign in using our secure server. You should see the New to Amazon.com page. If you do not, press the Back button on your browser and be sure you enter an e-mail and password that you have not used before to shop on Amazon.com. 5. Fill in the requested information and click Continue. The Sign Up for Amazon Payments page appears. 6. Fill in the requested information and click Continue. 7. When prompted, you can activate more services, or click Skip to continue. After you have signed up for an account, we'll send an e-mail to the address you supplied with instructions for you to confirm your new account.

Set Up PayPhrase for Your Buyer Account PayPhrase is an easy-to-remember shortcut to shipping and payment information in your Amazon.com account. Your customers can use it for Express Checkout (including PayPhrase, 1-Click, and Express Checkout) at Amazon.com and across the web, including your website. You have two parts to setting up and using PayPhrase on your website: 1. Set up your PayPhrase for your buyer (testing) account. 2. Set up your website to allow PayPhrase, 1-Click, and Express Checkout. In this task you set up the PayPhrase for your buyer (testing) account. To learn how to enable PayPhrase, 1-Click, and Express Checkout on your website, see Enabling PayPhrase on Your Website on page 22. Tip: When you create your PayPhrase for your buyer (testing) account, set up approvals for your PayPhrase. That way, you can use the PayPhrase for test purchases but wait until a convenient time to either decline or approve the test purchases.


22 | Checkout by Amazon | Setting Up Your Checkout by Amazon Account

1. On the Amazon Payments site, click the PayPhrase tab. The Amazon PayPhrase page appears. 2. Click the Create Your PayPhrase button. The PayPhrase creation page appears. 3. Accept the suggested PayPhrase, or enter your own. 4. Option: click the Set up spending limits and approvals check box. 5. Click the Next button. 6. If you clicked the Set up spending limits and approval check box (earlier), then click the Review and approve all orders before they are placed option button and click the Next button. 7. On the Create a PIN page, enter your 4-digit PIN. 8. Click the Claim Your PayPhrase button. 9. Enter your shipping address and click the Use as shipping address button. 10. Enter your payment method and click the Continue button. 11. Select or enter a billing address and click the Use as billing address button. The Your PayPhrase Is Ready to Use page appears.

Enabling PayPhrase on Your Website PayPhrase is an easy-to-remember shortcut to shipping and payment information in your Amazon.com account. Your customers can use it for Express Checkout at Amazon.com and across the web, including your website. By default, the button code you create using the Create Checkout Button generator in Seller Central includes this code, but you can verify it with the following examples: To enable PayPhrase on your website, you simply place two lines of code at the beginning of the button form you create as shown below: For Sandbox buttons (note the word "sandbox" in bold) <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/sandbox/widget.js"> </script> For Production buttons <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/ widget.js"> </script> Important: The code samples in this document always show these lines of script that enable PayPhrase, 1-Click, and Express Checkout. Be sure your button code always includes these lines of code as well.


Chapter

2 Integrating with Checkout by Amazon Topics: • • •

Steps to Integrating Checkout by Amazon with Your Website Sandbox Setup Production Setup

Integrating your website with Checkout by Amazon requires that you build and test your buttons (and checkout process) in the Sandbox as well as in Production. The following section is a step-by-step procedure to create working checkout buttons, from your test buttons that you build and use in the Sandbox to working buttons you build and use on in Production.


24 | Checkout by Amazon | Integrating with Checkout by Amazon

Steps to Integrating Checkout by Amazon with Your Website Here are the steps you'll follow to integrate with Checkout by Amazon: 1. Switch to the Sandbox Mode in Seller Central and create the Checkout button. 2. Place the Sandbox button on your test web page. 3. Test the Sandbox order using your buyer account (complete the checkout in the Sandbox). 4. Switch to the Production Mode in Seller Central and create the Checkout button. 5. Place the Production button into your test web page. 6. Test the Production order using your buyer account (complete the purchase in Production). 7. Cancel the Production order on Amazon Payments site using your buyer account login. 8. Place the Production-mode generated button code on your website. Note: The Standard Checkout Widget renders the Checkout button. Please refer to the Checkout by Amazon Widget Reference Guide for details on using the Standard Checkout Widget, and for information on how to set up widgets on your web page.

Sandbox Setup Create a Sandbox Checkout Button Creating a Sandbox Checkout button is easy, because you just use the Create Checkout Button page in Seller Central. Note: When you create a Sandbox button, be sure to switch to the Sandbox mode in Seller Central. Follow these steps to create a Sandbox Checkout Button in Seller Central. 1. In Seller Central, click the Website drop-down list box. The drop-down list box displays the sites you can manage in Seller Central. 2. Click Your Checkout Website (Sandbox). 3. Click Integration > Create Checkout Button. The Create Checkout Button appears. 4. On the Create Checkout Button page, choose from the following options: • Color for the button • Website background for the button • Size for the button 5. Enter the following information about the item: • Item Name *required • Seller SKU *required if you're using Fulfillment by Amazon • Price *required • Description • Item Weight 6. Click the Create Checkout Button. The page expands to show a box with the code you need for your button. 7. Click in the box to select all the code. By default, when you click in the box, the contents of the box are automatically selected for you. The content will look something like this (line breaks added for clarity): <script type="text/javascript" src="https://images-na.ssl-images-amazon.com/images/G/01/cba/js/jquery.js"> </script>


Checkout by Amazon | Integrating with Checkout by Amazon | 25

<script type="text/javascript" src="https://images-na.ssl-images-amazon.com/images/G/01/cba/js/widget/ sandbox/widget.js"> </script> <form method="POST" action="https://payments-sandbox.amazon.com/checkout/ AEIOU1234AEIOU"> <input type="hidden" name="order-input" value="type:cba-signed-order/ sha1-hmac/1;order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLTgnPz4 8T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6b24uY29tL2NoZWNrb3V0LzIw MDgtMTEtMzAvJz48Q2FydD48SXRlbXM+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY 2hhbnRJZD5BMUVKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkIEZpc2g8L1 Rpd#xlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91bnQ+PEN1cnJlbmN5Q29kZT5VU0Q 8L0N1cnJlbmN5Q29kZT48L1ByaWNlPjxRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmls bG1lbnROZXR3b3JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+PC9JdGVtPjwvS XRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature:0nppbXTktfoV80Kh41GK7ruUhq8="> alt="Checkout with Amazon Payments" src="https://payments-sandbox.amazon.com/gp/cba/button?ie=UTF8 &color=orange&background=white&cartOwnerId=AEIOU1234AEIOU&size=medium" type="image"> </form> 8. Copy the code to your Clipboard. If you're using a Windows-based PC, press CTRL+C. If you are using a Mac, press COMMAND+C. Note: The form POST action points to the Sandbox URL "https://payments-sandbox.amazon.com/checkout" and the image tag points to the Sandbox image server "https:// payments-sandbox.amazon.com"

Place the Sandbox Checkout Button Code on Your Test Web page When you have built the code for the cart using the Create Checkout Button page in Seller Central, you add the resulting code to your test web page. For example, you might have a test web page that looks like this: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>My Checkout by Amazon Sandbox Button Test Page</title> </head> <body> <h1>This is my Sandbox checkout button</h1> <!-- Paste your Sandbox button code under this line -->

</body> </html> Paste the code you created earlier into your test webpage. The resulting code will look like this: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>My Checkout by Amazon Sandbox Button Test Page</title> </head> <body> <h1>This is my Sandbox checkout button</h1> <!-- Paste your Sandbox button code under this line --> <script type="text/javascript" src="https://images-na.ssl-imagesamazon.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/ sandbox/widget.js"></script>


26 | Checkout by Amazon | Integrating with Checkout by Amazon

<form method="POST" action="https://payments-sandbox.amazon.com/checkout/ AEIOU1234AEIOU"> <input type="hidden" name="order-input" value="type:cba-signed-order/ sha1-hmac/1;order: PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLTgnPz48T3JkZXIgeG1sbnM9J2h0dHA6 Ly9wYXltZW50cy5hbWF6b24uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXRlbXM+ PEl0ZW0+PE1lcmNoYW50SWQ+QTNMN041U1hKSUhHT088L01lcmNoYW50SWQ +PFRpdGxlPlJlZCBD dXA8L1RpdGxlPjxQcmljZT48QW1vdW50PjEuMDA8L0Ftb3VudD48Q3VycmVuY3lDb2RlPlVTRDwv Q3VycmVuY3lDb2RlPjwvUHJpY2U +PFF1YW50aXR5PjE8L1F1YW50aXR5PjxGdWxmaWxsbWVudE5l dHdvcms +TUVSQ0hBTlQ8L0Z1bGZpbGxtZW50TmV0d29yaz48L0l0ZW0+PC9JdGVtcz48L0NhcnQ+ PC9PcmRlcj4= ;signature:UOo1WHo/0jwmLrF1w2znjsap1Zo="> <input alt="Checkout with Amazon Payments" src="https://payments-sandbox.amazon.com/gp/cba/button? ie=UTF8&color=orange &background=white&cartOwnerId=AEIOU1234AEIOU&size=medium" type="image"> </form> </body> </html> Now open this in your browser. Your resulting image should look like the following image:

Figure 9: Your Sandbox test page Note: Your checkout button and cart code must contain the lines of JavaScript as shown in the example above. For a complete list of button styles, please see Button Styles. Do not mix Sandbox and Production buttons on the same page.

Test Your Sandbox Button by Placing a Test Order Now that you have created a Sandbox Checkout button and placed it on a test web page, you're ready to test it.


Checkout by Amazon | Integrating with Checkout by Amazon | 27

Note: Remember, you must use your Buyer (Test) Account to test buying items, even if you buy items in the Sandbox. Note: Orders you place using Sandbox buttons are never charged. This means your Buyer (Test) Account will not receive a confirmation e-mail, and your Seller Account will not receive any notification on the sale. You can, however, track Sandbox orders in Seller Central by searching for "Pending Orders." For more information about how to do so, please see Managing Orders. When you test a Sandbox button, you test for the following exit criteria: • Clicking the Sandbox Checkout button starts the checkout process. • If you use your Buyer (Test) Account's PayPhrase, the checkout window on your site appears. • If you bypass using your PayPhrase and sign in using your Buyer (Test) Account, you can proceed through the checkout pipeline without failure. • When you come to a page that displays a Place order button, clicking the button delivers a message that the order was placed. • Using your Seller Account in Seller Central, you can find the pending order on the Manage Orders page. Follow these steps to place test orders in the Sandbox. 1. Open your web browser and go the URL for your test web page. 2. Click the Sandbox Checkout button you just created. 3. If you are using your Buyer Account PayPhrase, enter your PayPhrase and click the button to continue. 4. If you are bypassing your PayPhrase, then when prompted, sign in using your Buyer (Test) Account credentials In some cases you might not be prompted to sign in if you've recently made a purchase using your Buyer (Test) Account on the computer you're using for testing. 5. If you are bypassing your PayPhrase, then when prompted, select the shipping address and credit card you want to use for the purchase. Depending upon your Buyer (Test) Account settings, you might not be prompted for this information. 6. At the confirmation page, review the information to be sure it's accurate. Make sure the shipping, tax, and promotional discount information is correct. 7. Click the Place this order button to complete the Sandbox purchase. Remember, although you will see a confirmation message, your Buyer (Test) Account will not get a confirmation e-mail, because Sandbox transactions do not become orders.

Production Setup Create a Production Checkout Button Creating a Production Checkout button lets you create real orders; that is, orders that are processed, charged, and fulfilled. Creating a Production Checkout button is easy, because you just use the Create Checkout Button page in Seller Central. Note: When you create a Production button, be sure to switch to the Production mode in Seller Central. Follow these steps to create a Production Checkout Button in Seller Central. 1. In Seller Central, click the Website drop-down list box. The drop-down list box displays the sites you can manage in Seller Central. 2. Click Your Checkout Website. 3. Click Integration > Create Checkout Button. The Create Checkout Button appears. 4. On the Create Checkout Button page, choose from the following options: • Color for the button


28 | Checkout by Amazon | Integrating with Checkout by Amazon

• Website background for the button • Size for the button 5. Enter the following information about the item: • Item Name *required • Seller SKU *required if you're using Fulfillment by Amazon • Price *required • Description • Item Weight 6. Click the Create Checkout Button. The page expands to show a box with the code you need for your button. 7. Click in the box to select all the code. By default, when you click in the box, the contents of the box are automatically selected for you. The content will look something like this (line breaks added for clarity): <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/ 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:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLTgnPz48T 3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6b24uY29tL2NoZWNrb3V0LzIwMDgt MTEtMzAvJz48Q2FydD48SXRlbXM+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnR JZD5BMUVKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkIEZpc2g8L1RpdGxlPj xQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91bnQ+PEN1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlb mN5Q29kZT48L1ByaWNlPjxRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbnROZXR3 b3JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+PC9JdGVtPjwvSXRlbXM+PC9DYXJ 0PjwvT3JkZXI+;signature:0nppbXTktfoV80Kh41GK7ruUhq8="> <input alt="Checkout with Amazon Payments" src="https://payments.amazon.com/gp/cba/button?ie=UTF8&color=orange &background=white&cartOwnerId=AEIOU1234AEIOU&size=medium" type="image"> </form> 8. Copy the code to your Clipboard. If you're using a Windows-based PC, press CTRL+C. If you are using a Mac, press COMMAND+C. Note: The form POST action points to the Production URL "https://payments.amazon.com/checkout" and the image tag points to the Production image server "https:// payments.amazon.com"

Place the Production Checkout Button Code on Your Test Webpage When you have built the code for the cart using the Create Checkout Button page in Seller Central, you add the resulting code to your test web page. For example, you might have a test web page that looks like this: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>My Checkout by Amazon Production Button Test Page</title> </head> <body> <h1>This is my Production checkout button</h1> <!-- Paste your Production button code under this line -->


Checkout by Amazon | Integrating with Checkout by Amazon | 29

</body> </html> Paste the code you created earlier into your test webpage. The resulting code will look like this: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>My Checkout by Amazon Production Button Test Page</title> </head> <body> <h1>This is my Production checkout button</h1> <!-- Paste your Production button code under this line --> <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/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 Ly9wYXltZW50cy5hbWF6b24uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXRlbXM+ PEl0ZW0+PE1lcmNoYW50SWQ+QTNMN041U1hKSUhHT088L01lcmNoYW50SWQ +PFRpdGxlPlJlZCBD dXA8L1RpdGxlPjxQcmljZT48QW1vdW50PjEuMDA8L0Ftb3VudD48Q3VycmVuY3lDb2RlPlVTRDwv Q3VycmVuY3lDb2RlPjwvUHJpY2U +PFF1YW50aXR5PjE8L1F1YW50aXR5PjxGdWxmaWxsbWVudE5l dHdvcms +TUVSQ0hBTlQ8L0Z1bGZpbGxtZW50TmV0d29yaz48L0l0ZW0+PC9JdGVtcz48L0NhcnQ+ PC9PcmRlcj4= ;signature:UOo1WHo/0jwmLrF1w2znjsap1Zo="> <input alt="Checkout with Amazon Payments" src="https://payments.amazon.com/gp/cba/button? ie=UTF8&color=orange&background=white &cartOwnerId=AEIOU1234AEIOU&size=medium" type="image"> </form> </body> </html> Now open this in your browser. Your resulting image should look like the following image:


30 | Checkout by Amazon | Integrating with Checkout by Amazon

Note: Your checkout button and cart code must contain the lines of JavaScript as shown in the example above. For a complete list of button styles, please see Button Styles. Do not mix Sandbox and Production buttons on the same page.

Test Your Production Button by Placing a Test Order Now that you have created a Production Checkout button and placed it on a test web page, you're ready to test it. Note: Remember, you must use your Buyer (Test) Account to test buying items. Note: Orders you place using Production buttons are always charged. This means your Buyer (Test) Account will receive a confirmation e-mail, and your Seller Account will receive notification on the sale. You track Production orders in Seller Central, with Orders Reports, or IOPN. See Managing Orders for more information. Important: Remember to cancel your test Production order after you place it; otherwise, your Buyer (Test) Account credit card will be charged. Also note that you are required as a seller to fulfill or cancel all orders within 30 days, even if you placed the order using your Buyer (Test) Account. When you test a Production button, you test for the following exit criteria: • • • • • •

Clicking the Production Checkout button starts the checkout process. If you use your Buyer (Test) Account's PayPhrase, the checkout window on your site appears. If you bypass using your PayPhrase and sign in using your Buyer (Test) Account, you can proceed through the checkout pipeline without failure. When you come to a page that displays a Place order button, clicking the button delivers a message that the order was placed. After you place the order, your Buyer (Test) Account receives a confirmation e-mail from Amazon Payments. Using your Buyer (Test) Account on the Amazon Payments site (https://payments.amazon.com), you can find the order on the Your Account page.


Checkout by Amazon | Integrating with Checkout by Amazon | 31

â&#x20AC;˘

Using your Seller Account in Seller Central, you can find the order on the Manage Orders page.

Follow these steps to place test orders in Production: Open your web browser and go the URL for your test web page. Click the Production Checkout button you just created. If you are using your Buyer Account PayPhrase, enter your PayPhrase and click the button to continue. If you are bypassing your PayPhrase, then when prompted, sign in using your Buyer (Test) Account credentials. In some cases you might not be prompted to sign in if you've recently made a purchase using your Buyer (Test) Account on the computer you're using for testing. 5. If you are bypassing your PayPhrase, then when prompted, select the shipping address and credit card you want to use for the purchase. Depending upon your Buyer (Test) Account settings, you might not be prompted for this information. 6. At the confirmation page, review the information to be sure it's accurate. Make sure the shipping, tax, and promotional discount information is correct. 7. Click the Place this order button to complete the Production purchase. You will see a confirmation message, and your Buyer (Test) Account will get a confirmation e-mail. 1. 2. 3. 4.

Cancel Your Test Production Order After you place a test order in Production, you should cancel it within 15 minutes. Note: You do not need to cancel a test order if you intend to use it to test your fulfillment systems. All orders that are not canceled by the buyer must be either fulfilled or canceled by the merchant within 30 days. Orders that are not fulfilled or canceled within 30 days by the merchant will be canceled by Amazon Payments. Your cancellation rate affects merchant performance; a high rate of merchant-caused cancellations can lead to review by Amazon Payments. Follow these steps to cancel an order using your Buyer (Test) Account. 1. Go to the Amazon Payments website (https://payments.amazon.com/). 2. Click the Your Account tab. 3. When prompted, sign in using your Buyer (Test) Account e-mail and password. You might not be prompted to sign in if you have already signed in using your Buyer (Test) Account on Amazon Payments, Amazon.com, or other Amazon-related sites. Tip: Check the sign-in name in the upper-right corner. If it's not the name you expect, click "Sign Out" and then click the Your Account tab again. 4. Find the test order you placed. 5. Click the Details link next to the test order. The order details page appears. 6. Click the Need to cancel this order button. 7. Click Cancel order. The order is canceled.

Place the Production Checkout Button Code on Your Live Webpage After you have built and tested the Checkout button you created using the Create Checkout Button page in Seller Central, you place the button (the HTML form with the cart information) on your live web page so that your customers can begin using the button to place real orders.


32 | Checkout by Amazon | Integrating with Checkout by Amazon

Note: Your checkout button and cart code must contain the lines of JavaScript as shown in the example above. For a complete list of button styles, please see Button Styles. Do not mix Sandbox and Production buttons on the same page.


Chapter

3 Handling Settlements The order will get to the Ready-To-Ship state when the payment amount is reserved successfully on buyer’s payment method. You must wait for the order to get to the Ready-To-Ship state before you fulfill the order. You can listen to the order notifications to know immediately when the order state changes. Please see the Instant Order Processing Notifications Guide for details about using instant order processing notifications. Once the order is ready to ship, you must take action on them: • •

You must fulfill them (ship them and mark them as shipped), or You must cancel them (for test orders, it's easier to cancel them with your buyer (test) account)

The customer is charged only when you fulfill the order. You must take action on all orders within 30 days; otherwise, Checkout by Amazon will cancel the order. Please see the Managing Orders Guide to learn more about fulfilling, cancelling, refunding, and other order management functions.


34 | Checkout by Amazon | Handling Settlements


Chapter

4 Post-Setup Exit Criteria Topics: â&#x20AC;˘

Exit Criteria

After you've set up and tested your integration, you should follow the steps listed in this chapter to be sure you are ready to release your website's integration with Checkout by Amazon to the public.


36 | Checkout by Amazon | Post-Setup Exit Criteria

Exit Criteria Here are the exit criteria for successfully building Checkout buttons for your website. Use this checklist to be sure that your checkout buttons work correctly before you release your website to the public. 1. 2. 3. 4.

The button works in the Sandbox and in Production (that is, the order pipeline completes successfully). The Production order appears in Amazon Payments site using buyer account login. The Production order appears in Seller Central using merchant account login (on the Manage Orders page). You cancel all test orders with your Buyer (Test) Account on the Amazon Payments site.


Appendix

A Button Styles Topics: • • •

White Background Light Background Dark Background

To complete integrating Checkout by Amazon with your cart, you’ll display Payment Button images that your buyers will click to successfully place orders. Choose a Payment Button image you want to use, and then copy and paste the URL to your website. Here are the payment button images you can place on your website.


38 | Checkout by Amazon | Button Styles

White Background

Background: White Color: Orange Size: X-large (173 x 38)

Background: White Color: Orange Size: Large (151 x 38)

Background: White Color: Orange Size: Medium (126 x 35)

Background: White Color: Tan Size: X-large (173 x 38)

Background: White Color: Tan Size: Large (151 x 38)


Checkout by Amazon | Button Styles | 39

Background: White Color: Tan Size: Medium (126 x 35)

Light Background

Background: Light Color: Orange Size: X-large (173 x 38)

Background: Light Color: Orange Size: Large (151 x 38)

Background: Light Color: Orange Size: Medium (126 x 35)

Background: Light Color: Tan Size: X-large (173 x 38)


40 | Checkout by Amazon | Button Styles

Background: Light Color: Tan Size: Large (151 x 38)

Background: Light Color: Tan Size: Medium (126 x 35)

Dark Background

Background: Dark Color: Orange Size: X-large (173 x 38)

Background: Dark Color: Orange Size: Large (151 x 38)

Background: Dark Color: Orange Size: Medium (126 x 35)

Background: Dark Color: Tan Size: X-large (173 x 38)


Checkout by Amazon | Button Styles | 41

Background: Dark Color: Tan Size: Large (151 x 38)

Background: Dark Color: Tan Size: Medium (126 x 35)


42 | Checkout by Amazon | Button Styles

Standard Checkout Button Creation Wizard Implementation Guide  

Standard Checkout Button Creation Wizard Implementation Guide