Table of Contents
- Amazon Payments
Before You Begin…
Do you already have an Amazon merchant account? Amazon has a few different options, including Checkout by Amazon (CBA), Amazon Simple Pay (ASP), and Flexible Payment System (FPS). None of those are what you're going to use here.
Instead, this is Amazon's latest integration, “Amazon Payments”. Even if you already have another Amazon merchant account, you'll need to complete the steps below. If you attempt to use credentials from a different Amazon system, you'll get errors. We know this is confusing, but ASP and FPS are going away soon, at which point things likely will become more clear.
Accepting donations, or selling alcohol, smoking/tobacco or higher risk products?
Before getting started - we recommend ensuring that the types of products/services you will be selling through Amazon Payments will meet their Acceptable Use policy. Amazon currently do not allow donations to be accepted, or to sell alcohol or smoking/tobacco products, along with a number of other restrictions. If you're not sure if your business type is supported, we recommend reaching out to Amazon Payments support to clarify with them.
What about my existing subscribers on ASP?
Glad you asked! Get in touch with us for more info, but Amazon will announce details by mid-May. Your ASP subscriptions will be able to transfer to FoxyCart to run on Pay with Amazon, without any action required from your customers.
Check with Amazon about your Sales Velocity
Some of our users have run into errors accepting payments for larger dollar amounts. This is due to Amazon's “sales velocity”. This is beyond our control at FoxyCart, but is worth checking with Amazon about if you sometimes get large orders or if you're expecting more sales than usual.
Per Customer Billing Limits (per month)
Amazon limits the monthly charges a new Seller can make to a customers account when they chose to store their payment information with your store. Please see their policy for more information and how to contact them to request an increase.
Setting Up Amazon Payments for FoxyCart
Important: To ensure that FoxyCart is provided the necessary permissions with your account, ensure that you use the registration link shown in step 1 below.
- 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.
- If you don't already have the FoxyCart admin open, go there in a new tab, and click the settings → payment page link. Scroll down a little to find the “Accept payments using your Amazon account” checkbox. Check it and notice the Seller ID, Client ID and MWS Auth Token fields. We'll get those in the next steps. (Keep the FoxyCart admin open in a browser tab so you can copy/paste the values.)
- All three fields 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. (This should be to the left of the magnifying glass icon in the top right. Depending on your browser screen size, this might be a little double-arrow icon you need to click.)
- In the top menu choose Integration→MWS Access Key
- The Seller ID shown is the value for Seller ID in your FoxyCart configuration screen.
- The Client ID shown is the value you will enter for Client ID in the FoxyCart configuration page.
- Make sure your solution provider is FoxyCart.
- To obtain the MWS AuthToken click the “Show Secret” button. It should be in the format of
x's are hex characters (letters and numbers). Copy and paste its value to the appropriate field 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.
- Make sure you're on your Production (not Sandbox) account. (If you're on Sandbox, you'll see “Sandbox” in the upper left, under the Amazon logo.)
- For the “Integrator URL” setting, enter the URL
Whitelist your FoxyCart Domain
- 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.
- In the next setting for “Allowed Return URLs”, you'll also need to enter in a specific URL for your checkout. Again, if your checkout is
https://yourstore.foxycart.com/checkout, you will need to enter an “Allowed Return URL” of
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
Resolving Suspended Merchant Agreements
If a customer's subscription has ended up in a suspended state due to a payment method being declined - they will need to update their payment details in their Amazon Pay account. You can send them to this page for steps they can take to bring the agreement back into an open state.
"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:
Important Notes and Caveats
Possible Action: Datafeed Handling
An Amazon FPS transaction may not process instantly, so at the time we process the initial transaction, we don't know if it was approved or not. To handle this, transactions are initially marked as pending, and when we get a confirmation from Amazon on the result of the transaction, we update it accordingly. Each time the status changes, a datafeed will be sent to your endpoint if configured with the transaction details and the status node will be present.
The status node can contain one of three different values:
rejected. Depending on the types of actions you're needing to perform at your datafeed endpoint, you need to make sure the appropriate status value is present.
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.