Difference between revisions of "QuickStart Integration Guide"

From Payment Processing Software Library
Jump to: navigation, search
(Sample Configuration)
(Programming the Samples)
Line 102: Line 102:
 
[[File:SampleRun.jpg|none|600px|Running Sample Screen]]
 
[[File:SampleRun.jpg|none|600px|Running Sample Screen]]
  
=Programming the Samples=
 
#Add the reference to the ClcCom library.
 
##In "vs.net 2005 IDE", Select Project->Add Reference.
 
##In the popup window, select Browse and then browse to the directory to select the ClcCom.dll.
 
#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.
 
 
=Troubleshooting=
 
=Troubleshooting=
 
#When running the sample application, if you encounter the error “side-by-side…”. Please try to install “vcredist_x86.exe” on your environment.
 
#When running the sample application, if you encounter the error “side-by-side…”. Please try to install “vcredist_x86.exe” on your environment.

Revision as of 05:26, 28 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 Networked 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!

Software Installation & Configuration

Note: This is a more complex guide. We suggest that you complete the simpler Quick Start Integration Guide, first.

Installation Topology Overview

Simple Client-Server Installation. Note, that both components will happily reside on the same machine, as well.
See details below.

Server Side Install

  1. Log onto the 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. Install the program into "C:\CLServer\911" directory (you will have a chance to specify the directory).

Server Side Directory Description

  • c:
    • CLServer → Share as CLShare
      • 911
        • Bin
-CCV_SERVER.EXE → "CreditLine Server"
-CCV_MANAGER.EXE → "CreditLine Manager"
-clcapiw.h → "API HEADER"
-clcapiw2.dll → "API DLL"
-clcCs.dll → ".NET Wrapper
-clcClient.ocx → "OCX Wrapper"
-clcUI.exe → Optional Quick PCI Friendly UI
-clcUI.ini → Customization for PCI Friendly UI

Client Side Install

  1. Log into Client in the topology above.
  2. Download the latest version of CreditLine "Client Only Regular Install" from http://911software.com -> Downloads page.
  3. Install the program into "C:\CLClient\911" directory (you will have a chance to specify the directory).

Client Side Directory Description

  • c:
    • CLClient
      • 911
        • API
-clcapiw.h → "API HEADER"
-clcapiw2.dll → "API DLL"
-clcCs.dll → ".NET Wrapper
-clcClient.ocx → "OCX Wrapper"
  • BIN
-clcUI.exe → Optional Quick PCI Friendly UI
-clcUI.ini → Customization for PCI Friendly UI

Setting up Client-Server Communication

Server Side

  1. Log into Server
  2. Share the CLServer directory (containing 911 directory) on the server with full permissions (scroll down for a screenshot).
    1. Navigate to the installation drive
    2. Right click on CLServer directory
    3. Select PropertiesSharingAdvanced Sharing
    4. Check Share This Folder, leave the Share name as CLShare
    5. Click Permissions
    6. Select Everyone
    7. Click Allow across from Full Control

Creating the Server Share

Client Side

  1. Log into CreditLine Client in the topology above.
  2. Navigate to the Server from the Network interface in Windows.
  3. Map the \\Server\CLShare to a new drive, let's call it Z:
    MapDrive.jpg
  4. In the sample programming examples below, you will be setting your data directory to "Z:/911/DATA" and messages directory to "Z:/911/MESSAGES"

Testing the Installation

Server Side

  1. Run c:\CLServer\911\BIN\CCV_SERVER.exe (CreditLine Server) and then c:\CLServer\911\BIN\CCV_MANAGER.exe (CreditLine Client).
  2. Login with the default User Name and Password are on the 911 Software downloads page (admin/creditline1).
  3. Change the password, if prompted
  4. The software comes with a test account.
  5. Run a test card (4111 1111 1111 1111, with any valid exp date) for $1 by selecting Command->Sale from CreditLine Manager

CommandSale.jpg

Client Side

Creating a Manager Shortcut

  1. On the client, navigate to the server mapped Z: drive.
  2. Enter Z:\911\BIN
  3. Hold Alt, while left-clicking on CCV_Manager.exe (CREDITLINE CLIENT) and dragging it to the desktop.
  4. Release the mouse
    RunningManagerfromServer.jpg
  5. Double click on the CreditLine Manager Shortcut to start the Manager.
  6. Login with the default User Name and Password are on the 911 Software downloads page (admin/creditline1).
  7. Change the password, if prompted
  8. The software comes with a test account.
  9. Run a test card (4111 1111 1111 1111, with any valid exp date) for $1 by selecting Command->Sale from CreditLine Manager

CommandSale.jpg

Samples Installation and Configuration

Sample Repository

The sample directory is located here: CreditLine Integration Samples Repository → Note: the following technologies are filed under the legacy directory: VB6, Java, C++, .Net


Sample Configuration

  1. Complete the installation steps above.
  2. Log into the Client
  3. Download the sample from relevant folder CreditLine Integration Samples Repository, corresponding to the technology that you are using (e.g. C_Sharp for C# or legacyVB6JavaCppDotNet/VB6 for VB6)
  4. If you copy any files from the sample to CreditLine Client installation path(C:\CLClient\911\api), do not overwrite any files.
  5. Please, read and follow the important steps, outlined in the README file inside the sample directory.

Running The Sample

  1. Double chick CSDriver.exe to run the Sample. Make sure, to set the correct path to the server's 911 directory (e.g. Z:/911 in this case)
Running Sample Screen

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.