Difference between revisions of "X-Payments:Connecting Zen Cart & osCommerce"

From X-Payments Help
Jump to: navigation, search
(Installation)
m (Configuring the Connection to X-Payments)
 
(2 intermediate revisions by the same user not shown)
Line 21: Line 21:
 
==Installation==
 
==Installation==
  
Download X-Payments connector:
+
Download the X-Payments connector:
 
* for ZenCart at https://drive.google.com/a/x-cart.com/file/d/0B6p7sehSZL8_aUhfOGhmZVRZUFk/view
 
* for ZenCart at https://drive.google.com/a/x-cart.com/file/d/0B6p7sehSZL8_aUhfOGhmZVRZUFk/view
 
* for osCommerce at http://addons.oscommerce.com/info/9415
 
* for osCommerce at http://addons.oscommerce.com/info/9415
  
Unzip downloaded archive and follow readme instructions.
+
Unzip the downloaded archive and follow the readme instructions.
  
==Configuring X-Payments Connector==
+
==Configuring the Connection to X-Payments==
  
Before you can start using ZenCart/osCommerce together with X-Payments, you must configure X-Payments Connector.To configure X-Payments Connector:
+
The following procedure assumes that:
 +
 
 +
:* You have an X-Payments account created using https://www.x-payments.com/trial-demo.html
 +
:* You have completed configuring the connection to your ZenCart/osCommerce store on the X-Payments end.
 +
 
 +
After configuring the connection in X-Payments, log in to your ZenCart/osCommerce store Admin area and complete the connection.  
 +
 
 +
Follow the steps below:
  
 
1. Log in to the ZenCart/osCommerce Admin area.
 
1. Log in to the ZenCart/osCommerce Admin area.
Line 39: Line 46:
 
: [[Image:zen_os_settings.gif|border]]
 
: [[Image:zen_os_settings.gif|border]]
  
3. Define connection details.
+
3. Configure the connection details.
  
 
:* '''X-Payments configuration bundle''': A string, containing all the required settings details, which is generated in X-Payments back-office.
 
:* '''X-Payments configuration bundle''': A string, containing all the required settings details, which is generated in X-Payments back-office.
Line 47: Line 54:
 
Click the '''Update''' button.
 
Click the '''Update''' button.
  
4. Select available payment method
+
4. Select an available payment method.
  
After all settings are configured click '''Edit''' button and select one of available X-Payments methods.
+
After all the settings have been configured, click the '''Edit''' button and select one of the available X-Payments methods.
  
 
: [[Image:Zencart_select_method.gif|303px|border]]
 
: [[Image:Zencart_select_method.gif|303px|border]]

Latest revision as of 17:21, 15 March 2019

Overview

This page contains guidelines on how to process payments in ZenCart/osCommerce-based store using X-Payments.

ZenCart can be connected to X-Payments by using X-Payments Connector. This ensures correct implementation of the following tasks:

  • Importing the data on active payment methods from X-Payments to ZenCart/osCommerce;
  • Transferring cart and customer details from ZenCart/osCommerce into X-Payments;
  • Redirecting the customer from ZenCart/osCommerce to X-Payments and back to ZenCart/osCommerce;
  • Synchronizing transaction and order details between X-Payments and ZenCart/osCommerce.

System requirements

Zen Cart™ Version: >= v1.3.8 osCommerce Version: >= v2.2

Video tutorial

Installation

Download the X-Payments connector:

Unzip the downloaded archive and follow the readme instructions.

Configuring the Connection to X-Payments

The following procedure assumes that:

After configuring the connection in X-Payments, log in to your ZenCart/osCommerce store Admin area and complete the connection.

Follow the steps below:

1. Log in to the ZenCart/osCommerce Admin area.

2. Go to the X-Payments connector settings page (Modules -> Payment -> X-Payments connector).

This will open the X-Payments Connector configuration page.

Zen os settings.gif

3. Configure the connection details.

  • X-Payments configuration bundle: A string, containing all the required settings details, which is generated in X-Payments back-office.
  • IP addresses for X-Payments callbacks: enter IP address of the server where X-Payments is installed. "127.0.0.1" can not be used here. For better understanding what IP address to put here see Callback from X-Payments to the store.
  • Payment currency: Currency

Click the Update button.

4. Select an available payment method.

After all the settings have been configured, click the Edit button and select one of the available X-Payments methods.

Zencart select method.gif

5. Click the Update button.