Getting started with Amazon Pay
page last edited on 04 December 2017
This guide assumes that the Amazon Pay addon has been installed and enabled in your store.
To start using Amazon Pay:
Register your Amazon Pay account. The Amazon Pay solution is packed with enhanced features. To benefit from it, you’ll need to register for a new Amazon Pay account.
Sign up for FREE:
Log in to Amazon’s Seller Central at https://sellercentral.amazon.com to complete a few extra steps. If you’ve registered for multiple Amazon services, you’ll see a dropdown at the top of the page that lets you move between the different services.
Create a test account to use in the Sandbox mode.
Select “Amazon Payments Advanced (Sandbox View)” from the drop-down box at the top of the screen. Under “Integration” -> “Test Accounts”, you can create test accounts for use in Sandbox mode. Sandbox mode can be used to make test purchases without processing an actual payment.
Set up your account
Select “Amazon Payments Advanced (Production View)” from the drop-down box at the top of the screen. You’ll need to complete a tax interview and set up your bank account, even if you’ve already done it for an existing account. You’ll see a message and links to complete these steps on your home page when you switch to the Production View.
Get your account keys (These will need to be entered in X-Cart) in the “Integration” -> “MWS Access Key” section:
- Your Merchant ID
- Your Access Key ID
- Your Secret Access Key
In a new browser tab or window, log in to the Admin interface of your X-Cart store. Copy the account keys from Seller Central and paste them into X-Cart on the Amazon Pay addon settings page. Specify the rest of the settings (Operation mode, Currency, Capture mode) as required and save the configuration. We recommend setting the Operation mode to “Test” first, so you can create some orders in Sandbox mode and see how it works. For more info on the module configuration settings, see:
In Seller Central, configure your instant notification settings (IPN):
Under “Settings” -> “Integration Settings”, enter your Merchant URL.
The Sandbox and Production accounts each have separate values for this setting, so you must switch the view using the drop-down box at the top of the screen to set both. The URL you’ll need to enter is
httрs://<YOUR_XCART_STORE>/cart.php?target=amazon_checkout&isipn=Y(HTTPS is required when you configure your IPN URL for the production account. HTTP is only allowed for testing since no private customer data is passed in test mode).
If you wish to use your own graphics (company logo) in the pop-up window where buyers will sign in to Amazon Pay, upload the image in Seller Central (This is called “Pop-up Window Banner” under “Settings” -> “Integration Settings”). Banner images must be 520 pixels wide by 50 pixels tall, and they must have no animation. Image files should be in .jpg or .gif format.
Test your setup in Sandbox mode. You can use the test account you set up earlier. We recommend trying out both your customer-facing checkout flow as well as order management to get a feel for how orders are processed.
Once you’re ready to go live with your Amazon Pay addon, switch the addon to production mode by setting its Operation mode to “Live”, and you should be ready to go.
You manage orders entirely within X-Cart’s order management interface, as you would with a standard credit card payment gateway. There’s no need to process orders via Amazon’s Seller Central website as with Checkout by Amazon.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.