Amazon Pay customer experience
page last edited on 04 December 2017
In the Customer area of your X-Cart store, in all the locations from which buyers can initiate checkout, the Amazon Pay addon adds a Pay with Amazon button:
Here’s what it looks like:
Once the Amazon Pay button is clicked, a pop-up window titled “Amazon Pay: Sign In” is displayed where the buyer is asked for their Amazon Pay account email address and password:
After the buyer successfully authenticates, they find themselves on a special checkout page in X-Cart which has two Amazon widgets embedded in it: the AddressBook widget (the “Address Book” section) where the buyer can select a shipping address from their Amazon Pay account or add a new one and the Wallet widget (the “Payment Method” section) where the buyer can select a payment method from their Amazon Pay account:
The buyer stays on your store’s site throughout the checkout process, without ever being redirected to Amazon.
After selecting a shipping address and a payment method from their account, the buyer selects a shipping method. X-Cart uses the information provided by the customer to calculate the shipping cost and taxes. Then the buyer places the order using the Place order button. This sends a payment request to Amazon.
After submitting the order, the buyer sees X-Cart’s standard order confirmation page (“Congratulations! Your order has been placed. You will receive your order confirmation shortly”) displaying the order invoice with all the required information (The payment method is shown as “Amazon Pay”).
The way in which the order status is handled after order placement depends on the Amazon Pay addon settings:
- If the Synchronous type of authorization request is used, the order status almost instantly becomes one of the following:
- “Authorized” (= successful authorization, possible in “Authorization then capture” capture mode);
- “Processed” (= successful authorisation and capture, possible in “Immediate Charge” capture mode);
- “Declined” (= transaction declined).
- If the Asynchronous type of authorization request is used, the order initially gets the status ”Queued”, and, a few minutes later, when the store receives the payment request processing status from Amazon through the Instant Payment Notification (IPN) service, this order status is updated to either “Authorized”/”Processed” (dependes on the Capture mode) or “Declined”.
When the order is created, appropriate order notifications are sent to the email addresses of the buyer and the store’s orders department in accordance with your store’s Store setup -> Email notifications configuration (see more info about email configuration in Email notifications: setup and maintenance). When the payment’s status in Amazon Pay transitions as a part of the payment process (for example, when you capture a previously authorized amount or issue a refund), appropriate notifications are sent as well.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.