Installation and configuration

Set up Amazon Pay for FoxyCart

Associate your Amazon Pay account with FoxyCart on the Get Started with Amazon Pay page.

To associate your Amazon Pay account with Foxycart:

1. Click the Get Started button to begin the guided registration process.
2. Create or sign in to your Amazon Pay account on Seller Central.
3. Create a Login with Amazon profile:
• The Business Name and Application Description are shown when buyers sign in on your site.
• The Privacy Policy URL is required and should link to a page on your site that describes your privacy policy.
• The Allowed login domains should be the secure URL that the checkout will be served from (for example: https://mystore.foxycart.com).
4. Check the consent box to allow FoxyCart to make API calls on your account.
5. Click I Agree to submit your consent.

Set up your Amazon Pay credentials in FoxyCart

1. Sign in to the FoxyCart admin page.
2. In a new tab, click Settings > Payment.
3. Scroll down the page and check the Accept payments using your Amazon account check box.
4. Note the Seller ID, Client ID and MWS Auth Token fields. The next few steps show how to populate these fields using values from your Amazon Pay account in Seller Central.
   1. Sign in to your Seller Central account.
   2. Select Amazon Pay (Production View) from the Marketplace Switcher drop-down box at the top of the screen.
      Note: If you have reduced the size of your browser window, the Marketplace Switcher may appear as a double-arrow icon.
   3. In the main menu, choose Integration > MWS Access Key.
   4. Copy your Seller ID from Seller Central to the Seller ID field on the FoxyCart admin configuration page.
   5. Copy your Client ID from Seller Central to the Client ID field on the FoxyCart admin configuration page.
   6. Verify that your solution provider in Seller Central is listed as FoxyCart.
   7. In Seller Central, in MWS Account Information, click the Show Secret button under Secret Access Key. Copy your MWS Secret Access Key to the MWS Auth Token field on the FoxyCart admin configuration page.

Set up the Instant Payment Notifications Settings

Important: This step must be completed for your Amazon Pay account. Without it, transactions may fail to complete correctly.

The Instant Payment Notification (IPN) settings feature allows FoxyCart to be informed about any delayed payment status changes that may occur at Amazon.

To add this setting:

1. Sign in to your Seller Central account.
2. Select Amazon Pay (Production View) from the Marketplace Switcher drop-down box at the top of the screen.
   Note: If you have reduced the size of your browser window, the Marketplace Switcher may appear as a double-arrow icon.
3. Click Integration Settings under Settings in the main menu.
4. Enter one of the following for the Integrator URL setting:
   • https://FOXYCART-STORE-DOMAIN/ipn.php.
   • If your FoxyCart store domain is foxycart.com, your IPN URL is https://mystore.foxycart.com/ipn.php
   • If you have a custom SSL subdomain for your store (for example, mystore.com), your IPN URL is https://secure.mystore.com/ipn.php.
   
   

Whitelist your FoxyCart domain

By default, web browsers block JavaScript calls from one origin that attempt to call a script on another origin. To use FoxyCart to make calls on your behalf, you must add your FoxyCart checkout domain to your Amazon Pay account.

1. Sign in to your Seller Central account.
2. Select Login with Amazon from the Marketplace Switcher dropdown at the top of the page.
3. From the Applications section on the left side of the page, select your store.
4. Under the Web Settings section, click the Edit button.
5. Add your FoxyCart checkout domain.
   For example, if your checkout is at https://yourstore.foxycart.com/checkout, the value for Allowed JavaScript Origins would be https://yourstore.foxycart.com/.
6. Add each domain used by your site under Allowed Javascript Origins by clicking Add Another.

Test Amazon Pay and Login with Amazon in FoxyCart

The Amazon Pay Sandbox mode enables you to thoroughly test Amazon Pay in FoxyCart before going live. When you test in Sandbox mode, you can simulate the buyer experience as they navigate through the Amazon Pay widgets on your website.

You can also simulate error conditions that help you to better manage your buyer's experience in the event that something goes wrong during the checkout experience. For example, you can test what happens when shipping addresses that violate your company's business rules are used.

To use the Sandbox mode, you need to set up an Amazon Pay Sandbox account. For more information see the Creating test accounts in Seller Central for Amazon Pay video.