Draft:X-Cart:Simplify Commerce

Overview

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.
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 - Hosted Payments in which the payment form is hosted by Simplify Commerce.

Getting started

To start using Simplify Commerce, do the following:

Sign up for an account on the Simplify Commerce by MasterCard website:

Once you have submitted the sign up form with your details, an email message will be sent to your registration email address with a link allowing you to confirm your email address.
You can continue to use the site with Simplify Commerce in Sandbox mode. However, to be able to accept real payments, you will need to activate your Simplify Commerce business account, which requires your email address to be confirmed. Once you have confirmed your email address, you will be able to activate your account by clicking the 'Accept Real Payments' button and following the instructions provided:
Get your API keys (These will need to be entered in X-Cart):
1. In your Simplify Commerce account, go to Settings -> API Keys:
  
  On the page that opens you will find two keys - one for Sandbox mode and one for Live mode. If you have not yet registered for Live mode, then there will only be a Sandbox key.
  If necessary, you can create up to five unique Live and Sandbox keys.
  
  For each key you will be able to specify the following information:
  - 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.
    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.
In a new browser tab or window, log in to your X-Cart store's Admin back end and enable the Simplify Commerce module:
1. In the list of your store's installed modules (Settings -> Modules), locate the entry for Simplify Commerce.
2. Select the check box on the left of the module name.
  
  The module will be enabled:
Configure the module:
1. Click the Configure button that has appeared next to the Simplify Commerce entry in the list:
  
  The Simplify Commerce module configuration page opens:
2. 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).
  The "Simplify Form" tab is for the Simplify Commerce by MasterCard - Simplify Form integration:
  
  The "Hosted Payments" tab is for the Simplify Commerce by MasterCard - Hosted Payments integration:
  
  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.
  - 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.
Activate the Simplify Commerce payment method(s) that you require.
Once the Simplify Commerce module has been enabled in your store, two new payment methods will be added in the Payment methods section:
: