Important: The current guide is for the Amazon Pay integration based on Amazon Checkout v2 implemented for X-Cart versions 5.5.1.x. Users of earlier X-Cart versions (5.1.0.х - 5.5.0.x) should refer to the guide Getting Started with Amazon Pay (Amazon Checkout v1).
This guide assumes that the following prerequisites have been met:
The Amazon Pay add-on has been installed and enabled in your X-Cart store. Add-on installation instructions for X-Cart 5.5.x are available.
Your X-Cart store has been configured to use HTTPS both in the storefront and in the Admin area as Amazon Pay requires HTTPS for proper functioning.
To start using Amazon Pay:
In your X-Cart store's Admin area, go to the Payment Methods page (Store > Payment Methods) and ensure that Amazon Pay is on the list of your online payment methods.
If, for some reason, Amazon Pay is not on the list, you can add it as described in the section Adding Online Payment Methods.
Choose to configure the settings for Amazon Pay by clicking on the Settings link.
The Amazon Pay Settings page opens.
Using the drop-down box on the page, specify the country of your Amazon Merchant account registration and click Save changes.
(If you do not yet have an account, you will be able to create one later; for now, simply select the country you require.)
On the following page, you will be presented with a form to input your Amazon Pay connection details.
There is no need to complete these form fields manually. The "Sign Up Now" link at the top of the page enables you to complete the onboarding process seamlessly, automatically populating the form with your Amazon Pay connection details.
If you do not see the "Sign Up Now" link at the top of the page and instead encounter the message 'The "Sign Up" feature requires https to be properly set up for your store' (as shown in the screenshot below), it indicates that HTTPS has not been configured correctly. You will need to address this issue before proceeding with the Amazon Pay configuration.
Upon clicking on the "Sign Up Now" link, you will be redirected to the Amazon Pay onboarding flow. First, you will need to specify the country of your business location.
Once you specify the country, you will be provided with an option to either log in using your existing Amazon Payments merchant account or to sign up for a new one.
New account
If you choose to create a new account, you will be redirected to an account setup process where you can input the information required by Amazon Pay for merchants.
Follow the instructions on the screen to provide the necessary information as required. The final step of the onboarding process will be dedicated to connecting your store to Amazon Pay. For further instructions, see Step 7 of the current procedure.
Existing account
If you choose to log in with an existing Amazon Payments account, you will be required to sign in to Seller Central.
After signing in, you will find yourself in the final step of the Amazon Pay onboarding flow - the one dedicated to connecting your store to Amazon Pay.
Confirm that the website domain URL and the privacy policy URL are correct, and click Next.
To enable your X-Cart store to access the API to use Amazon Pay, you will need to provide your store with the API keys associated with your Amazon Pay merchant account. To do so, in the step "Share access keys with X-Cart", click the Transfer API Keys button.
After the transfer is complete, the onboarding process concludes. You should be able to see a success message. Also, you should receive an email message from Amazon Pay at your merchant account registration email address stating that your website details are under review.
You can now close the page where you have completed the onboarding process and go back to your X-Cart store's Admin area. There you will find that the connection details fields on the Amazon Pay Settings page have been populated with the API keys from your Amazon Payments merchant account. This includes Merchant ID, Store ID, Public Key ID, and Private key.Since you specified the country of your merchant account registration earlier, your country selection will also appear in the field Country of Merchant account. This setting determines your currency.
Along with your Amazon Pay connection details, the Amazon Pay Settings page includes a few other settings, such as Operation mode, Capture mode, Type of authorization request, etc. Review these settings and ensure they are configured according to your preferences. See the section Amazon Pay Settings (Amazon Pay Checkout v2) for details.
For demonstration purposes, we are going to configure our integration to run in Test / Sandbox mode. You can also use Test / Sandbox mode if you want to try the integration without having to pay for orders with real money, but in this case, you will need to place orders using test customer accounts. Such test customer accounts can be created using Amazon's Seller Central.
Important: To be able to receive payments from customers, you must set Amazon Pay to run in Live / Production mode.
After making any changes to the settings on the Amazon Pay Settings page, be sure to apply them using the Save changes button.
Activate the Amazon Pay method for your customers using one of the following methods:
That is all. Your Amazon Pay integration is ready to use.
Once your website URL is approved by Amazon Payments, you will receive a notification at your merchant account registration email address. Following this, your Amazon Pay integration will be fully operational.
Related pages: