Setting Up Amazon Pay

Amazon Pay and Login with Amazon work together to create a great buyer experience.

For more information, see the Amazon Pay and Login with Amazon documentation for Magento 2.

Connect to Amazon Pay

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the upper-right corner, set the Scope to establish where the Amazon Pay configuration applies.

  3. In the left panel, expand Sales and choose Payment Methods.

  4. Expand Other Payment Methods.

  5. For Amazon Pay, click Configure .

    Sales configuration - Amazon Pay Amazon Pay

  6. Click Get started with account registration.

    Do not use your personal Amazon account for Amazon Pay.

    • If you do not yet have an Amazon seller account, choose Create a new signin and click Select. Then, follow the onscreen instructions to create a new account.

      Create Amazon Pay Account

    • If you already have an Amazon merchant account, choose Use existing Amazon signin and click Select.

When you have your account information, complete the following sections.


  1. Expand Expansion selector the Credentials section.  

    Your credentials are transferred automatically from your Amazon Pay account to the Magento Admin. Your credentials can also be found in Amazon Seller Central in both Production and Sandbox modes.

    To use test credentials from the Amazon Pay Sandbox, do the following:

    • Get your Test Credentials for the Amazon Pay Sandbox.

    • In the Magento Amazon Pay configuration under Credentials, select the Test Credentials checkbox.

    • Enter the following credentials that you copied from the Amazon Pay Sandbox on Amazon Seller Central:

      • Merchant Id
      • Access Key Id
      • Secret Access Key
      • Client ID
      • Client Secret
    • Set Sandbox to Yes.

      When you are through testing and ready to go live with Amazon Pay, return to the configuration and clear the Test Credentials checkbox. Then, set Sandbox to No and click Save Config.

  2. Verify the Payment Region for the store.

    Sales configuration - Amazon Pay credentials Credentials

  3. When complete, click Save Config.

    Look for the message, Your Amazon configuration is valid at the top of the Configuration page.

    • If your credentials are valid, continue with the configuration.

    • Otherwise, correct your credentials and try again.


  1. Expand Expansion selector the Options section.

  2. Set Enable Amazon Pay to Yes.

  3. Set Enable Login with Amazon to Yes.

  4. Set Payment Action to one of the following:

    Charge on Shipment (Default) Amazon receives a capture request and charges the customer when an invoice is created in Magento.
    Charge on Order Amazon creates the invoice and charges the customer when the order is placed.
  5. Set Authorization Mode to one of the following to determine the method that is used to transmit authorization data.

    Immediate (Default) Makes the disposition of an authorization available within a couple of seconds.
    Automatic (Recommended) Uses synchronous authorization if possible, and switches to asynchronous processing as needed, for some declines. The change in processing modes is transparent to the user. The status of sales order is Pending while the disposition of authorization is outstanding.
  6. Set Update Mechanism to one of the following:

    Data Polling via Cron job (Default) Uses the standard Magento notification process that is scheduled by Cron job.
    Instant Payment Notifications (IPN) Sends notifications to the Instant Payment Notification URL.

    Sales configuration - Amazon Pay options Options



  1. Expand the Frontend section.

  2. (Optional) If your store is available in multiple languages, you can display the text on the Amazon Pay button in a different language for each store view.

    To override the default display language for the current store view, enter one of the following language parameters for Button Display Language:

    • en-GB - English (Great Britain)
    • de-DE - German (Germany)
    • fr-FR - French (France)
    • it-IT - Italian (Italy)
    • sp-SP - Spanish (Spain)

    To learn more, see Language in the Amazon Pay Integration Guide.

  3. Set Button Color to one of the following:

    • Gold
    • Light Gray
    • Dark Gray

    To learn more, see the Merchant Tools page on the Amazon Pay website.

  4. Set Button Size to one of the following:

    • Small
    • Medium
    • Large
    • Extra Large
  5. Choose Yes for each feature that you want to enable for the current store view:

    • Login with Amazon available in authentication popup
    • Amazon Pay button on Product Page
    • Amazon Pay button in minicart
    • Display Amazon Pay Method


Sales Options

  1. Expand the Sales Options section.

  2. Enter the Store Name.

    Sales configuration - Amazon Pay sales options Sales Options

  3. If you have a payment region in EU or UK, you may have an option for Use Multi-currency.

    Amazon Pay multi-currency feature is supported for the payment regions EU and UK.

    Amazon Pay multi-currency supports:

    • Australian Dollar (AUD)
    • British Pound (GBP)
    • Danish Krone (DKK)
    • Euro (EUR)
    • Hong Kong Dollar (HKD)
    • Japanese Yen (JPY)
    • New Zealand Dollar (NZD)
    • Norwegian Krone (NOK)
    • South African Rand (ZAR)
    • Swedish Krone (SEK)
    • Swiss Franc (CHF)
    • United States Dollar (USD)

    Sales configuration - Amazon Pay multi-currency Sales Options

Developer Options

  1. Expand Expansion selector Developer Options.

  2. Make sure that Logging is set to Yes.

    After the setup is complete and logs are generated, you can return to this location and select a link in Developer Logs to download to view Client and IPN logs. If logs are not available or have not been generated, a message displays No logs are currently available.

  3. To limit the availability of the Login with Amazon and Amazon Pay buttons, specify the Allowed IPs.

    Enter the IP address of each, separated by a comma. The specified IP addresses are added to an allow list. When this field is blank, the buttons are available for all IP addresses.

    Sales configuration - Amazon Pay developer options Amazon Pay Developer Options

Complete the configuration

  1. When the settings are complete, click Save Config.

  2. In the message at the top of the page to refresh cache types, click Cache Management.

  3. Select the checkbox of each invalid cache.

  4. With the control set to Refresh, click Submit.