Documentation: Login and Pay with Amazon

Overview

This module is an official integration of "Pay with Amazon" for your PrestaShop. Your clients can purchase in your shop without reentering their payment- and addressdata. They feel save as well, as they know it's the same safety as buying directly at Amazon.

Login and Pay with Amazon is a payment solution only - so no data of your customers products or carts will be submitted. You can administrate everything directly through your admin-panel of your PrestaShop.

You can register for Pay with Amazon at: https://payments.amazon.com/business/pre-registration-api

Features of our extension

• Optimized for mobile clients as well
• Payment solution only - no submission of product- or cartdata
• Complete order-management throughout your admin-panel of your onlineshop
• Coupons, Discounts and so on will work within the module
• Your clients could checkout as guests, as an account in your shop is not necessary
• You can cancel orders through your admin-panel, this order-state will be submitted to Amazon
• Confirm the shipping of the order - this status update is also been submitted to Amazon
• Built-In version-control
• Exclude specific products from "Pay by Amazon"

Download of the plugin

This free extension can be downloaded at the PrestaShop Addon-Store.

Provider of the plugin

This extension has been developed by patworx multimedia GmbH in collaboration with alkim media and Amazon Pay Europe SCA.

Requirements

Systemrequirements

This extension requires you to have a valid Amazon Pay account and a webserver with PrestaShop installed.

The module supports PrestaShop from version 1.5.x on.

Create your account for Pay with Amazon (Amazon Payment APIs)

Register the Amazon Account

• Visit https://payments.amazon.com/business/api-integration
• Click "Sign up" and follow the required steps

After your sucessful registration Amazon will validate all informations.

Create MWS-Access Key

You can create the MWS-Access Key on the main page of your Seller-Account. Just navigate to Integration -> MWS Access Key

There, please follow the required steps to create the MWS Access Key

How to find the logindata for the configuration of the PrestaShop plugin.

You need to enter the following informations:
- Merchant ID
- MWS Access Key
- Secret Access Key
Please be aware: Your Merchant-Token is not your Merchant-ID.

Merchant ID

You can find the Merchant ID in your Seller-Central:

Access Key ID / Secret Access Key

Please find both at "Integration" - "MWS Access Key"

Necessary configuration in Seller Central

If you plan to use IPN, you have to enter the Merchant URL. You can find the URL to enter in the admin panel of the module in your shop backend.

Special configuration for "Login and Pay"

If you want to use the login-functionality, you have to do some more settings in your Amazon Seller Central.
Be careful: If you don't have a valid SSL-certificate for your shop, you cannot use the "Login"-functionality!

Register new application

After you selected the configuration-site for Login in your Amazon Seller Central, you can register a new application.

Now you need to fill in the form and enter the URL for your privacy-informations in your shop.

After you saved this form, you find an additional form for your web-settings.
The Client-ID will be filled automatically.
Please find the values you need to enter for JavaScript-Origins and allowed return-urls in the backend of your shop in the administration-panel of the module!

Installation

Before you install the module

Always backup your shop or use a separate development copy of your system.

Installation

Enter your admin-panel of your PrestaShop. At "Modules" - "Modules" you find the button "Add a new module".
There you can upload the downloaded ZIP-File

Configuration

After the successful installation you need to configure the plugin. Navigate to "Modules" - "Amazon Advanced Payments APIs". Then click on "configure".

Amazon Merchant ID

Your Amazon Merchant ID you can find in your Amazon Pay Selleraccount at "Settings" - "Integrationsettings".

AWS Access Key, Secret Key

Your Access Key ID and your Secret Access Key you find at the menu "Integration" - "MWS Access Key".

Client-ID for Login & Pay

Your Client-ID you find at the websettings in your Amazon Pay Selleraccount.

Region

Please enter your regional code for the module. For Great Britain for example it is "UK". Important: Amazon Pay must be available for the set regional code.

Mode Login/Pay

You can decide if you want to just use the "Pay"-functionality, only "Login"-functionality or both ("Login & Pay").

Show buttons in frontend

With this setting, you can hide the buttons in your shopfrontend, but the module will stay active in the background.

Operation mode

The Test mode (Sandbox) has been developed, to test and check the module in your Shop. Please have a look at the official documentation of Login and Pay with Amazon to find out more about the sandbox.
For development and test-environments you should activate the sandbox mode. For productionsystems you should deactivate it. Never show your customers sandbox-widgets in your shop!

When/How will the payment be authorised?

Immediate authorisation has a slightly higher risk to be rejected. It is recommended to use it, when you have downloadproducts where you need immediate notification of the payment, or you want to tell the client immediately if his payment has been authorised. After authorisation you have 30 days to send the products and capture the payment.

Order status for authorised payments

This state will be set for authorised payments.

When/How will payments be capured?

You can set when the payment will be finally captured.

Order status to capture payment

At this state the payment will be captured.

Order status after successful capture

This state will be set for captured payments.

Provoke errors (Sandbox only)

In sandbox mode you can simulate different states in the payment process. Here you can set the type of error you want to simulate.

Exclude shipping methods (Ids, comma-separated)

Enter the IDs of the shipping methods that are excluded from "Pay with Amazon". If this field is empty, all shipping methods will be available.

Exclude products from Pay with Amazon

Enter the IDs of the products that are excluded from "Pay with Amazon".

Allow guest orders?

If "yes", also customers who don't have an account in your shop may checkout.

Size of the Amazon Checkout button

You can select between different sizes.

Colour of the Amazon Checkout button

You can select between different colours.

IPN Settings

IPN (Instant Payment Notifications) will be sent by Amazon to inform your system about state changes in transactions. With these notifications, your system will know if an authorisation or capture has been done.

Receive status updates via IPN

This option activates or deactivates the Instant Payment Notifications. To use IPN, you need to have a valid SSL certificate on your server. If you don't active IPN, please use polling and create a cronjob.

URL for Amazon IPN

If you want to use IPN, you need to enter this generated URL at "Merchants-URL" at the Integrationsettings in your SellerCentral.

Use cron job for status updates

If you have no valid SSL certificate or don't want to use IPN for any other reasons, you can activate polling here. Please keep in mind, you need to create the cronjob on your server.

Password for cron job

This is for security reasons.

URL for cron job

This is the generated URL for the cronjob.

Automatically notify customers when payments are rejected

Activate or deactivate notifications for your clients for declined payments.

Preselect account creation in checkout

Preselected the checkbox for account creation in your Amazon Pay checkout.

Force account creation

If this is activated, for each order done with Amazon Pay, and customer account in your shop will be created.

Process of checkout and payment

This module for Login and Pay with Amazon follows the standard procedure of checkout and payment in your PrestaShop. All objects of Login and Pay with Amazon (order-Reference, authorisation, capture and refund) you will find in the admin-panel.

The "Pay with amazon"-Button

The Amazon-Button for the plugin can be found on different places in the shop:

• on the checkout page
  
• in the cart slider
  

With clicking on this button, the Amazon Pay authentication window opens. The client has to fill in his e-mail and password of his Amazon-account. After he successfully logged on, he will be redirected to the checkout page.

Checkout

The "Pay with Amazon" Checkout exists of six parts on one page: shopping cart, comments, payment widget (Amazon Wallet Widget), addressbook widget (Amazon Addressbook Widget), shipping method, conditions.

After selecting the shipping address, payment method, shipping method and pressing the "checkout"-button, the client will be redirected to the success site.

The placed order is now visible in your admin-panel at "orders". It also has been submitted to Amazon.

Payment authorisation

An authorisation can be requested, after the orderdata has been submitted successfully to Amazon. Depending on your configuration setting at "When/How will payments be captured?" the authorisation will be handled different.

Automatic authorisation

For the options "during checkout / before completing the order" and "immediately after the order" the authorisation will be requested as soon as the order has been placed in your shop and transmitted to Amazon. The requested authorisiation will be confirmed or rejected by Amazon.

If the automatic authorisation was successful, it looks like this:

If the automatic authorisation has been rejected, it looks like this:

Manual authorisation

If you send products after 30 days or later, you have to use manual authorisation. To request an authorisation manually, open the specific order in the admin-panel click on "authorise".

After you authorised the full amount or a part of the amount, you will find a new entry in the Amazon Pay history. This has the state "pending" and is being verified by Amazon.

After the successful authorisation it looks like this:

Authorise partial amount

With this plugin you also have the possibility to authorise partial amounts as well.

Authorise more

You can authorise higher amounts as well. Keep in mind the limit is 15% or 75 Euro maximum.

Rejected authorisations

If the authorisation has been rejected, the client will be contacted by email and told to go on the Amazon Pay website. The client can update the payment informations by following the instructions on the site. After a successful update of his payment method Amazon will inform the shop and you can go on with your order processing. The information will be done either by request (cron job) or by IPN if activated.

Capturing

After a successful authorisation you can capture the amount. There are three methods to capture: manual, automatic after authorisation or at a specific orderstate. You are only allowed to activate authomatic capture if you sell digital goods or send products on the same day. This has to be activated by Amazon Pay. So please contact Amazon Pay if you want to use this option.

Manual capturing

After a successful authorisation, you have the option to capture the authorised amount in the admin-panel. You have the option to capture the full amount or only a partial amount.

To capture the amount you have authorised, you have to capture the amount in between 30 days (2 days in sandbox mode). We recommend highly to capture the amoung in between 7 days to reduce the chances of rejections. If you need more than 30 days to send the order, please use manual authorisation mode.

Automatic capturing after successful authorisation

After a successful authorisation the amount will be captured automatically. You can now process the order the same way as with manual capturing.

Refund of ordered products

You can refund an order total or with partial amounts.

With this plugin you can refund even more than the paid amount. Please keep in mind that you can refund maximum 15% or 75 Euro in addition to the paid amount.

Test the integration

After you successfully installed and configured the plugin, you should start testing it. You should start testing in sandbox mode and move to live setting after the tests in sandbox mode have been sucessful. Please make sure that you get all required objects in the admin-panel after you placed orders.

You also should test rejections. You can configure hard and soft declines in the admin panel of the module in your shop.

To receive complete test scenarios, please contact Amazon Pay.

Important Layout Fix: PayPal Button on the Amazon Pay checkout page

Even if your customer already decided to use the easy checkout via Amazon Pay, a PayPal button will be shown within the Amazon Pay checkout page due to the default behavior of Prestashop. Switching between the payment options here would lead to a longer checkout with an unpleasant user experience and might also negatively impact the conversion. In order to make this Button disappear from the Amazon Pay checkout page, do the following:
1. Go to Modules->Positions
2. Edit PayPal for the Hook "displayShoppingCart"
3. In the section "exceptions", please add/select the following:
amzpayments, module-amzpayments-amzpayments, module-amzpayments-connect_accounts, module-amzpayments-jsmode, module-amzpayments-process_login, module-amzpayments-user_to_shop
4. Save your changes
Please be aware that this will only fix the wrongfully placement of the button. The PayPal button on all other pages and positions will not be affected.