Tech Tips: Magento 1 to Magento 2 migration for Amazon Pay

Consider these insights for a successful migration of Amazon Pay from Magento 1 to Magento 2.

Originally posted 7/31/19

In September of 2018, Magento announced their end of support for Magento 1 by June 2020. For your Magento 1 migration, consider these tech tips, or if you are looking for alternative solutions, check out our ecommerce solution partners and consulting agencies to support your efforts here.

In the past year, according to BuiltWith, there has been an increase in migrations from Magento 1 to Magento 2, but there were still a considerable number of Magento 1 stores actively in use. As we near the end of the support window for Magento 1 and you consider migrating to Magento 2, we’ve outlined some instructions and best practices to make your Amazon Pay migration easier.

Below is the new Amazon Pay functionality built into Magento 2:

  • Amazon Pay extension is in the admin panel as part of Magento 2 core, 2.2.4 and above, so no installation is required
  • [EU/UK only] Multi-currency support

Features that were available in Magento 1 as well as Magento 2:

  • Buyers have an ability to initiate checkout using Amazon Pay from the cart, mini-cart, product pages and 1st step of checkout
  • Login with Amazon button is available as part of the customer login and registration page
  • Amazon Pay in the list of available payment methods during the final step of checkout
  • Supports payment authorizations, captures and refunds (also partial refunds)
  • Supports synchronous and asynchronous authorization mode
  • Supports Amazon Pay Instant Payment Notifications (IPNs)
  • Options for simulating payment scenarios in sandbox mode
  • [EU/UK only] Support for Strong Customer Authorization (PSD2 compliant)

In order to get started with Amazon Pay on Magento 2, please follow the steps below.

Step 1: Verify the extension installation

With Magento 2.2.4 and higher, the Amazon Pay extension is bundled along with Magento 2. To verify if it’s installed successfully, open the Magento 2 admin and go to Stores –> Configuration –> Sales –> Payment Methods.

Amazon Pay should be listed under “Other Payment Methods” as shown in the image below.


If Amazon Pay is not listed here, please refer to the Installation section of Github documentation for more details on the installation procedure.

We recommend watching the Amazon Pay University video on Integrating Amazon Pay with Magento 2.

Step 2: Configure the extension

  • The same Amazon Pay Seller Central account can be used for you Magento 2 Amazon Pay configuration
  • Add the Allowed JavaScript Origins and Allowed Return URLs to your Login with Amazon section of Seller Central. Please note that the Allowed JavaScript Origins URL must only be changed if the base URL of your shop has changed (e.g. => ).
    • If you go through the merchant on-boarding flow from your Magento 2 admin, by clicking the ‘Getting started with Amazon Pay’, the Allowed JavaScript Origins URL will be programmatically added.
    • The Allowed Return URL must be changed as this requires a full URL and is different from the one used in Magento 1.
  • Add the IPN URL to the field Merchant URL at Settings ‣ Integration Settings of the Seller Central. Please note that the IPN URL can be specified separately for Production and Sandbox view, so please verify that it has been set correctly for both environments.
  • Refer to Configuration to get more information about the other configuration settings.

Step 3: Review the below settings

In order to use the same settings you were using in your Magento 1 integration, please review the table below and choose the appropriate Amazon Pay settings for your shop. Please note that there are two different Amazon Pay extensions available for Magento 1, one for EU and one for the US region. The table below lists how your current extension options map to the corresponding option for Magento 2.


Step 4: Front-end Customization

If you are using a custom template, please read the following documentation carefully:

Step 5: Test your integration

Before go-live, please thoroughly test the integration as described in Testing your integration. If you run into any issues, please check our Frequently Asked Questions (FAQ) and GitHub issues to look for similar issues that other merchants have ran into.

For any further questions, feel free to reach to our Amazon Pay Support team by creating an issue via the GitHub plugin, or by contacting us via Contact Us.

Step 6: Go live

Now that your Amazon Pay Magento 2 integration is up-to-date with your Magento 1 integration and is functioning normally, please disable the sandbox mode. It is a best practice to perform a test transaction in live mode to ensure the integration is working as expected.