QuickStart Integration Guide

From Payment Processing Software Library
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

Not finding all the answers? Try Knowledge Base!

Overview

In this quickstart guide we will help you setup a Sample Demo executable that has the ability to test and troubleshoot CreditLine APIs.

→ Below is a screenshot of extended VB demo in action.  There are also simplified demos for other languages.


Sample Demo  Program In Action

CreditLine Client and Server Installation

The following samples rely on a known installation structure. If you already installed the software, you might want to uninstall it and follow one of the guides below, to ensure smooth integration experience.

If client and server reside on separate networked machines, please follow CreditLine Networked Client-Server Installation
Simple Client-Server Installation



If client and server  reside on the same machine, please follow CreditLine Local Client-Server Installation

Ingegration Options

Integration Languages

There are several integration options for Creditline:

  1. DLL for C#, C++, et
  2. Java Wrapper for Java
  3. OCX for Visual Basic, dotNet, etc
  4. Encrypted Text Import for manual batch processing.

Integration Styles

There are three major integration styles

  1. → (recommended) Integrator uses CreditLine supplied UI (UI Encapsulation). This is 'clcUI PCI Friendly API Option
  2. Integrator provides their own UI
  3. Integrator uses Encrypted Text Import for manual batch processing

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 Installation

  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 on the client, as what you installed prior will be usually newer.
  5. Please, read and follow the important steps, outlined in the README file inside the sample directory.

Running The Sample

Every Sample Directory has:
a)Already compiled executable
b)Source code
c)Read me file



To begin:

  1. Make sure to read and follow directions in the README file, first
  2. When you run the sample EXE, make sure, to set the correct path to the server's 911 directory (e.g. c:\CLServer\911\bin or Z:/911, if the server is on another machine and Z is the mapped drive)
Running Sample Screen
  1. Take a look at the clcapiw.h in c:\CLServer\911\BIN folder for the full list of available functions
  2. Source code contains all the common API sequences
  3. The dialogs for different languages may vary.
  4. The difference between regular calls and CLCUI calls (prefixed with clc), is that clcUI has its own customizable interface to help you avoid handling secure data. For more info see PCI Friendly API


Integration Tutorial

 → Please, see CreditLine Integration Tutorial

List of API Calls

Please see c:\CLServer\911\BIN\CLCAPIW.h

 NOTE:  OCX/COM/ATL objects simply wrap the standard API DLL, removing "clc" prefix from functions.

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.

Documentation

→ After you have a working sample integration, we suggest that you peruse the CreditLine Integration Guide