Installation

Pre-installation steps

  • Create a backup of your shop before proceeding to install.
  • If your shop is using compilation (you can check it in System ‣ Tools ‣ Compilation), disable it please before proceeding to install.

Installation process

  • In your browser, open the Magento Marketplace page, add it to your cart, and go to checkout (this will be free of charge). On the order confirmation page click on Install to receive the access key (you may need to log in with your Magento account). Copy the access key.
_images/installation_step_1.png
  • Go to System ‣ Magento Connect ‣ Magento Connect Manager and enter your admin credentials to get logged in.
_images/installation_step_2.png
  • In the Install New Extensions section enter Login and Pay with Amazon extension key obtained from Magento Marketplace page and click Install button. Magento will display information about the extension you are about to install and after making sure this is the right version click Proceed button.
_images/installation_step_3.png
  • Installation will start and after successful install it will show a message. Optionally, you can click on Refresh button to see if Login and Pay with Amazon (identified as Creativestyle_AmazonPayments) is listed on list of the installed extensions.
_images/installation_step_4.png
  • Proceed to the post-installation steps.

Post-installation steps

  • If you’re using custom design theme, refer to the Templates customization section to find out how to adjust Login and Pay with Amazon templates to your needs.
  • Go to System ‣ Cache Management and flush Magento cache storage.
  • If you have disabled compiler in pre-installation stage, you can go now to System ‣ Tools ‣ Compilation, recompile and enable compiler again.
  • Logout from the Magento admin and login again.

Voila! The Login and Pay with Amazon extension shall be installed now. You can proceed to the Configuration followed by Frontend templates and Email templates customization (if applicable).

Upgrade

Pre-upgrade steps

  1. Create a backup of your shop before proceeding to upgrade.
  2. If your shop utilises compilation (you can check it in System ‣ Tools ‣ Compilation), disable it please before proceeding to upgrade.

Version 2.0.x (installed after September 2017) to 3.x

Note

In a nutshell: You can simply use Magento Connect to upgrade to the most recent plugin version.

Required steps:

  1. Log in to the admin area of your Magento 1 shop.
  2. Go to System ‣ Magento Connect ‣ Magento Connect Manager and enter your admin credentials to get logged in.
  3. Click on Check for Upgrades within the Extensions tab.
  4. For the module creativestyle+Creativestyle_AmazonPayments select the most recent version and click on Commit changes.
  5. After installation go back to admin area (link on top Return to Admin).
  6. Go to System ‣ Cache Management.
  7. Click on the button Flush Magento Cache (top right).
  8. Click on the button Flush JavaScript/ CSS Cache (bottom left).
  9. If you have disabled compiler in pre-installation stage, you can go now to System ‣ Tools ‣ Compilation, recompile and enable compiler again.
  10. Logout from the Magento admin and login again.
  11. Test if you can place an order with Amazon Pay. If you have any trouble please contact our support.

Version 1.x (installed before September 2017, including version 2.0.0) to 3.x

Note

In a nutshell: You have to uninstall the previous plugin version first. Then install the most recent version with a new extension key obtained from Magento Marketplace.

Required steps:

  1. Log in to the admin area of your Magento 1 shop.
  2. Go to System ‣ Magento Connect ‣ Magento Connect Manager and enter your admin credentials to get logged in.
  3. Search the package creativestyle+Creativestyle_AmazonPayments, select Uninstall as action, then click on the Commit changes button below.
  4. Install the most recent version according to our installation guide: Installation process.
  5. Test if you can place an order with Amazon Pay. If you have any trouble please contact our support.

Post-upgrade steps

Attention

The following instruction concerns the shops that rely on the order workflow (eg. 3rd party ERP implementation, etc.) and upgrades the extension from version either 1.x or 2.x to 3.x. Version 3.0.2 does not bring any changes to the templates or layout definitions. The only frontend related change has been introduced in the main JS application js/creativestyle/amazonpayments.min.js file. Please refer to the changelog or contact the support in case of any doubts.

Version 3.0.2 comes with a significant change to the payment processing workflow. Prior to version 3.x the payment authorization was requested during placing the order (i.e. right after clicking Save order button in the checkout), thus in synchronous and optimized (when there wasn’t transaction timed out decline) authorization mode, the order ended up with the immediate authorization result.

Since the Strong Customer Authentication (derived from the PSD2 directive) was introduced in version 3.0.2, the authorization is requested after the order is actually placed. Thus, it may happen that the order payment remains unauthorized for a longer time unless the buyer finishes his Multi-Factor Authentication challenge. This change has to be considered for passing the order to the fulfillment process, to avoid fulfilling the orders that haven’t been actually paid. As stated in Payment authorization section, it is always advised to start fulfilling the order after the authorization is confirmed, which, in the default configuration, is reflected by the “Processing” order status.

Upgrade to 3.x troubleshooting

After upgrade to 3.x, when the buyer clicks Amazon Pay button in the cart, he is redirected to the customer dashboard instead of the checkout.

  1. Please make sure that your webserver serves the most recent version of the js/creativestyle/amazonpayments.min.js file. Some webservers (as well as CDNs) are caching static assets, so it may happen that your shop serves an outdated version of the frontend JS application.
  2. If you are using custom layout or template files for Amazon Pay, make sure that your customizations are compliant with the recent changes in the extension. The easiest way to check is your customization is the case is to delete following files as after refreshing Magento cache, see if this resolves your issue:
  • app/design/frontend/CUSTOMPACKAGE/CUSTOMTHEME/layout/amazonpayments.xml
  • app/design/frontend/CUSTOMPACKAGE/CUSTOMTHEME/template/creativestyle/amazonpayments/js.phtml
  • app/design/frontend/CUSTOMPACKAGE/CUSTOMTHEME/template/creativestyle/amazonpayments/login/redirect.phtml