This is an old revision of the document!
Table of Contents
- type:
- gateway
- name:
- Amazon Payments
- countrie:
- US
- support-added:
- 2.0
- auth-net-emulation:
- no
- supports-3dsecure:
- no
- gateway:
- https://payments.amazon.com/solutionproviders
Amazon Payments
Setting Up Amazon Payments for FoxyCart
- Login using the desired Amazon Payments account.
- Create a Login with Amazon profile.
- The Application Name and Description will be shown when buyers Login on your site.
- The Privacy Notice URL is required and should link to an appropriate page on your site.
- The Allowed Login Domain should be the secure URL that the checkout will be served from, for example: https://mystore.foxycart.com
- Consent to allow FoxyCart to make API calls on your account.
- Return to FoxyCart and see the Seller ID and Client ID you need to configure in your FoxyCart admin.
- The Seller ID can be found in your Amazon Payments account on Seller Central
- Login to your Seller Central account
- If not already selected, choose Amazon Payments Advanced (Production View) from the drop-down in the menu bar
- On the right side choose Settings→Integration Settings
- The Merchant ID shown is the value for Seller ID in your FoxyCart configuration screen
- The Client ID refers to your Login with Amazon Client ID. To get this value:
- Login to your Seller Central account
- Select Login with Amazon from the drop-down menu in the menu bar
- Select the application configured for your account
- The Client ID shown is the value you will enter for Client ID in the FoxyCart configuration page.
Setting up the Instant Payment Notifications
Important: Ensure this step is completed for your Amazon Payments account, as without it transactions could fail to complete correctly.
The Instant Payment Notification (IPN) feature allows FoxyCart to be informed about any delayed payment status changes that may occur at Amazon.
To add this setting:
- Login to your Seller Central account
- Head to “Integration Settings” under the “Settings” menu.
- For the “Integrator URL” setting, enter the URL
https://FOXYCART-STORE-DOMAIN/ipn.php
.- If your FoxyCart store domain is
mystore.foxycart.com
, your IPN URL would behttps://mystore.foxycart.com/ipn.php
. - If you had a custom SSL subdomain for your store like
secure.mystore.com
, your IPN URL would behttps://secure.mystore.com/ipn.php
.
Using multiple domains?
In some cases, you might be using multiple domains, so may need to add additional Allowed Login Domains. To do so, you:
- Login to https://sellercentral.amazon.com.
- Select “Login with Amazon” from the drop-down at the top of the page.
- Select the store from “Applications” on the left-side of the page.
- Under “Web Setting” in the main body of the page, click the “Edit” button.
- Add each domain used by the site under “Allowed Javascript Origins” by clicking “Add Another“.
Testing
Obtaining a Test Account
When you first access the Sandbox environment through Seller Central, Amazon recommends configuring some test buyer accounts to help with your integration testing. These test accounts can be modified to suit most use cases, including the addition of shipping addresses that might violate a business rule your company has about where items can be shipped. You can configure these accounts from Seller Central by going to the “Integration” tab and selecting “Test Accounts”.
With the customization available through Seller Central, Amazon encourages you to test as many scenarios as you see fit through multiple test buyer accounts.
Troubleshooting & Interpreting Response Codes
"We're Sorry" Error
If when trying Amazon Payments after entering your credentials in the administration you receive an error notice in the popup, look for the “Show Details” link and click that to see technical details for what went wrong. Usually you will see the following:
Error Summary 400 Bad Request The domain on which you are using the JavaScript SDK has not been whitelisted for your application.
This occurs when your Login with Amazon configuration is incorrect for your domain. To remedy this, login to your seller central account and choose 'Login with Amazon' from the drop-down menu at the top menu bar. Next, click the name of your configured application in the left sidebar and look for the section named 'Web Settings'. In the web settings section look for a configuration value called “Allowed JavaScript Origins” and ensure the value entered there matches the secure url on which the 'Pay with Amazon' button lives. For example, if the button was clicked from https://yourstore.foxycart.com/checkout/cart then the value for 'Allowed JavaScript Origins' should be “https://yourstore.foxycart.com” (without the quotes)
Important Notes and Caveats
User Notes and Experiences
If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date. We reserve the right to edit or remove comments that don't add value to this page.