Difference between revisions of "X-Cart:ESELECTplus"

From X-Cart 4 Classic
Jump to: navigation, search
(Obtaining a Moneris/eSELECTplus Account)
(Setting up eSELECTplus Secure Payment Page)
Line 18: Line 18:
  
 
==Setting up eSELECTplus Secure Payment Page==
 
==Setting up eSELECTplus Secure Payment Page==
 +
 +
To use eSELECTplus Secure Payment Page as one of the payment options in the store:
 +
 +
# Log in to the X-Cart Admin area.
 +
# Go to the <u>Payment methods</u> section (Administration menu -> Payment methods) and scroll down to the <u>Payment gateways</u> form.
 +
# Select eSelect Plus (hosted pages) from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_eselectplus_spp_01.gif|640px]]<br><br>After you have clicked on Add, eSELECTplus Secure Payment Page will be added to the list of the available payment methods.<br><br>[[Image:pg_eselectplus_spp_02.gif|640px]]
 +
# Click on the Configure link. This opens the configuration page for eSELECTplus Secure Payment Page.<br><br>[[Image:pg_eselectplus_spp_03.gif|640px]]
 +
# Adjust the configuration settings for eSELECTplus Secure Payment Page and click the Update button to apply the changes.
 +
#* <u>Approved/Declined/Cancel URL: </u>The URL from which Moneris will receive data from X-Cart.{{Note1|Important: Moneris uses the URL to check whether the payment request is sent by your store, not a fake website. Make sure that all URLs in the Moneris back-office coincide with the URL in the X-Cart admin area.}}
 +
#* <u>Store ID</u>: Enter the name of your merchant account with Moneris (the one you use to log in to back-office for eSELECTplus).
 +
#* <u>Secret key: </u>Enter the secret key from the Moneris back-office.<br><br>The key is used to encrypt order and customer data. Make sure the secret key you enter here coincides with the one in the Moneris back-office.
 +
#* <u>Test/Live mode</u>: Choose the mode in which the gateways must operate.<br><br>The "test" mode means that you can submit test orders and perform test transaction. Money will not be withdrawn from credit cards. The "live" mode is the full functioning mode with real transactions and charges. It must be used when only you are ready to go live.
 +
#* <u>Order prefix</u>: Enter a prefix that will be automatically added to IDs of orders placed in your store and paid through eSELECTplus Secure Payment Page.<br><br>Having a prefix ensures that orders will have unique IDs and will never coincide with orders placed in another online store of yours that also uses eSELECTplus as a payment option.
 +
# Return to the list of payment methods and activate eSELECTplus Secure Payment Page by selecting the check box next to the gateway's name.
 +
# Click the '''Update''' button.
 +
 +
After you have configured and activated the gateway, your customers will be able to choose eSELECTplus Secure Payment Page as a payment option.
 +
 +
: [[Image:pg_eselectplus_spp_04.gif|640px]]
  
 
==Setting up eSELECTplus API==
 
==Setting up eSELECTplus API==
  
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Revision as of 19:28, 31 January 2010

Overview

eSELECTplus is an online transaction processing engine by a Canadian payment processor Moneris Solutions Corp. eSELECTplus is one of the largest payment gateways in North America, which enables you to accept payments by major credit cards in both Canadian and U.S. dollars. X-Cart is currently integrated with two payment methods offered by eSELECTplus: eSELECTplus Application Program Interface (API) and eSELECTplus Secure Payment Page. The major difference between the two methods is where you host the payment pages for you store.

eSELECTplus Secure Payment Page

With eSELECTplus Secure Payment Page the payment pages are hosted on the side of Moneris, and Moneris provides all the necessary resources to process a transaction, including collection of payment information. Customers get redirected to a secure payment page and enter their card details there. There is no need to purchase an SSL certificate as all cardholder information is captured and protected by Moneris.

eSELECTplus Application Program Interface (API)

With eSELECTplus API the payment pages are hosted with the rest part of the store. The data is transmitted to Moneris in the background mode and customers never leave your website during the purchase. Since eSELECTplus API involves collection and transmission of sensitive cardholder data, you must ensure the security of this data by setting up secure connection with eSELECTplus. Otherwise, Moneris will reject the transaction.

Secure connection is implemented through an SSL certificate installed on your server/hosting account. For recommended SSL certificate providers please check the X-Cart marketplace at http://marketplace.x-cart.com/ . Another requirement of eSELECTplus API is that your server must provide support for any of the following HTTPS modules: Net::SSLeay, CURL, libCURL, OpenSSL or HTTPS-cli.

Obtaining a Moneris/eSELECTplus Account

If you have not yet registered an account with Moneris, you should do it before you start setting up eSELECTplus in X-Cart. To open an account, go to the Moneris website at https://www3.moneris.com/connect/en/signup/index.php and follow the instructions on the screen. After you have registered an account, you can set up eSELECTplus Application Program Interface (API) and eSELECTplus Secure Payment Page in the X-Cart Admin area.

Setting up eSELECTplus Secure Payment Page

To use eSELECTplus Secure Payment Page as one of the payment options in the store:

  1. Log in to the X-Cart Admin area.
  2. Go to the Payment methods section (Administration menu -> Payment methods) and scroll down to the Payment gateways form.
  3. Select eSelect Plus (hosted pages) from the drop-down list and click the Add button.

    Pg eselectplus spp 01.gif

    After you have clicked on Add, eSELECTplus Secure Payment Page will be added to the list of the available payment methods.

    Pg eselectplus spp 02.gif
  4. Click on the Configure link. This opens the configuration page for eSELECTplus Secure Payment Page.

    Pg eselectplus spp 03.gif
  5. Adjust the configuration settings for eSELECTplus Secure Payment Page and click the Update button to apply the changes.
    • Approved/Declined/Cancel URL: The URL from which Moneris will receive data from X-Cart.
      Important: Moneris uses the URL to check whether the payment request is sent by your store, not a fake website. Make sure that all URLs in the Moneris back-office coincide with the URL in the X-Cart admin area.
    • Store ID: Enter the name of your merchant account with Moneris (the one you use to log in to back-office for eSELECTplus).
    • Secret key: Enter the secret key from the Moneris back-office.

      The key is used to encrypt order and customer data. Make sure the secret key you enter here coincides with the one in the Moneris back-office.
    • Test/Live mode: Choose the mode in which the gateways must operate.

      The "test" mode means that you can submit test orders and perform test transaction. Money will not be withdrawn from credit cards. The "live" mode is the full functioning mode with real transactions and charges. It must be used when only you are ready to go live.
    • Order prefix: Enter a prefix that will be automatically added to IDs of orders placed in your store and paid through eSELECTplus Secure Payment Page.

      Having a prefix ensures that orders will have unique IDs and will never coincide with orders placed in another online store of yours that also uses eSELECTplus as a payment option.
  6. Return to the list of payment methods and activate eSELECTplus Secure Payment Page by selecting the check box next to the gateway's name.
  7. Click the Update button.

After you have configured and activated the gateway, your customers will be able to choose eSELECTplus Secure Payment Page as a payment option.

Pg eselectplus spp 04.gif

Setting up eSELECTplus API