1. Documentation /
  2. Amazon Pay

Amazon Pay

Amazon Pay for WooCommerce allows you to offer a full express checkout experience to your customers. Buyers will be able to sign in to your store, and complete checkout using address and payment details selected from their Amazon account. Address and payment details from the Amazon account are used to populate your checkout page automatically, to allow the buyer to complete the purchase in a few clicks. The plugin also offers support for all back-office operations, and will allow you to manage transactions effectively from your WooCommerce Admin Panel. The solution supports:
  • One-time payments processing
  • Recurring payments for WooCommerce Subscriptions (separate purchase)
  • Strong Customer Authentication (SCA) required for transactions within the European Economic Area (EEA),in compliance with the Payments Systems Directive 2 (PSD2)
  • Multi-currency transactions (see dedicated paragraph)
  • Delivery notifications alerts for customers via Amazon Alexa devices

Requirements

↑ Back to top
  • Your store must be based in: Austria, Belgium, Cyprus, Denmark, France, Germany, Hungary, Ireland, Italy, Japan, Luxembourg, the Netherlands, Portugal, Spain, Sweden, the UK, or the US.
  • An SSL certificate. More info on how to get a free or low-cost SSL at: SSL and HTTPS.
  • An Amazon Payments Merchant account. Use an existing account or sign up for a new one with our extension. Note: This is not the same as a regular Amazon or Selling on Amazon account.
Prior to starting setup, we advise signing out of all Amazon accounts if you are auto-logged in.

Installation

↑ Back to top

For a quick start video on getting setup with Amazon Pay for WooCommerce, please refer to the Amazon Pay University tutorial.

  1. Download the .zip file from your WooCommerce.com account.
  2. Go to: WordPress Admin > Plugins > Add New to upload the file you downloaded with Choose File.
  3. Activate the extension.
  4. (Optional) If you are an Existing Amazon Pay merchant, replace the current version with the new one, and proceed.
More information at: Installing and Managing Plugins.

Amazon Pay Account Setup

↑ Back to top
  1. Go to: WooCommerce > Settings > Payments.
  2. Select Amazon Pay. You are taken to the configuration screen.
  3. Select store location from the Payment Region dropdown. This should also match the location of your Amazon Payment Merchant account.
  4. Enable/Disable – Enabled by default. Disable to turn off Amazon Pay or when testing.
  5. Select “Connect to Amazon Pay”. This opens a new window and displays the Amazon Pay Merchant Registration screen.
  6. Select your country of establishment and click on “Create an Amazon Payments merchant account”, you will be redirected to a login page.
    • Create your Amazon account: If you need to sign up for a new account.
    • Sign In: If you have an existing Amazon Pay Merchant account.

At the end of the Amazon Pay merchant onboarding process, click the Transfer Access Keys button to import your Amazon Pay credentials into WooCommerce.

Configuration

↑ Back to top

Below are the different options you can customize for the Amazon Pay plugin:

Amazon Pay Merchant Account Details

↑ Back to top
The Amazon Pay merchant account keys being transferred at the previous step will be shown in the configuration. Do not change the value of those input fields, unless you would need to modify the account being used in this store.

Subscriptions support

↑ Back to top
Make sure to set this option to “YES” from the dropdown if you wish to enable recurring payments for WooCommerce Subscriptions (separate purchase) after it’s installed and activated.

Use Sandbox

↑ Back to top
Select Yes from the dropdown to use for testing; no live payments are taken. You will need an Amazon Pay Sandbox test account to test transactions in this mode.

Advanced Configurations

↑ Back to top

IPN URL

↑ Back to top
Set the IPN endpoint of the store in your Seller Central account, following the instructions from the plugin configuration. Using IPNs optimizes notifications coming to your store and updates to Orders status.

Payment Settings

↑ Back to top
    • Payment Capture – Allows to define how to process the payment for your order, choosing between 3 options:
      • Authorize and capture – Completes authorization and capture for the order, when the order is placed.
      • Authorize – Only completes the payment authorization on order placement. Capture will need to be triggered manually at a later point in time.
      • Don’t authorize – This option will not trigger any payment operation on order placement, the order will only be confirmed. Use this option only in case you need to manage long term pre-orders.
    • Authorization processing mode – Defines the way the Amazon Pay API is going to return a response to your shop in terms of authorization results.
      • Synchronous – Default processing mode, recommended one. The result of the payment will be immediately available.
      • Asynchronous – In this case, the Amazon Pay API can return a Pending response in some cases. Use this processing mode only in case you are selling very high value items. Please note that the asynchronous mode cannot be set if thePayment Capture option is set to “Authorize and Capture”.

Display options

  • Button language: Select the preferred language for the Amazon Pay checkout. This configuration will change the language of the label shown below the Amazon Pay button, but also the language of the whole Amazon Pay experience, including buyer facing emails sent from Amazon Pay side.
  • Button color: 3 options are available, Gold, Light Gray and Dark Gray. Gold is the preferred option, as buyers associate this color with the Amazon brand.
  • Standard checkout button: Check the box to hide standard checkout button on the cart page. Amazon Pay will be the only checkout option in this case.
  • Classic Gateway: Check the box to include Amazon Pay as payment option on the payment selection page at the end of the checkout.
  • Amazon Pay on mini cart: Check the box to include the Amazon Pay button on your mini cart.
  • Amazon Pay on product pages: Check the box to include the Amazon Pay button on product pages.
  • Support Alexa Delivery Notifications: Check the box to allow customers to receive delivery updates for Amazon Pay orders via their Alexa devices. Not available for Royal Mail in the UK.

Miscellaneous

↑ Back to top
  • Debug: Use the Debug option in this section to enabled logging of API events in your WooCommerce system.
  • Enable Hide button mode: The “Enable hide button mode” option, allows to keep the module active, without showing the button to your customers. Use it only in case you are testing the solution before releasing it.

Multi-Currency support

↑ Back to top
Amazon Pay supports multi-currency transactions in WooCommerce. Amazon Pay for WooCommerce has been enhanced to detect the installation WooCommerce multi-currency extensions and to enable Amazon Pay multi-currency transactions. The Amazon Pay extension is compatible with the following multi-currency extensions:  When Amazon Pay and a WooCommerce multi-currency extension are activated, compatibility is detected and, if applicable, options are shown on the Amazon Pay Settings page under the Miscellaneous section. Note:
  • Not all multi-currency plugins show a list of supported currencies like the one above. Should a list appear, select all currencies configured in your store that you would like to offer for Amazon Pay as a checkout option.
  • Not all WooCommerce multi-currency plugins provide a currency conversion on an API level. Some, such as Currency Converter Widget display a “visual currency conversion only” without passing the value to Amazon Pay for order processing. In such cases, the price shown to the buyer will be in their currency, but the order is processed in your store’s currency.
  • Some multi-currency plugins, such as WooCommerce Currency Switcher, provide both options (display and conversion). In this case, it’s possible to select a “visual currency conversion” only or activate the currency conversion. The latter will activate the Amazon Pay multi-currency feature.

Customer Checkout Flow

↑ Back to top
Amazon Pay offers a full express checkout experience, which allows the buyer to start the journey signing in with their Amazon account early in the checkout flow. Two are the express button placements provided by the plugin: Cart Page Checkout Page

Sign in and details selection

When the buyer clicks on the Amazon Pay button, a redirect to the Amazon Pay hosted page happens, where the buyer can sign in with the Amazon account, and select address and payment details for the purchase. Order Review Page Clicking on “Continue to Checkout” the buyer will be redirected to the checkout page, where all the details coming from the Amazon Account are prompted for review. The buyer can simply review the details and complete the purchase. Processing and Thank You Page Amazon Pay as a classic payment gateway In addition to the express button placements, Amazon Pay can also be displayed as a classic payment gateway within your payment selection page at the end of the checkout. When the buyer selects Amazon Pay, they are redirected to the Amazon Pay page to confirm the delivery address (the one entered by the buyer during the checkout) and the payment instrument before the transaction is completed.

Admin Order Fulfillment Flow

↑ Back to top

When you open an Amazon Pay order within your WooCommerce admin, you will see an order fulfillment flow widget that allows you to make different actions based on the order status.

Order fulfillment widget for an order that has not been authorized.

Order fulfillment widget for an order that has been captured.

This widget allows you to perform the following actions:

  • Authorize – Authorize a payment but do not capture. Amazon recommends capturing payment once you have verified the order and begun processing it.
  • Authorize and Capture – Capture funds for the full order total amount.
  • Capture – Capture an authorized payment. Amazon recommends capturing payment once you have fulfilled the order.
  • Close authorization – Close an authorization and release funds without capturing.
  • Refund – If you captured a payment that is still open, you can refund X amount.

After each action, an order note is created, noting the status.

Frequently Asked Questions

↑ Back to top

How do I activate Affirm for Amazon Pay?

↑ Back to top
Affirm is available for US merchants only If you have not yet activated Amazon Pay, start here. You can sign up for Amazon Pay with Affirm directly within Seller Central, and enable it for your online store as soon as the next day. Before you get started, confirm that your US-based online store has Amazon Pay plugin version 2.3.0 or higher. You can find your plugin version by navigating to the Plugins section of your WordPress admin. From there, log in to Seller Central and follow these steps:
  1. Make sure you navigate to Amazon Pay (Production View)
  2. Go to the Gear Wheel in the upper right and select Account Info
  3. Under the Customer Payment Methods section, select Manage additional payment methods
  4. Find Affirm and select Get started
  5. Ensure you meet all eligibility requirements and fill out the necessary fields.
  6. Select Continue to pricing
  7. On the following page, you will be offered to see how the customer will see Affirm during checkout and the price per transaction. If you agree, select Confirm.
  8. Confirm your business details are correct and review Amazon Pay with Affirm’s Merchant Terms of Service and Privacy Policy. Select Submit when ready.
Once complete, you will begin to see Amazon Pay with Affirm as an option within Amazon Pay on your online store for eligible orders over $50. Note: It may take up to 24 hours for Affirm to be live on your online store.

Will this gateway work with X extension that modifies the WooCommerce checkout page?

↑ Back to top
Generally, no. Amazon Pay uses its own forms for payment and shipping, so plugins that add or modify the WooCommerce checkout may not work in these cases. As of version 1.6.0, compatibility with extensions that modify the checkout page has been added for:

Can I use Amazon Pay/Pay with Amazon/Amazon Payments Advanced with WooCommerce Subscriptions?

↑ Back to top
Yes, with limitations. This Amazon integration supports recurring payments with WooCommerce Subscriptions (separate purchase), but totals cannot be modified. More info at: Subscription Payment Methods & Gateways.

Where should I go to view my Amazon account balance?

↑ Back to top
To view your Amazon Payments Seller account balance, visit Seller Central. Note that when initially signing up, you need to use the link in the Amazon Pay plugin settings (WooCommerce > Settings > Payments > Amazon Pay) to ensure you’re signed up for the correct Amazon program.

Where can I find Amazon Pay Merchant credentials?

↑ Back to top
Go to Seller Central (links above), log into your account and go to: Integration > MWS Access.

Is Amazon Pay available in other languages?

↑ Back to top
Yes. Check out translations already done or in progress for Amazon Pay (Pay with Amazon/Amazon Payments Advanced) on GlotPress.

My Amazon Pay button is greyed out. Why?

↑ Back to top
If your Merchant account is in ‘suspend’ status, the Amazon Pay button on your site is greyed out, preventing customers from using this payment method. On hover, the error message “Amazon Pay is not available for this purchase. Sorry for the inconvenience” will display. You need to log into Seller Central and follow the notifications to fix your account status with Amazon, or contact Amazon Merchant support for assistance. The button will be re-activated once the Merchant account returns to active status. Affirm is available for US merchants only If you have not yet activated Amazon Pay, start here. You can sign up for Amazon Pay with Affirm directly within Seller Central, and enable it for your online store as soon as the next day. Before you get started, confirm that your US-based online store has Amazon Pay plugin version 2.3.0 or higher. You can find your plugin version by navigating to the Plugins section of your WordPress admin. From there, log in to Seller Central and follow these steps:
  1. Make sure you navigate to Amazon Pay (Production View)
  2. Go to the Gear Wheel in the upper right and select Account Info
  3. Under the Customer Payment Methods section, select Manage additional payment methods
  4. Find Affirm and select Get started
  5. Ensure you meet all eligibility requirements and fill out the necessary fields.
  6. Select Continue to pricing
  7. On the following page, you will be offered to see how the customer will see Affirm during checkout and the price per transaction. If you agree, select Confirm.
  8. Confirm your business details are correct and review Amazon Pay with Affirm’s Merchant Terms of Service and Privacy Policy. Select Submit when ready.
Once complete, you will begin to see Amazon Pay with Affirm as an option within Amazon Pay on your online store for eligible orders over $50. Note: It may take up to 24 hours for Affirm to be live on your online store.

Troubleshooting

↑ Back to top

Shipping costs are missing

↑ Back to top
This can occur if the Hide Shipping Costs option is enabled. Disabling should solve the issue. Go to WooCommerce > Settings > Shipping, untick the box, and save changes.

Error that “The above fields are required”

↑ Back to top
This is commonly caused by Company Name and/or Address Line 2 fields as required. Please go to Appearance > Customizer > WooCommerce > Checkout. Once there, set the Company Name and  Address Line 2 fields to either Hidden or Optional.

Issues with processing orders created with old plugin versions

↑ Back to top
In case you are experiencing issues with post-order processing on previous orders after upgrading to version 2.0.0+ of the Amazon Pay plugin, please follow this troubleshooting guide.

Questions and Feedback

↑ Back to top
Have a question before you buy? Please fill out this pre-sales form. Already purchased and need some assistance? Get in touch with a Happiness Engineer via the Help Desk.