Documentation Changes

Chapter 1

Introduction

Who Should Read This Guide

Other Necessary Documentation

General Documentation

Business Center Users

Enterprise Business Center Users

Using PHP in a Hosted Environment

Choosing Your API and Client Version

API Variation

Client Versions

Sample Code Available

Basic PHP Page Example

Sample Scripts

Sample PHP Pages

Chapter 2

Installing and Testing the Client

System Requirements

For Linux

For Windows

Creating a Security Key

Business Center Users

Resellers

Merchants

Enterprise Business Center Users

Installing the Client

For Linux

For Windows

Configuring Client Settings

Testing the Client

Going Live

Business Center Users

Enterprise Business Center Users

Updating the Client to Use a Newer API Version

Special Installation Instructions for Oracle Users

Chapter 3

PHP API for the Client

Summary of Functions

cybs_load_config()

cybs_run_transaction()

Reply Key Descriptions

Possible Return Status Values

Chapter 4

Using Name-Value Pairs

Other Necessary Documentation

Requesting ICS Services

Creating and Sending the Request

Loading the Configuration Settings

Creating an Empty Request Array

Adding the Merchant ID

Adding Services to the Request Array

Requesting a Sale

Adding Service-Specific Fields to the Request Array

Sending the Request

Interpreting the Reply

Handling the Return Status

Processing the Reason Codes

Handling Reviews

Requesting Multiple Services

Retrying When System Errors Occur

Chapter 5

Using XML

Other Documentation You Need

Requesting ICS Services

Sample Code

Creating a Request Document

Creating an Empty Request

Adding the Merchant ID

Adding Services to the Request

Requesting a Sale

Adding Service-Specific Fields to the Request

Sending the Request

Loading the Configuration Settings

Reading the XML Document

Sending the Request

Interpreting the Reply

Handling the Return Status

Processing the Reason Codes

Handling Reviews

Requesting Multiple Services

Retrying When System Errors Occur

Appendix A

Generating Security Keys

Preparing to Generate a Key

Merchants Using the Business Center

Merchants Using the Enterprise Business Center

Generating a Key

Appendix B

Viewing a Security Key’s Serial Number

Instructions for Internet Explorer

Importing the Key File

Viewing the Serial Number

Instructions for Netscape

Importing the Key File

Viewing the Serial Number

Appendix C

Advanced Configuration Information

Using Alternate Server Configuration Settings

Configuring Your Settings for Multiple Merchant

Appendix D

Using the Client Application Fields

Index