Configuration

After the successful installation you can proceed to the configuration. In the Magento admin go to System ‣ Configuration ‣ Amazon Payments tab.

_images/configuration_screenshot_1.png

Available options are grouped within the following tabs:

Amazon Payments Account

In this section you can define your Amazon Payments seller account credentials.

_images/configuration_screenshot_2.png

Merchant ID, Access Key ID, Secret Access Key

Fill out those fields with your Amazon Payments seller credentials. You can find them in the Amazon Seller Central, see: Merchant ID and AWS Access Key / Secret Key.

Marketplace

Select the country where you registered your seller account from the provided drop-down list. If you’re unsure about this information consult your Amazon Integration Assistant.

General Settings

In this section you can enable or disable the Pay with Amazon service and define basic settings of the extension.

_images/configuration_screenshot_3.png

Enable Pay with Amazon

By switching this option you can enable or disable Pay with Amazon. This option must be set to “Yes” if you want to provide the Pay with Amazon service to your customers.

Sandbox mode

Sandbox mode has been designed to test the Pay with Amazon service. In sandbox mode the selected payment method is not charged. Refer to the Pay with Amazon documentation to get more information about the sandbox environment. In general, sandbox mode should be enabled for development and staging environments for testing and has to be always disabled for production environments. Never show the sandbox buttons and widgets to buyers in your live environment.

Show Sandbox Toolbox

In sandbox mode you can simulate certain states for the differnt objects in the payment process. By enabling this option you get additional fields on the Amazon Checkout page that allow selecting expected payment statuses for orders, authorizations, captures and refunds returned in responses. This feature allows you to simulate different scenarios including declines in the sandbox environment.

Payment Action

You can select the desired payment action taken after an order is placed. By default the authorization is made automatically at order placement and the capture must be triggered by the seller by creating an invoice in Magento admin (Authorize method). By selecting the Authorize & capture method, the order amount will be captured immediately at order placement, which means that the authorization will be followed by an immediate capture call. If you want to use this setting, it is mandatory that you get white-listed for this feature by Amazon Payments first. Do not activate this option without contacting Amazon Payments first.

Warning

Please use Authorize & capture method only in the case you are shipping goods on the same day they are ordered and you have been white-listed for this service.

Enable Instant Payment Notifications

This option enables or disables handling of Instant Payment Notifications, which are used by Amazon Payments for sending feedback concerning the status of payment objects. Keep in mind that using IPN requires having a valid SSL (issued by a trusted CA) installed on your server and correctly configured Secure Base URL (System ‣ Configuration ‣ Web). In case you disable IPN and want to use data polling instead you need to setup a cron for your shop.

IPN endpoint URL

This auto-generated value shall be entered in the Merchant URL field of the Integration Settings in your Amazon Seller Central in case you plan to use IPN. If you use more than one store view in your Magento installation, the IPN endpoint URL will be shown after selecting appropriate store view scope.

Data polling frequency

If you don’t have a valid SSL certificate in your shop or due to any other reason you don’t want to use IPN, you can set how often status of the different object shall be polled from Amazon Payments servers. Note that the cron must be setup for your shop for periodic triggering routines that poll payment data.

Order status on authorization

With this option you can change the status to which an order will be set after a successful authorization. In most cases leaving the default value seems to be a good idea.

Email Options

_images/configuration_screenshot_4.png

Send order confirmation

This option allows you to select whether a confirmation email for newly placed orders shall be sent by the shop. Note that, regardless this setting, a payment confirmation will be always sent by Amazon Payments.

Declined Payment Email Template

In this option you can select an email template which will be used for notifying customers about declined authorizations. Refer to the Email templates section to find out how to customize email templates.

Declined Payment Email Sender

With this option you can define the sender of the Authorization declined email notification. The sender can be selected from the pre-defined Magento email contacts (System ‣ Configuration ‣ Store Email Addresses).

Appearance Settings

In this section you can set the basic design options for the Amazon widgets.

_images/configuration_screenshot_5.png

Developer options

_images/configuration_screenshot_6.png

Allowed IPs (comma separated)

For testing or debugging purposes you can restrict access to Pay with Amazon checkout in your shop to certain IP numbers only. Pay with Amazon button will be shown only for the visitors coming from allowed IPs. You can set more than one allowed IP separated with commas.

Enable logging

The Pay with Amazon extension comes with a dedicated logging mechanism. Any exception, API call or IPN notification will be saved to the var/log/amazonpayments folder in your Magento installation. For your convenience logs are also accessible via creativestyle ‣ Amazon Payments ‣ Log preview in Magento admin. Refer to the Event logs section to get more details concerning the logging feature.