Draft:X-Cart:Simplify Commerce - Revision history

Dohtur: Redirected page to X-Cart:Simplify Commerce

2015-01-29T12:36:43Z

Redirected page to X-Cart:Simplify Commerce

Dohtur at 12:34, 29 January 2015

2015-01-29T12:34:50Z

Dohtur at 12:08, 29 January 2015

2015-01-29T12:08:57Z

Dohtur at 10:37, 29 January 2015

2015-01-29T10:37:05Z

Dohtur: /* Customer experience */

2015-01-29T10:36:08Z

‎Customer experience

Dohtur: /* Configuration */

2015-01-28T15:24:15Z

‎Configuration

Dohtur at 15:05, 28 January 2015

2015-01-28T15:05:07Z

Dohtur at 14:01, 28 January 2015

2015-01-28T14:01:26Z

Dohtur at 12:53, 28 January 2015

2015-01-28T12:53:47Z

Dohtur at 14:42, 27 January 2015

2015-01-27T14:42:39Z

← Older revision		Revision as of 12:36, 29 January 2015
Line 1:		Line 1:
		+	#REDIRECT [[X-Cart:Simplify Commerce]]
		+
	==Overview==		==Overview==

@@ Line 59: / Line 59: @@
 When you enable payments via ''Simplify Commerce by MasterCard - Hosted Payments'' for your customers, the respective payment method is added to the list of available payment options at checkout:
 ::[[File:sc_hosted_checkout.png|border]]<br /><br />
-By default, the name of this method is ''Simplify Commerce by MasterCard - Hosted Payments'', but it may be different if you have changed it in the payment method settings in your store's Admin back end.<br />
+By default, the name of this method is ''Simplify Commerce by MasterCard - Hosted Payments'', but it may be different if you have changed it in the payment method settings in your store's Admin back end.<br /><br />
-When a customer selects this method for payment, they may either be provided with a payment form in a modal dialog right on your website or redirected to a secure payment page on Simplify.com. Whether the customer is redirected to Simplify.com or stays on your site is determined by Simplify Commerce's JavaScript according to what's best for the customer security.
+When a customer selects this method for payment, they may either be provided with a payment form in a modal dialog right on your website or redirected to a secure payment page on Simplify.com. Whether the customer is redirected to Simplify.com or stays on your site is determined by Simplify Commerce's JavaScript according to what's best for the customer security.<br /><br />
-The screenshots below demonstrate the payment process with the customer being redirected to Simplify Commerce.
+The screenshots below demonstrate the payment process with the customer being redirected to Simplify Commerce.<br /><br />
-Here you can see the instructions provided to a customer who has selected the payment method corresponding to the ''Simplify Commerce by MasterCard - Hosted Payments'' integration and is going to be redirected away from the X-Cart store site to a use a secure payment form on Simplify.com:
+Here you can see the instructions provided to the customer when they have selected the payment method corresponding to the ''Simplify Commerce by MasterCard - Hosted Payments'' integration and are going to be redirected away from the X-Cart store site to use a secure payment form on Simplify.com:
 ::[[File:sc_hosted_method_selected.png|border]]<br /><br />
-After the customer submits the order, they are redirected to the Simplify Commerce's site where the secure payment form is hosted:
+After the customer submits the order, they are redirected to the Simplify Commerce's site to make the payment:
 ::[[File:sc_hosted_step1.png|border]]
 ::[[File:sc_hosted_step2.png|border]]
-::[[File:sc_hosted_step3.png|border]]
+::[[File:sc_hosted_step3.png|border]]<br /><br />
 ::[[File:sc_hosted_step4.png|border]]
-::[[File:sc_hosted_step5.png|border]]
+After completing the form fields with their payment card information, the customer needs to submit the form by clicking '''Pay''':
-::[[File:sc_hosted_step6.png|border]]
+::[[File:sc_hosted_step5.png|border]]<br /><br />
 ::[[File:sc_hosted_order_receipt.png|border]]

@@ Line 3: / Line 3: @@
 [https://www.simplify.com/commerce/ '''Simplify Commerce by MasterCard'''] is a payment solution that allows merchants to accept all major brands of debit and credit cards online. The Simplify Commerce module for X-Cart integrates this solution with your online store providing a way to simplify card payments for you and your customers. As a Level 1 PCI certified service provider, Simplify Commerce provides the highest level of protection for your business. <br />
 The Simplify Commerce module for X-Cart supports two types of integration:
-# ''Simplify Commerce by MasterCard - Simplify Form''  in which the payment form is embedded right into your store's checkout page;
+# ''Simplify Commerce by MasterCard - Payment Form''  in which the payment form is embedded right into your store's checkout page;
 # ''Simplify Commerce by MasterCard - Hosted Payments'' in which the payment form is hosted by Simplify Commerce.
@@ Line 20: / Line 20: @@
 # Configure the module:
 ## Click the '''Configure''' button that has appeared next to the Simplify Commerce entry in the list:<br />[[File:sc_module_configure.png|border]]<br /><br />The Simplify Commerce module configuration page opens:<br />[[File:sc_config_new.png|border]]<br /><br />
-## Depending on the type of Simplify Commerce integration you are going to use, adjust the module configuration settings on the "Simplify Form" or the "Hosted Payments" tab (or both).<br />The "Simplify Form" tab is for the ''Simplify Commerce by MasterCard - Simplify Form'' integration:<br />[[File:sc_simplify_form.png|border]]<br /><br />The "Hosted Payments" tab is for the ''Simplify Commerce by MasterCard - Hosted Payments'' integration:<br />[[File:sc_hosted_payments.png|border]]<br /><br />The set of fields on both the tabs is identical:
+## Depending on the type of Simplify Commerce integration you are going to use, adjust the module configuration settings on the "Simplify Form" or the "Hosted Payments" tab (or both).<br />The "Simplify Form" tab is for the ''Simplify Commerce by MasterCard - Payment Form'' integration:<br />[[File:sc_simplify_form.png|border]]<br /><br />The "Hosted Payments" tab is for the ''Simplify Commerce by MasterCard - Hosted Payments'' integration:<br />[[File:sc_hosted_payments.png|border]]<br /><br />The set of fields on both the tabs is identical:
-##* '''Public Key (Live)''' and '''Private Key (Live)''': Use these fields to enter an API key for Live mode from your Simplify Commerce account. '''Important''': For the ''Simplify Commerce by MasterCard - Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" feature enabled; for the ''Simplify Commerce by MasterCard - Simplify Form'' integration, this needs to be a key with the "Enable hosted payments?" feature disabled.
+##* '''Public Key (Live)''' and '''Private Key (Live)''': Use these fields to enter an API key for Live mode from your Simplify Commerce account. '''Important''': For the ''Simplify Commerce by MasterCard - Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" feature enabled; for the ''Simplify Commerce by MasterCard - Payment Form'' integration, this needs to be a key with the "Enable hosted payments?" feature disabled.
-##* '''Order prefix''': If you are using more than one online store with the same Simplify Commerce account, or you are using both the ''Simplify Form'' and the ''Hosted Payments'' integrations simultaneously and want to discriminate between them, you can set a prefix that will be added to orders (for example, "SF-" for orders paid using the ''Simple Form'' integration and "HP-" for orders paid using the ''Hosted Payments'' integration).
+##* '''Order prefix''': If you are using more than one online store with the same Simplify Commerce account, or you are using both the ''Payment Form'' and the ''Hosted Payments'' integrations simultaneously and want to discriminate between them, you can set a prefix that will be added to orders (for example, "SF-" for orders paid using the ''Simple Form'' integration and "HP-" for orders paid using the ''Hosted Payments'' integration).
-##* '''Public Key (Test)''' and '''Private Key (Test)''': Use these fields to enter an API key for Sandbox mode from your Simplify Commerce account. '''Important''': For the ''Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" feature enabled; for the ''Simplify Form'' integration, this needs to be a key with the "Enable hosted payments?" feature disabled.
+##* '''Public Key (Test)''' and '''Private Key (Test)''': Use these fields to enter an API key for Sandbox mode from your Simplify Commerce account. '''Important''': For the ''Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" feature enabled; for the ''Payment Form'' integration, this needs to be a key with the "Enable hosted payments?" feature disabled.
 ##* '''Live/Test mode''': Select ''Test'' to run test transactions in Sandbox mode or select ''Live'' to accept real payments. The respective type of API key needs to be entered in the fields above.<br /><br />
 # Activate the Simplify Commerce payment method(s) that you require.<br /><br />Once the Simplify Commerce module has been enabled in your store, you should be able to find two new payment methods in the Payment methods section ('''Settings''' -> '''Payment methods'''):<br />- Simplify Commerce by MasterCard (Background method);<br />- Simplify Commerce by MasterCard - Hosted Payments (Web based method)<br /><br />If you visit your store's Payment methods section during the same session in which the module has been enabled, at the top of the page you will see the quick links to these methods:<br />[[File:sc_methods_added_current_session.png|border]]<br /><br />Provided that you have completed Step 4 ("Configure the module") of this procedure, you have already configured the method(s) that you are going to use. However, if necessary, you can go back to Simplify Commerce module configuration settings by clicking on the <u>Configure</u> link for any of the two Simplify Commerce payment methods and adjust the settings as needed.<br /><br />To make Simplify Commerce methods available to buyers, you now need to enable them:
@@ Line 35: / Line 35: @@
 The store administrator knows that an order was paid for via Simplify Commerce by looking at the order details:
 ::[[File:sc_order.png|border]]<br /><br />
-Currently X-Cart's Simplify Commerce integration supports only ''Sale'' transactions in which money is taken from the buyer's account and moved to the store's account immediately on confirmation; ''Authorization and Capture'' transactions in which the money is authorized, but its capture is delayed until a later time are not supported. <br /><br />
+Currently X-Cart's Simplify Commerce integration supports only ''Payment'' transactions in which money is taken from the buyer's account and moved to the store's account immediately on confirmation; ''Authorization and Capture'' transactions in which the money is authorized, but its capture is delayed until a later time are not supported. <br /><br />
 Refund transactions via the X-Cart store's back end are also not supported; if a refund needs to be issued for a payment done via a Simplify Commerce payment method, the store administrator must issue it via the payment gateway.
 ==Customer experience==
-===Payments via Simplify Commerce by MasterCard - Simplify Form===
+===Payments via Simplify Commerce by MasterCard - Payment Form===
-When you enable payments via ''Simplify Commerce by MasterCard - Simplify Form'' for your customers, the respective payment method is added to the list of available payment options at checkout. By default, the name of this method is ''Simplify Commerce by MasterCard'', but it may be different if you have changed it in the payment method settings in your store's Admin back end:
+When you enable payments via ''Simplify Commerce by MasterCard - Payment Form'' for your customers, the respective payment method is added to the list of available payment options at checkout:
 ::[[File:sc_checkout.png|border]]<br /><br />
 When a customer selects this method for payment, a Secure credit card payment form is expanded:
 ::[[File:sc_form.png|border]]<br /><br />
@@ Line 56: / Line 57: @@
 ===Payments via Simplify Commerce by MasterCard - Hosted Payments===
-When you enable payments via ''Simplify Commerce by MasterCard - Hosted Payments'' for your customers, the respective payment method is added to the list of available payment options at checkout. By default, the name of this method is ''Simplify Commerce by MasterCard - Hosted Payments'', but it may be different if you have changed it in the payment method settings:
+When you enable payments via ''Simplify Commerce by MasterCard - Hosted Payments'' for your customers, the respective payment method is added to the list of available payment options at checkout:
-:[[File:sc_hosted_checkout.png|border]]
+::[[File:sc_hosted_checkout.png|border]]<br /><br />
-:[[File:sc_hosted_method_selected.png|border]]
+By default, the name of this method is ''Simplify Commerce by MasterCard - Hosted Payments'', but it may be different if you have changed it in the payment method settings in your store's Admin back end.<br />
-:[[File:sc_hosted_step1.png|border]]
+When a customer selects this method for payment, they may either be provided with a payment form in a modal dialog right on your website or redirected to a secure payment page on Simplify.com. Whether the customer is redirected to Simplify.com or stays on your site is determined by Simplify Commerce's JavaScript according to what's best for the customer security.
-:[[File:sc_hosted_step2.png|border]]
+The screenshots below demonstrate the payment process with the customer being redirected to Simplify Commerce.
-:[[File:sc_hosted_step3.png|border]]
+Here you can see the instructions provided to a customer who has selected the payment method corresponding to the ''Simplify Commerce by MasterCard - Hosted Payments'' integration and is going to be redirected away from the X-Cart store site to a use a secure payment form on Simplify.com:
-:[[File:sc_hosted_step4.png|border]]
+::[[File:sc_hosted_method_selected.png|border]]<br /><br />
-:[[File:sc_hosted_step5.png|border]]
+After the customer submits the order, they are redirected to the Simplify Commerce's site where the secure payment form is hosted:
-:[[File:sc_hosted_step6.png|border]]
+::[[File:sc_hosted_step1.png|border]]
-:[[File:sc_hosted_order_receipt.png|border]]
+::[[File:sc_hosted_step2.png|border]]

@@ Line 21: / Line 21: @@
 ## Click the '''Configure''' button that has appeared next to the Simplify Commerce entry in the list:<br />[[File:sc_module_configure.png|border]]<br /><br />The Simplify Commerce module configuration page opens:<br />[[File:sc_config_new.png|border]]<br /><br />
 ## Depending on the type of Simplify Commerce integration you are going to use, adjust the module configuration settings on the "Simplify Form" or the "Hosted Payments" tab (or both).<br />The "Simplify Form" tab is for the ''Simplify Commerce by MasterCard - Simplify Form'' integration:<br />[[File:sc_simplify_form.png|border]]<br /><br />The "Hosted Payments" tab is for the ''Simplify Commerce by MasterCard - Hosted Payments'' integration:<br />[[File:sc_hosted_payments.png|border]]<br /><br />The set of fields on both the tabs is identical:
-##* '''Public Key (Live)''' and '''Private Key (Live)''': Use these fields to enter an API key for Live mode from your Simplify Commerce account. '''Important''': For the ''Simplify Commerce by MasterCard - Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" property enabled; for the ''Simplify Commerce by MasterCard - Simplify Form'' integration, this needs to be a key with the "Enable hosted payments?" property disabled.
+##* '''Public Key (Live)''' and '''Private Key (Live)''': Use these fields to enter an API key for Live mode from your Simplify Commerce account. '''Important''': For the ''Simplify Commerce by MasterCard - Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" feature enabled; for the ''Simplify Commerce by MasterCard - Simplify Form'' integration, this needs to be a key with the "Enable hosted payments?" feature disabled.
 ##* '''Order prefix''': If you are using more than one online store with the same Simplify Commerce account, or you are using both the ''Simplify Form'' and the ''Hosted Payments'' integrations simultaneously and want to discriminate between them, you can set a prefix that will be added to orders (for example, "SF-" for orders paid using the ''Simple Form'' integration and "HP-" for orders paid using the ''Hosted Payments'' integration).
-##* '''Public Key (Test)''' and '''Private Key (Test)''': Use these fields to enter an API key for Sandbox mode from your Simplify Commerce account. '''Important''': For the ''Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" property enabled; for the ''Simplify Form'' integration, this needs to be a key with the "Enable hosted payments?" property disabled.
+##* '''Public Key (Test)''' and '''Private Key (Test)''': Use these fields to enter an API key for Sandbox mode from your Simplify Commerce account. '''Important''': For the ''Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" feature enabled; for the ''Simplify Form'' integration, this needs to be a key with the "Enable hosted payments?" feature disabled.
 ##* '''Live/Test mode''': Select ''Test'' to run test transactions in Sandbox mode or select ''Live'' to accept real payments. The respective type of API key needs to be entered in the fields above.<br /><br />
 # Activate the Simplify Commerce payment method(s) that you require.<br /><br />Once the Simplify Commerce module has been enabled in your store, you should be able to find two new payment methods in the Payment methods section ('''Settings''' -> '''Payment methods'''):<br />- Simplify Commerce by MasterCard (Background method);<br />- Simplify Commerce by MasterCard - Hosted Payments (Web based method)<br /><br />If you visit your store's Payment methods section during the same session in which the module has been enabled, at the top of the page you will see the quick links to these methods:<br />[[File:sc_methods_added_current_session.png|border]]<br /><br />Provided that you have completed Step 4 ("Configure the module") of this procedure, you have already configured the method(s) that you are going to use. However, if necessary, you can go back to Simplify Commerce module configuration settings by clicking on the <u>Configure</u> link for any of the two Simplify Commerce payment methods and adjust the settings as needed.<br /><br />To make Simplify Commerce methods available to buyers, you now need to enable them:

@@ Line 40: / Line 40: @@
 ==Customer experience==
-Simplify Commerce by MasterCard
+===Payments via Simplify Commerce by MasterCard - Simplify Form===
 :[[File:sc_checkout.png|border]]
-:[[File:sc_form.png|border]]
+When you enable payments via ''Simplify Commerce by MasterCard - Simplify Form'' for your customers, the respective payment method is added to the list of available payment options at checkout. By default, the name of this method is ''Simplify Commerce by MasterCard'', but it may be different if you have changed it in the payment method settings in your store's Admin back end:
-:[[File:sc_form1.png|border]]
+::[[File:sc_checkout.png|border]]<br /><br />
-:[[File:sc_order_being_placed.png|border]]
+When a customer selects this method for payment, a Secure credit card payment form is expanded:
 :[[File:sc_order_receipt.png|border]]
 <br />
-Simplify Commerce by MasterCard - Hosted Payments
+===Payments via Simplify Commerce by MasterCard - Hosted Payments===
 :[[File:sc_hosted_checkout.png|border]]
 :[[File:sc_hosted_method_selected.png|border]]

@@ Line 31: / Line 31: @@
 ## Click the '''Apply changes''' button for the changes to be applied.<br />:[[File:sc_method_activate.png|border]]<br /><br />The selected method(s) will be activated:<br />:[[File:simplify_method1.png|border]]<br /><br />
 That is all. Now you can accept payments via the Simplify Commerce method(s) you have enabled.<br /><br />
-For every order paid via Simplify Commerce the payment method that was used by the buyer will be shown in the order details:<br />[[File:sc_order.png|border]]<br /><br />
 ==Customer experience==

@@ Line 6: / Line 6: @@
 # ''Simplify Commerce by MasterCard - Hosted Payments'' in which the payment form is hosted by Simplify Commerce.
-==Getting started==
+==Configuration==
 To start using Simplify Commerce, do the following:
@@ Line 30: / Line 30: @@
 ## If you want to change the name under which your selected method should appear to customers, add an extra charge, provide comments/instructions for customers or make the method available only to certain membership levels, you can do so by adjusting the appropriate fields. If you have multiple payment methods enabled, make sure order number of your selected  Simplify Commerce payment method is adjusted properly.
 ## Click the '''Apply changes''' button for the changes to be applied.<br />:[[File:sc_method_activate.png|border]]<br /><br />The selected method(s) will be activated:<br />:[[File:simplify_method1.png|border]]<br /><br />
-That is all. Now you can accept payments via the Simplify Commerce method(s) you have enabled.
+That is all. Now you can accept payments via the Simplify Commerce method(s) you have enabled.<br /><br />
 ==Customer experience==

@@ Line 1: / Line 1: @@
 ==Overview==
 [https://www.simplify.com/commerce/ '''Simplify Commerce by MasterCard'''] is a payment solution that allows merchants to accept all major brands of debit and credit cards online. The Simplify Commerce module for X-Cart integrates this solution with your online store providing a way to simplify card payments for you and your customers. As a Level 1 PCI certified service provider, Simplify Commerce provides the highest level of protection for your business. <br />
 The Simplify Commerce module for X-Cart supports two types of integration:
@@ Line 13: / Line 14: @@
 ##* '''Key Label''': A name that will help you to identify the key.
 ##* '''Key Type''': Whether this key is for Live or Sandbox mode.
-##* '''Enable hosted payments?''': This option needs to be enabled for keys intended for ''Simplify Commerce by MasterCard - Hosted Payments''.<br />After you have located the API keys that you will need, just leave the page open so you will have the keys at the ready when it is time to copy them to your X-Cart store's back end.
+##* '''Enable hosted payments?''': This option needs to be enabled for keys intended for ''Simplify Commerce by MasterCard - Hosted Payments''.<br />After you have located the API keys that you will need, just leave the page open so you will have the keys at the ready when it is time to copy them to your X-Cart store's back end.<br /><br />
 # In a new browser tab or window, log in to your X-Cart store's Admin back end and enable the Simplify Commerce module:<br />
 ## In the list of your store's installed modules ('''Settings''' -> '''Modules'''), locate the entry for Simplify Commerce.[[File:sc_module_disabled.png|border]]<br /><br />
@@ Line 23: / Line 24: @@
 ##* '''Order prefix''': If you are using more than one online store with the same Simplify Commerce account, or you are using both the ''Simplify Form'' and the ''Hosted Payments'' integrations simultaneously and want to discriminate between them, you can set a prefix that will be added to orders (for example, "SF-" for orders paid using the ''Simple Form'' integration and "HP-" for orders paid using the ''Hosted Payments'' integration).
 ##* '''Public Key (Test)''' and '''Private Key (Test)''': Use these fields to enter an API key for Sandbox mode from your Simplify Commerce account. '''Important''': For the ''Hosted Payments'' integration, this needs to be a key with the "Enable hosted payments?" property enabled; for the ''Simplify Form'' integration, this needs to be a key with the "Enable hosted payments?" property disabled.
-##* '''Live/Test mode''': Select ''Test'' to run test transactions in Sandbox mode or select ''Live'' to accept real payments. The respective type of API key needs to be entered in the fields above.
+##* '''Live/Test mode''': Select ''Test'' to run test transactions in Sandbox mode or select ''Live'' to accept real payments. The respective type of API key needs to be entered in the fields above.<br /><br />
-# Activate the Simplify Commerce payment method(s) that you require.<br />Once the Simplify Commerce module has been enabled in your store, two new payment methods will be added in the Payment methods section:<br />:[[File:sc_methods_added_current_session.png|border]]
+# Activate the Simplify Commerce payment method(s) that you require.<br /><br />Once the Simplify Commerce module has been enabled in your store, you should be able to find two new payment methods in the Payment methods section ('''Settings''' -> '''Payment methods'''):<br />- Simplify Commerce by MasterCard (Background method);<br />- Simplify Commerce by MasterCard - Hosted Payments (Web based method)<br /><br />If you visit your store's Payment methods section during the same session in which the module has been enabled, at the top of the page you will see the quick links to these methods:<br />[[File:sc_methods_added_current_session.png|border]]<br /><br />Provided that you have completed Step 4 ("Configure the module") of this procedure, you have already configured the method(s) that you are going to use. However, if necessary, you can go back to Simplify Commerce module configuration settings by clicking on the <u>Configure</u> link for any of the two Simplify Commerce payment methods and adjust the settings as needed.<br /><br />To make Simplify Commerce methods available to buyers, you now need to enable them:
-:[[File:sc_payment_methods_disabled.png|border]]
+## Scroll down the page to the bottom of the payment method list to locate the Simplify Commerce payment methods that have been added:<br />[[File:sc_payment_methods_disabled.png|border]]
-:[[File:sc_method_activate.png|border]]
+## Select the check box next to the name of the method you want to enable (Select the check boxes for both the methods if you want to enable both).
-:[[File:simplify_method1.png|border]]
+## If you want to change the name under which your selected method should appear to customers, add an extra charge, provide comments/instructions for customers or make the method available only to certain membership levels, you can do so by adjusting the appropriate fields. If you have multiple payment methods enabled, make sure order number of your selected  Simplify Commerce payment method is adjusted properly.
-<br />
+## Click the '''Apply changes''' button for the changes to be applied.<br />:[[File:sc_method_activate.png|border]]<br /><br />The selected method(s) will be activated:<br />:[[File:simplify_method1.png|border]]<br /><br />
 Simplify Commerce by MasterCard