Skip to content

Installation and Quick Start Guide

tarishah edited this page Jul 11, 2019 · 22 revisions
About Installation and Quick Start Guide User Guide Community and FAQ
About Login and Pay Installation and Quick Start Guide User Guide Community and FAQ

- Download this page as a pdf

Watch a video on installation


In order to install the extension, you’ll first need to ensure that you meet the following prerequisites:

  • You’re using Magento CE 1.6+ or EE 1.11+.
  • SSL is installed on your site and active on your checkout and login pages.
  • To enable SSL on the front end, follow these steps:
    • From the admin toolbar, navigate to System > Configuration
    • Under the General heading select Web
    • From the Use Secure URLs in Frontend pull-down, select Yes
    • Click the Save Configuration button in the upper-right
  • Compilation is disabled in your environment

As with ALL Magento extensions, it is recommend that you backup your site before installation and that you install and test on a staging environment prior to production deployment.

Installing the Extension via Magento Connect

Assuming the prerequisites are met, follow these steps to install the extension:

  1. Go to the extension page on Magento Connect

  2. Click the Install Now button

  3. Check the box to agree to the extension license

  4. And then click the Get Extension Key button

  5. Click the Select Key button and copy the url using ctrl-c

  6. Now, go to your Magento admin and select System->Magento Connect->Magento Connect Manager

  7. Paste the url (key) into the field labeled “Paste extension key to install

  8. Click the Install button

  9. Then click the Proceed button

  10. Your extension should be installed. Make sure to configure the extension per the instructions in this document.

Manual Installation

  1. Go to the Github page for the extension

  2. Click the Download Zip button to the right, and save to your local machine.

  3. Upload the zip file to your Magento web server.

  4. Unpack the archive in the root directory of your Magento instance.

  5. Switch to your browser and login into the admin page for your Magento site.

  6. Next, you’ll need to flush your Magento caches

  7. From the admin toolbar, navigate to System >Cache Management

  8. In the upper-right, click the Flush Magento Cache button.

  9. NOTE: For more information on cache management, refer to the Magento documentation

  10. Log out of the admin page and then log back in

  11. Your extension should now be activated and ready to configure


To use the extension you will need a seller account from Amazon. To register a new account click here.

Registration Flow

  • Click the Get Started! button to start the process

  • On the Welcome screen enter your Legal Name, click the User Agreement checkbox, and then click the Continue button

  • On the next screen, there are several fields to fill out:

    • Application Name: Enter the name of your website that you’d like displayed when a consumer logs in
    • Application Description: Enter a brief description of your site, if desired
    • Privacy Notice URL: Enter the URL of your site’s privacy policy, which will be displayed the first time a user logs in using Amazon on your site
    • Allowed login domains: Enter the secure domain of any domain names you’ll be operating your site on, including any testing or staging environments. Be sure to include any variations of the sub-domain, such as:,,
  • Click the Submit button

  • The Summary of Amazon Payments Registration Information has all of the keys you need to connect the extension with your Amazon account—keep them handy

NOTE: You can find these keys in your Amazon account dashboards

  • Click the Continue to Seller Central button to finish your registration and complete your store setup

  • If you would like your store’s logo to appear on the Amazon Login screen:

    • Make sure Login with Amazon is selected from the pull-down at the top of the page.
    • At the bottom of the Application Information section, click the Edit button.
    • Next to Logo Image, click the Choose File button and select a 150px by 150px PNG image of your logo.
    • Click the Save button to save your changes

Next, you’ll need to flesh out your store details:

  • Select one of the Amazon Payments Advanced options from the pull-down at the top of the page. (Doesn’t matter which)

  • From the Settings menu in the upper-right corner, select Account Info

  • Fill out the Seller Information section, which is used for customer-facing emails.

  • In the Legal Entity section, you’ll need to supply your tax identity information. (Click the Launch Interview Wizard link, if you haven’t supplied this information already

  • In the Deposit Method section, click the Add button to the right to add your bank account you your seller account.

  • Once you’ve filled everything out, head back to the Magento admin page to configure the extension.

  • When done registering and presented with a screen with your Amazon keys, leave those on your screen since you need to paste them into your Magento Admin


Setting up Amazon Login & Pay allows your customers to login with their Amazon credentials and use any payment methods or contact information they have stored in their Amazon account. You can configure Login & Pay from the Magento administrative pages by choosing System > Configuration from the top menu. From there look for the Sales heading on the left and clicking Payment Methods. Scroll down to the Amazon Payments section of the page.

Configuring Amazon Payments

Using the keys from your Amazon account, you need to save them in your Magento Admin. This is where you will put your merchant specific credentials into the extension.

If these are not correctly copied from Seller Central, Amazon buyers will not be able to purchase on your site.

Amazon Seller Keys

There are 5 keys that must be correctly entered into the extension configuration in order for Login and Pay for Magento to function correctly

Merchant ID - The unique identifier for your business within Amazon. Assigned by Amazon when you register for Amazon Payments. Can be used on multiple sites.

MWS Access Key - Key for access Amazon’s Web Service API, assigned to you by Amazon. Can be used on multiple sites

MWS Secret Key - The 2nd part of the key pair used against the Amazon API. Can be used on multiple sites.

Client ID - Unique ID required for the Login with Amazon product. This value is assigned when creating a unique Application in Seller Central. This value is specific to the site on which the extension will be placed.

Client Secret - The 2nd part of the key pair used in authenticating Amazon buyers.

Alexa Delivery Notifications

The Alexa Delivery Notifications feature lets you provide shipment tracking information to Amazon Pay so that Amazon Pay can notify buyers on Alexa when shipments are delivered.

Here's what your customer will experience:

Customer: Alexa, read my notifications.

Alexa: One new notification, from Amazon Pay. Your shipment from <yourstorename> has been delivered.

Configuring Alexa Delivery Notifications

These are the required keys for Alexa Delivery Notifications:

Public and Private Key

The utility link provided in the Alexa Delivery Notifications settings, generates a new Public and Private Key for Amazon Pay.

  • Click 'Generate a new public/private key pair for Amazon Pay'. This saves the Private Key in the settings and displays the text [encrypted].
  • Click 'Download Public Key' to save the Public Key locally.

Public Key ID

To obtain the Public Key ID, you will need to email Amazon Pay and provide the Merchant ID and Public Key. Follow the steps below:

  • Click contact link in the 'Please contact Amazon Pay to receive the Public Key ID.'
  • Public Key and Merchant ID is attached to the email, click Send.
  • Amazon Pay Support will respond with the Public Key ID to the email address associated with the primary account holder in Seller Central.

Merchant Experience

Once you have configured Alexa Delivery Notifications, your store is ready to use this feature.

Alexa Delivery Notification is called when:

  • A shipment is submitted with the carrier code, name and tracking number
  • On a successful Alexa Delivery Tracker API, you will see its status as ‘Amazon Pay has received shipping tracking information for carrier <carrier_name> and tracking number <tracking_number>’.

The status will show under:

  • ‘Comments History’ in the Order view.
  • Under individual Shipment -> Shipment History.
You can’t perform that action at this time.