After the successful installation you can proceed to the configuration. In Magento admin go to(or tab).
Available options are grouped in following sections:
Amazon Payments Account¶
In this section you can define your Amazon Payments seller account credentials.
Merchant ID, Access Key ID, Secret Access Key¶
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.
Validate Amazon Payments account¶
This button is designed to validate your Amazon Payments account credentials. Please use it to check whether your credentials (Merchant ID, Access Key ID, Secret Access Key and Marketplace) are valid or not.
Please note that the above feature will validate ANY Amazon MWS account, also such one that is not registered to Amazon Payments.
In this section you can enable or disable the Pay with Amazon service and define basic settings of the extension.
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 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 always has to be 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 different 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.
You can select the desired payment action taken after an order is placed. Available options are:
- Manual authorization - the order reference is created only. Authorization must be requested manually by clicking Authorize button on the order preview page in Magento admin.
- Authorize (default) - order reference creation is followed by automatic authorization request. Capture must be requested manually by creating an invoice with Capture online option selected.
- Authorize & capture - order reference creation is followed by automatic authorization and capture request. 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.
- ERP mode - same as Manual authorization, but further payment processing (authorization, capture, IPN notifications handling) is blocked in Magento. In this mode, it is assumed that after order reference creation rest of the payment processing steps will be handled by merchant’s external ERP system.
Please use Authorize & capture method only in case you are shipping goods on the same day they are ordered and you have been white-listed for this service.
Please do not use ERP mode unless your ERP system supports Amazon Payments transactions processing.
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 valid SSL certificate (issued by a trusted CA) installed on your server and correctly configured Secure Base URL and Use Secure URLs in Frontend config options (section). 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.
New order status¶
With this option you can choose the status for newly created orders. Statuses assigned to New state are allowed only. Please note that this config option becomes obsolete when you use synchronous authorization, initial order status will be set to Order status on authorization value then.
Login with Amazon¶
In this section you can configure Login with Amazon service.
Enable Login with Amazon¶
By switching this option you can enable or disable Login with Amazon feature. This service must be enabled if you want to create customer accounts in your Magento shop when order is placed and to make sure that any of the orders paid with Pay with Amazon will be never a guest order.
The Client ID identifies your website for Login with Amazon service. Please refer to the Obtaining Client ID section to find out how to get the value of your Client ID.
Select the method the authentication will be processed. By default Pop-up is used, meaning that after pressing Pay or Login with Amazon button, new window with Amazon login form opens, this requires the page you are placing the buttons on to be SSL-secured though. Choosing Redirect experience your customers will be redirected to Amazon login form in the current window after pressing Pay or Login with Amazon button. For the Redirect experience it is required to set Allowed Return URLs in the Login with Amazon section in your Seller Central.
Be aware that Pop-up authentication experience used by default requires the page the button is placed on to be in the SSL mode. This requirement is fulfilled by switching the cart page into SSL on the fly. This may lead to the unexpected results, especially if you are using some non-default Magento extensions (eg. AJAX-based adding to cart). It is always advised to test the extension in the staging environment prior to the production deployment.
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.
Order confirmation emails are not sent unless authorization is confirmed. If the emails are not sent, even you have above option enabled, it is very likely that Amazon Payments transactions are not updated. In such a case please make sure your shop accepts IPN notifications or polls transaction data in the cronjob.
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 ().
Common Appearance Settings¶
In this section you can set size (width and height) of Amazon widgets used in the checkout process.
Use responsive widgets¶
With this option you can decide if Amazon widgets used in the checkout (address book, wallet) will adapt to the layout by filling whole container area. This behavior allows to set widget size by defining size of its container in the external CSS file, making Amazon checkout compatible and easy to use with responsive layouts. Disabling this option will change the widgets to use explicit sizes defined in the next config options of this section.
Address widget width, Address widget height¶
In this option you can set size in pixels (width and height) of Amazon address book widget for disabled Use responsive widgets option.
Appearance Settings for Login and Pay with Amazon¶
These settings apply to the design (type, size and color) of the buttons, both Pay with Amazon and Login with Amazon, when Enable Login with Amazon option is set to Yes, therefore they become irrelevant if you don’t use Login with Amazon service, you may be interested then in Appearance Settings for standalone Pay with Amazon.
Appearance Settings for standalone Pay with Amazon¶
These settings apply to the design (size and color) of the Pay with Amazon button when Enable Login with Amazon option is set to No, therefore they become irrelevant if you use Login with Amazon service, Appearance Settings for Login and Pay with Amazon are applied then.
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.
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 Event logs section to get more details concerning the logging feature.in Magento admin. Refer to the