About This Guide

Audience

This guide is written for application developers who want to use the CyberSource Simple Order API client to integrate the following CyberSource services into their order management system:

nCyberSource Essentials

nCyberSource Advanced

Using the Simple Order API client SDK requires programming skills in one of the following programming languages:

nC, C++

nJava/Cold Fusion

n.NET

nPHP

To use these SDKs, you must write code that uses the API request and reply fields to integrate CyberSource services into your existing order management system.

Purpose

This guide describes tasks you must complete to install, test, and use the CyberSource Simple Order API client software.

Scope

This guide describes how to install, test, and use all available Simple Order API clients. It does not describe how to implement CyberSource services with the Simple Order API. For information about how to use the API to implement CyberSource services, see Related Documents.

Conventions

Note, Important, and Warning Statements

 

A Note contains helpful suggestions or references to material not contained in this document.

 

An Important statement contains information essential to successfully completing a task or learning a concept.

 

A Warning contains information or instructions, which, if not heeded, can result in a security risk, irreversible loss of data, or significant cost in time or revenue or both.

Text and Command Conventions

Convention

Usage

bold

nField and service names; for example:

Include the ics_applications field.

nItems that you are instructed to act upon; for example:

Click Save.

italic

nFilenames and pathnames. For example:

Add the filter definition and mapping to your web.xml file.

nPlaceholder variables for which you supply particular values.

screen text

nXML elements.

nCode examples and samples.

nText that you enter in an API environment; for example:

Set the davService_run field to true.

 

 

The Simple Order API was originally referred to as the Web Services API in CyberSource documentation. References to the Web Services API may still appear in some locations.

Related Documents

Client Package Documentation

The following documentation is available in the client package download:

nREADME file

nCHANGES file

nSample code files

CyberSource Services Documentation

This guide (Simple Order API Client Developer Guide) contains information about how to:

nCreate the request

nSend the request

nReceive the reply

In contrast, CyberSource services documentation listed in Table 1    contains information about how to:

nDetermine what to put in requests sent to CyberSource.

nInterpret what is contained in the reply from CyberSource.

Each type of CyberSource service has associated documentation:

Table 1CyberSource Services Documentation

Type of Service

Available Documentation

CyberSource Essentials

nCredit Card Services User Guide (PDF | HTML)

nElectronic Check Services User Guide (PDF | HTML)

CyberSource Advanced

nCredit Card Services Using the Simple Order API 
(PDF | HTML)

nReporting User Guide (PDF | HTML)

If you use other CyberSource services, the documentation can be found on the CyberSource Essentials or CyberSource Advanced (Global Payment Services) sections of the CyberSource web site.

Customer Support

For support information about any CyberSource service, visit the Support Center:

http://www.cybersource.com/support