Draft:X-Cart:Pay with Amazon - Revision history

Dohtur: Redirected page to X-Cart:Pay with Amazon

2014-02-28T12:47:04Z

Redirected page to X-Cart:Pay with Amazon

Dohtur: /* Getting started */

2014-02-28T12:41:35Z

‎Getting started

Dohtur: /* Activating and deactivating the module */

2014-01-28T11:31:06Z

‎Activating and deactivating the module

Dohtur: /* Activating and deactivating the module */

2014-01-28T11:30:09Z

‎Activating and deactivating the module

Dohtur at 11:28, 28 January 2014

2014-01-28T11:28:13Z

Dohtur: /* Getting started */

2014-01-28T11:27:02Z

‎Getting started

Dohtur: /* Overview */

2014-01-28T10:27:24Z

‎Overview

Dohtur: /* Admin experience */

2014-01-28T08:30:13Z

‎Admin experience

Dohtur: /* Admin experience */

2014-01-28T07:39:17Z

‎Admin experience

Dohtur at 06:32, 28 January 2014

2014-01-28T06:32:48Z

← Older revision		Revision as of 12:47, 28 February 2014
Line 1:		Line 1:
		+	#REDIRECT [[X-Cart:Pay_with_Amazon]]
		+
	==Overview==		==Overview==
	X-Cart's Pay with Amazon module provides an integration with Amazon Payments Advanced, a payment service that enables buyers to pay at your online store using the payment and shipping information already stored in their existing Amazon accounts. All the interaction of buyers with Amazon Payments Advanced takes place in embedded widgets, so that the buyers can complete the checkout process without ever leaving your website.		X-Cart's Pay with Amazon module provides an integration with Amazon Payments Advanced, a payment service that enables buyers to pay at your online store using the payment and shipping information already stored in their existing Amazon accounts. All the interaction of buyers with Amazon Payments Advanced takes place in embedded widgets, so that the buyers can complete the checkout process without ever leaving your website.

@@ Line 8: / Line 8: @@
 ==Getting started==
-# Register for Amazon Payments Advanced service.<br />Amazon Payments Advanced is an Amazon service that is separate from Checkout by Amazon (CBA) solution. That means you’ll need to go through a registration process, even if you have an existing CBA account.<br />You can register for Amazon Payments Advanced using this link: [https://sellercentral.amazon.com/gp/on-board/workflow/Registration/login.html?passthrough%2Fsource=internal-landing-select&passthrough%2F*entries*=0&passthrough%2FmarketplaceID=AGWSWK15IEJJ7&passthrough%2FsuperSource=OAR&passthrough/ld=APRPUltraCart&passthrough%2F*Version*=1&passthrough%2Faccount=pyop&passthrough%2FwaiveFee=1&passthrough%2FsimplifiedLogin=1| Get started now >]<br /><br />
+# Register for Amazon Payments Advanced service.<br />Amazon Payments Advanced is an Amazon service that is separate from [[X-Cart:Amazon_Payments|Checkout by Amazon]] (CBA) solution. That means you’ll need to go through a registration process, even if you have an existing CBA account.<br />You can register for Amazon Payments Advanced using this link: [https://sellercentral.amazon.com/gp/on-board/workflow/Registration/login.html?passthrough%2Fsource=internal-landing-select&passthrough%2F*entries*=0&passthrough%2FmarketplaceID=AGWSWK15IEJJ7&passthrough%2FsuperSource=OAR&passthrough/ld=APRPUltraCart&passthrough%2F*Version*=1&passthrough%2Faccount=pyop&passthrough%2FwaiveFee=1&passthrough%2FsimplifiedLogin=1| Get started now >]<br /><br />
 # 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.<br />[[File:Amazon_services.png|border|700px]]<br /><br />
 # Create a test account to use in Sandbox mode.<br />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.<br />[[File:Amazon_test_accounts.png|border|700px]]<br /><br />
@@ Line 33: / Line 33: @@
 # Once you’re ready to go live with your Pay with Amazon module, configure the module to production mode by setting its Operation mode to "Live" and you should be ready to go.
 # Order Management<br />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 the orders via Amazon's Seller Central website as with Checkout by Amazon.
 ==Activating and deactivating the module==

@@ Line 44: / Line 44: @@
 # Click '''Apply changes'''. The module will be enabled.
-It is possible to temporarily disable (deactivate) the installed Pay with Amazon module. Deactivation stops the module from operation, but it does not remove any settings you made to the module configuration nor clear any data that was generated during the period that the module was in operation. If you wish to completely remove all the data related to using the module, you need to uninstall it. See [[#Uninstallation|Pay with Amazon: Uninstallation]] for more info.
+It is possible to temporarily disable (deactivate) the installed Pay with Amazon module. Deactivation stops the module from operation, but it does not remove any settings you made to the module configuration nor clear any data that was generated during the period that the module was in operation. If you wish to completely remove all the data related to using the module, you need to uninstall it. See [[Draft:X-Cart:Pay_with_Amazon_module_installation#Uninstallation|Pay with Amazon: Uninstallation]] for more info.
 '''To disable the module''':

@@ Line 44: / Line 44: @@
 # Click '''Apply changes'''. The module will be enabled.
-It is possible to temporarily disable (deactivate) the installed Pay with Amazon module. Deactivation stops the module from operation, but it does not remove any settings you made to the module configuration nor clear any data that was generated during the period that the module was in operation. If you wish to completely remove all the data related to using the module, you need to uninstall it. See [[#Uninstallation|Uninstallation]] for more info.
+It is possible to temporarily disable (deactivate) the installed Pay with Amazon module. Deactivation stops the module from operation, but it does not remove any settings you made to the module configuration nor clear any data that was generated during the period that the module was in operation. If you wish to completely remove all the data related to using the module, you need to uninstall it. See [[#Uninstallation|Pay with Amazon: Uninstallation]] for more info.
 '''To disable the module''':

@@ Line 25: / Line 25: @@
 #:* Go back to Seller Central (http://sellercentral.amazon.com) to the "MWS Access Key" page to see the keys you'll need to enter in X-Cart.
 # 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 Pay with Amazon module configuration 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:
-#* [[#Configuring the Pay with Amazon module|Pay with Amazon: Configuring the module]].
+#* [[#Configuring the module|Pay with Amazon: Configuring the module]].
 # In Seller Central, configure your instant notification settings (IPN):<br />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 <u>httрs://<YOUR_XCART_STORE>/payment/amazon_pa_ipn_recv.php</u> (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).<br />{{Note1|'''Note''': Recent web servers use a protocol called Server Name Indication (SNI) to support hosting of multiple sites on a single domain.  Unfortunately, Amazon Payments does not support the use of SNI for IPN destinations, so you may need to configure a default certificate to be used on your web server and use this certificate’s registered domain name in your configured IPN URL.  For example, if your site is configured with two secure virtual hosts, httрs://www.site.com and httрs://store.site.com, you should configure one of these certificates as the default to be returned if SNI is not supported.  The IPN URL must then be configured to match your default certificate.<br />Please refer to your web server’s documentation for how to configure default certificates.  On Apache web servers, this is commonly configured in a file included in your installation under /etc/httpd/conf.d/ called ssl.conf.}}<br />
 # If you wish to use your own graphics (company logo) in the pop-up window where buyers will sign in to Amazon Payments, 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.
 # If you disabled the Pay with Amazon module in X-Cart after installation, enable (activate) it:<br />
-#* [[#Activating and deactivating the Pay with Amazon module|Pay with Amazon: Activating and deactivating the module]]
+#* [[#Activating and deactivating the module|Pay with Amazon: Activating and deactivating the module]]
 # 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 Pay with Amazon module, configure the module to production mode by setting its Operation mode to "Live" and you should be ready to go.

@@ Line 1: / Line 1: @@
 ==Overview==
-Pay with Amazon
+X-Cart's Pay with Amazon module provides an integration with Amazon Payments Advanced, a payment service that enables buyers to pay at your online store using the payment and shipping information already stored in their existing Amazon accounts. All the interaction of buyers with Amazon Payments Advanced takes place in embedded widgets, so that the buyers can complete the checkout process without ever leaving your website.
 ==System requirements and installation==

← Older revision		Revision as of 08:30, 28 January 2014
Line 105:		Line 105:
	:* '''Refund''': This button allows you to refund the payment if you already captured funds. It is displayed when the order is "Processed" or "Completed".<br />[[File:PwA_order_details1.png\|border]]<br /><br />		:* '''Refund''': This button allows you to refund the payment if you already captured funds. It is displayed when the order is "Processed" or "Completed".<br />[[File:PwA_order_details1.png\|border]]<br /><br />
	:* '''Refresh status''': This button is displayed if Instant Payment Notification with the results of processing the payment on the side of Amazon Payments was not received by the store. This may be the case if IPN was not configured or was not working for some reason at the time of the transaction. The '''Refresh status''' button provides a workaround solution allowing you obtain information on the current status of the payment in Amazon Payments and to synchronize the status of the order in X-Cart with it. When you click this button, your store sends a request to Amazon Payments; after a response from Amazon is received, the status of the order in X-Cart is updated appropriately, and the respective buttons for available order actions ("Capture" and "Void", or "Refund") get displayed in the "Pay with Amazon available order actions" section.<br />[[File:PwA_order_details2.png\|border]]<br /><br />		:* '''Refresh status''': This button is displayed if Instant Payment Notification with the results of processing the payment on the side of Amazon Payments was not received by the store. This may be the case if IPN was not configured or was not working for some reason at the time of the transaction. The '''Refresh status''' button provides a workaround solution allowing you obtain information on the current status of the payment in Amazon Payments and to synchronize the status of the order in X-Cart with it. When you click this button, your store sends a request to Amazon Payments; after a response from Amazon is received, the status of the order in X-Cart is updated appropriately, and the respective buttons for available order actions ("Capture" and "Void", or "Refund") get displayed in the "Pay with Amazon available order actions" section.<br />[[File:PwA_order_details2.png\|border]]<br /><br />
		+
		+	At the moment, X-Cart's Pay with Amazon integration supports Authorize, Capture, Void and Refund operations only for the sum equalling the original order amount. Changes to the original authorization amount, partial captures and partial refunds are not supported. In situations calling for transactions with amounts that are more or less than the original order amount, we recommended cancelling the original order and working with the customer to place the order again. For example, if, after receiving an order, you find out that some of the items in the order have gone out of stock and cannot be fulfilled, you should Void or Refund the transaction and ask the customer to re-submit the order.

@@ Line 101: / Line 101: @@
 ==Admin experience==
-Orders that were placed by customers using Pay with Amazon can be identified by the name of the payment method specified in the order details  ("Pay with Amazon"). The order details page for such orders includes a section titled "Pay with Amazon available order actions". Depending on the order status, this section may include the following buttons:
+In your store's Admin area, orders that were placed by customers using Pay with Amazon can be identified by the name of the payment method specified in the order details  ("Pay with Amazon"). The order details page for such orders includes a section titled "Pay with Amazon available order actions". Depending on the order status, this section may include the following buttons:
-:* '''Capture''' and '''Void'''. These buttons are displayed when "Authorization then capture" mode is used, and the order is in the "Pre-Authorized" status. The '''Capture''' button allows you to collect payment from the buyer after the respective payment amount has been authorized. The '''Void''' button alows you to void the authorization.<br />[[File:PwA_order_details.png|border]]<br /><br />
+:* '''Capture''' and '''Void''': These buttons are displayed when "Authorization then capture" mode is used, and the order is in the "Pre-Authorized" status. The '''Capture''' button allows you to collect payment from the buyer after the respective payment amount has been authorized. The '''Void''' button allows you to void the authorization.<br />[[File:PwA_order_details.png|border]]<br /><br />
 :* '''Refund''': This button allows you to refund the payment if you already captured funds. It is displayed when the order is "Processed" or "Completed".<br />[[File:PwA_order_details1.png|border]]<br /><br />
-:* '''Refresh status''': This button allows you to check the status of the payment in Amazon Payments manually, providing a workaround solution for situations when IPN has not been configured or is not working for some reason.<br />[[File:PwA_order_details2.png|border]]<br /><br />
+:* '''Refresh status''': This button is displayed if Instant Payment Notification with the results of processing the payment on the side of Amazon Payments was not received by the store. This may be the case if IPN was not configured or was not working for some reason at the time of the transaction. The '''Refresh status''' button provides a workaround solution allowing you obtain information on the current status of the payment in Amazon Payments and to synchronize the status of the order in X-Cart with it. When you click this button, your store sends a request to Amazon Payments; after a response from Amazon is received, the status of the order in X-Cart is updated appropriately, and the respective buttons for available order actions ("Capture" and "Void", or "Refund") get displayed in the "Pay with Amazon available order actions" section.<br />[[File:PwA_order_details2.png|border]]<br /><br />