QuickStart Integration Guide

From Payment Processing Software Library
Revision as of 04:56, 28 August 2016 by Admin (Talk | contribs)

Jump to: navigation, search
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!

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

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

Prerequisites

Microsoft .NET Framework 2.0 or higher

Sample Configuration

  1. Complete the installation steps above.
  2. Log into Machine B(CreditLine Client)
  3. Download the sample(CS:C Sharp, VB.Net) from Samples Repository
  4. 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).

Running The Sample

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

Programming the Samples

  1. Add the reference to the ClcCom library.
    1. In "vs.net 2005 IDE", Select Project->Add Reference.
    2. In the popup window, select Browse and then browse to the directory to select the ClcCom.dll.
  2. 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

  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.