Difference between revisions of "Quick Start Integration Guide"

From Payment Processing Software Library
Jump to: navigation, search
(Running The Sample)
Line 48: Line 48:
 
#Double chick CSDriver.exe to run the Sample.
 
#Double chick CSDriver.exe to run the Sample.
 
<br>
 
<br>
[[File:Sample.jpg|frame|Running Sample Screen]]
+
[[File:Sample.jpg|none|600px|Running Sample Screen]]
  
 
=Programming the Samples=
 
=Programming the Samples=

Revision as of 01:04, 27 August 2016

This article is part of the
Payment Processing Software Library

Categories

Get it...

Credit Card Software
Download

Install it...

Installation
Upgrade & Migration

Connect to it...

Point Of Sale Integration

Set it up...

Quick Start Guide
Setup
Processor Setup

Licensing

Learn to use it...

Manual & User Guide
Knowledge Base
Frequently Asked Questions
Compliance Guide
Merchant Account Rates
User Interface Guides

Fix it...

Errors & Troubleshooting
Knowledge Base
Corrupted Install Repair

Get Help...

Contact
Processor Support Contacts

More Info ...

Glossary
Articles

See also...

911 Software
Help

CreditLine Payment Processing Software Quick Start Sample Integration Guide. This site can also be reached at http://docs.911software.com

Looking for better rates?   Get a Free Credit Card Processing Cost Comparison!

>>>> SORRY, THIS SECTION IS UNDER CONSTRUCTION!!! <<<<<


Installation steps

Both Client and Server On the Same Machine

  1. Download the latest version of CreditLine (Client & Server) from http://911software.com -> Downloads page.
  2. Run the downloaded setup and follow the instructions to complete the installation of the software. Accept default installation directory for simplicity of example.

Client and Server are on Different Machines

Basic Client-Server Installation Topology

File:BasicTopology.jpg
Simple Client-Server Installation. Note, that both components will happily reside on the same machine, as well

Server Side Install

  1. Log in Machine A(CreditLine Server) in the topology above.
  2. Download the latest version of CreditLine "Standard CreditLine Manager and Server Download" from http://911software.com -> Downloads page.
  3. Run the downloaded setup and follow the instructions to complete the installation of the software. Accept default installation directory for simplicity of example.
  4. In file ”C:\911\Server\FileMonitor.Server.Service.exe.config” change “ServicePort” to any value that will work on your network. Leave the other settings as the default values.
  5. Run “C:\911\Server\InstallServerService.bat” as administrator to start the service on server side. If necessary, run “C:\911\Server\UnInstallServerService.bat” as administrator to stop the service on server side.


→Note: If you change any settings in the file “FileMonitor.Server.Service.exe.config”, you will need to restart the service.

Client Side Install

  1. Log in Machine B(CreditLine Client) in the topology above.
  2. Download the latest version of CreditLine "Client Only Regular Install" from http://911software.com -> Downloads page.
  3. Run the downloaded setup and follow the instructions to complete the installation of the software. Accept default installation directory for simplicity of example.
  4. In file ” C:\911\Client\FileMonitor.Client.Service.exe.config”:
    a)Change “FileMonitorServerIPAddress” to the Server Machine A’s IP address and the port you set on the server the in following format “127.0.0.1:xxx”, where xxx is the port number.
    b)Make sure that "FileMonitorDirectory" is set to the same local message folder on the local drive as set by the API clcSetMessageDir. For instance, <add key="FileMonitorDirectory" value="..\MESSAGES"/> would correspond to "C:\911\Messages".
    c)Leave the other settings as the default values.
  5. Run “C:\911\Client\InstallClientService.bat” as administrator to start the service on the client side. If necessary run “C:\911\Client\UnInstallClientService.bat" as administrator to stop the service on Terminal side.


→Note: If you change any settings in the file “FileMonitor.Client.Service.exe.config”, you will need to restart the service.

Guide to Samples

Prerequisites

Microsoft .NET Framework 2.0 or higher

Sample Configuration

  1. Complete the installation steps above.
  2. If testing in a multi machine environment, log into Machine B(CreditLine Client)
  3. Download the sample(CS:C Sharp, VB.Net) from Samples Repository


  1. Copy “clcCom.dll”, “CSDriver.exe” files to CreditLine Client installation path(C:\911\api).
    →Note: Please do NOT overwrite the existing files(ClcCom is the new com library, it can be used in C#, VB.Net).
  2. Copy folder “C:\911\BIN” and “C:\911\Data” from server Machine A to client Machine B’s installation path(C:\911).

Running The Sample

  1. Double chick CSDriver.exe to run the Sample.


Programming the Samples

  1. Log in Machine B(CreditLine Client) in the1.1 Topology of CreditLine Environment.
  2. Click #here to download the sample(CS:C Sharp, VB.Net) as you need, then Unzip the downloaded file.
  3. Please copy “clcCom.dll”, “CSDriver.exe” files to CreditLine Client installation path(C:\911\api).

Note1: Please do NOT overwrite the existing files(ClcCom is the new com library, it can be used in C#, VB.Net). Note2: Directory "CSDriver" is the C# sample source code.

  1. Please copy folder “C:\911\BIN” and “C:\911\Data” from server Machine A to client Machine B’s installation path(C:\911).
  2. Add the reference to the ClcCom library.

In "vs.net 2005 IDE", from menu Project->Add Reference. In the popup window, select Browse and then browse to the directory to select the ClcCom.dll.

  1. After that, you can follow the sample to program.

Note: If you have more than one Client, please call the api "void setClientName(string ClientName)" to set a different name for each Client before processing any transactions. 4. Troubleshooting

  1. When running the sample application, if you encounter the error “side-by-side…”. Please try to install “vcredist_x86.exe” on your environment.
  2. For Win7 User, no matter the OS is Win7-32bit or Win7-64bit, we suggest you to enable ‘Is64BitPlatform=YES’ in ClcCs.ini which can be found in C:\911\api.