Overview↑ Back to top
Amazon Simple Pay for WooCommerce sends your customers to Amazon’s secure payment website to enter their payment information. Customers can use their credit card or Amazon Payments balance to pay for their order. You’re just moments away from getting the gateway setup and accepting payments!
Installation↑ Back to top
- Download the extension from your dashboard
- Goto Plugins > Add New > Upload and select the ZIP file you just downloaded
- Click Install Now, and then Activate
- Click the Configure link and read the next section to learn how to setup and configure the plugin.
Setup and Configuration↑ Back to top
First, open the Amazon AWS Account menu and click on “Security Credentials”:
Login to your Amazon account:
Click the plus symbol next to “Access Keys”:
Then click on “Create new access key”:
Your new access key and secret key will be displayed. Copy these down, as once you exit this page you will not be able to view your secret key again. You may want to click the “Download Key file” link so you can save a copy of these keys on your computer.
Now, log into your WooCommerce store and browse to WooCommerce > Settings > Checkout > Amazon Simple Pay. Enter the access key and secret key into the text boxes:
Click “Save” and that’s it! You are now ready to accept payments via Amazon Simple Pay! If you want to tweak settings and customize the checkout process, keep reading.
Extension Settings↑ Back to top
- Enabled – This will enable the gateway to be used by customers to checkout.
- Title – This is the text shown for the payment during checkout and on the Order Received page.
- Description – This is the text shown under the title during checkout. Limited HTML is allowed. In the “Sandbox” environment, this section will also display a notice.
- Environment – This is the API environment used for transactions, defaulting to “Production”. Your production access & secret key will work in the “Sandbox” environment, but you must first sign up for an Sandbox account.
- AWS Access Key – This is the AWS access key for your Amazon account. Sign into your AWS account to get this by following the instructions above.
- AWS Secret Key – This is the AWS secret key for your Amazon account. Sign into your AWS account to get this by following the instructions above.
- Debug Mode – Enable this is you are having issues correctly processing transactions. You can either log API requests / responses directly to the checkout / thank you page, save them to the WooCommerce Error Log (found under WooCommerce > System Status > Logs), or both. As a best practice, please do not enable this unless you are having issues with the plugin.
Checkout Flow↑ Back to top
After entering their information on the checkout page, the customer can select Amazon as a payment method:
After clicking “Place Order”, they are redirected to Amazon:
And prompted to sign into their Amazon account:
The customer can select an existing payment method stored on their Amazon account, or add a new one:
Then they are prompted to confirm their payment:
After clicking confirm, the customer’s payment is processed:
Finally, the status of their payment is displayed and the customer is prompted to return to your WooCommerce store:
When they click “Continue” they are redirected back to the “Order Received” page on your store.
Troubleshooting↑ Back to top
Having trouble? Follow these steps to make sure everything is setup correctly before posting a support request:
- Check that your AWS Access Key and Secret Key are correct.
- Double-check that your AWS Access Key and Secret Key are correct.
- Enable debug mode to the checkout page and review the errors messages that Amazon is providing.
- Enable debug both to the logs and submit a support ticket, with the log found under WooCommerce > System Status > Logs as an attachment.
IPN Issues↑ Back to top
Amazon Simple Pay relies on Instant Payment Notifications (IPN) sent from Amazon to your WooCommerce store to properly update the payment status for each order. Your store must receive these IPNs properly in order for orders to be processed correctly. Check the IPN status under WooCommerce > System Status to confirm that you can receive IPNs. If you continue to have issues with IPNs, please enabled debug mode to the log and submit a support request with the log file as an attachment.
For Developers↑ Back to top
Filters↑ Back to top
There are two filters available to customize the transaction information that is sent to Amazon:
apply_filters( 'wc_amazon_simple_pay_button_parameters', $this->parameters, $order )which passes in the button parameters and the WC_Order object. Use this filter to modify the payment description, add a co-branding logo, and more.
apply_filters( 'wc_amazon_fps_api_request_parameters', $this->parameters );which passes in the request parameters. Use this filter to modify the charge description.