Overview

Amazon Simple Pay allows your customers to pay for their orders using their Amazon.com account - the same account they use to purchase products on Amazon.com. When enabled, customers will see an Amazon Payments payment method during the checkout process:

You can read more about Amazon Payments on their website: http://payments.amazon.com

Requirements

PHP 5 or newer

CURL and OpenSSL

How it Works

1. Customer selects Amazon Payments as a payment method during checkout
2. Customer is sent to Amazon.com to submit payment, where they can login with their Amazon account or create one
3. Customer selects a payment source from those listed on their Amazon.com account, and confirms payment
4. Customer is returned to your website, and sees a thank you page and the order is stored in Squirrelcart's database
5. At this point, the payment can have a status of successful, initiated, or reserved (meaning you then have to click "settle" in your Amazon Payments control panel upon shipment.

 

IPN Feature

Amazon Simple Pay has an IPN feature, which stands for Instant Payment Notification. This feature is automatically enabled when you enable Amazon Simple Pay. When you make any change to a payment in Amazon Payment's control panel, Amazon will notify Squirrelcart on your website of the change. Squirrelcart will update the IPN Log field on the corresponding order and add additional order status fields as needed.

 

Setup Instructions

1. If you don't have an Amazon Payments business account, sign up for one here:
   https://payments.amazon.com/sdui/sdui/premiumaccount
   
   Follow the instructions they provide, including confirming your email address, and adding a bank account.
2. Go to the Amazon Web Services website:
   http://www.amazon.com/webservices
3. Login. If it is your first time using AWS, you will be prompted to create a new account.
4. Click the Account tab, and then click the Security Credentials link:
   
5. You should see something like this:
   
6. Click the Show link under Secret Access Key so it will appear
7. Copy the Access Key ID and the Secret Access Key (or write them down very carefully!)
8. Login to Squirrelcart as store admin, and enter your control panel
9. Enter your Payments Method table
   
10. Click the record row labeled Amazon Payments - Amazon Simple Pay
11. Paste your Access Key ID in the Access Key ID field
12. Paste your Secret Access Key in the Secret Access Key field
13. Make sure the Amazon Mode field is set to Live
14. Set the Transaction Type field. For help, click the field label
15. IPN (Instant Payment Notification) will notify Squirrelcart whenever a change is made to a payment (refund, settle, etc...). To receive an email to the email address on your Amazon account every time an IPN occurs, check the Test IPN checkbox. This is for testing purposes and is optional.
16. Check the Enabled field
17. Click

Additional Steps

If your are using a new Amazon Payments account, no additional changes are needed. If you are using an account that you may have changed settings on previously, you should follow these additional steps to ensure your settings match the default for a new account.

1. Login to your Amazon Payments business account here:
   http://payments.amazon.com
2. Click Your Account
3. Click Edit My Account Settings
4. Click Manage Developer and Seller Preferences
5. Confirm that Sign the buttons? is checked. If not, check it.
6. Make sure all of the following fields are blank:
   Return URL
   User Abandon URL
   URL for Instant Payment Notification
7. If you made any changes, click Confirm to save them.

 

Testing

Easy Way

The easiest way to test to see if your Amazon Payments setup is working is to create a product that costs $1.00 and set the shipping for that product to $0.00. You can then add that item to the cart and checkout using Amazon Payments. You'll need to submit payment using a different Amazon account then the one you are using for receiving payments.

 

Sandbox - not recommended for most users

Testing with Amazon's sandbox will take more time. Amazon's sandbox is geared towards developers and allows you to test payments on a test environment using different user accounts than their regular system. We don't recommend testing this way as it is more complicated and should not be needed for the average user. We don't provide support for using their sandbox, but here is the general idea of how to do this:

1. Sign up for a sandbox business account here:
   https://payments-sandbox.amazon.com/sdui/sdui/premiumaccount
2. Follow the setup instructions above, but when logging into the AWS website (steps 2 - 10) use the same account info you used when creating your sandbox account
3. When modifying the Amazon Payments (PBA) payment method in Squirrelcart, set the Amazon Mode field to Test (Sandbox)
4. Sign up for a sandbox personal account here, which you can use for sending test payments:
   https://payments-sandbox.amazon.com/sdui/sdui/basicaccount
5. When done testing, you'll need to follow the setup instructions again using your regular Amazon Payments and AWS accounts.

 

 

Troubleshooting

The following information should help when troubleshooting problems submitting payments via Amazon Payments.

Signatures do not match

If you receive this error during checkout, it indicates that your Access Key ID and/or Secret Access Key entered in Squirrelcart are incorrect

payment failed

When a status of PF is returned from Amazon, Squirrelcart generates this error. This can be due to just about anything, and unfortunately Amazon does not provide more information as to why payment failed. This could be due to insufficient funds, fraud check failure, or other issues. If you are receiving this error and feel that you should not be, you'll need to contact Amazon Payments support for assistance.

 

 

---

© 2001-2016 Lighthouse Development. All Rights Reserved.