Welcome to the Developer Portal

Default UI Integration
- Integrating Default UI
- Migrating from PayButton to Default UI
- Managing Default UI Properties
- Summary Screen
- Incremental Authorization
- Custom Receipt Printing
- Automatic Receipt Printing
- Standalone Receipt Printing
- Sending Receipts via Email
- Customization
- Mobile UI Customization
- Release Notes

PayButton Integration
- Integration
- Summary Screen
- On-Reader Tipping
- Loyalty and Bonus Cards
- Pre-Auth and Capture
- Refunds
- Custom Receipts
- Testing
- Going Live
- Release Notes

Windows Integration
- Configure, Run, and Test PayServer
- .NET POS Integration via PayClient
  - Refunds
  - Custom Receipts
  - Preformatted Receipts
  - On-Reader Tipping
  - Pre-Auth and Capture
- POS Integration via PayProtocol
  - Usage and Message Flows
  - Message Specification
  - Refunds
  - Custom Receipts
  - Preformatted Receipts
- Testing
- Going Live
- Release Notes

Custom Integration
- Installation
- Integration
- Signature
- Refunds
- Email & Print Receipts
- Custom Receipts
- Custom Receipts for PAX Terminals
- Preformatted Receipts
- On-Reader Tipping
- Loyalty & Bonus Cards
- Pre-Auth & Capture
- Connection Keep-Alive
- Testing
- Going Live

Backend Integration
- API Endpoints and Authentication
- WebHooks
- Query Transactions
- Refunds
- Custom Receipts
- Going Live
- API Documentation

Merchant Setup
- AMEX Merchant Setup
- Elavon Merchant Setup
- Nexi Merchant Setup

Installation — Your First Transaction

This guide shows you how to do your first integrated payment transaction using Xstore and a CyberSource payment terminal.

Prerequisites

To get started, you will need the these components:

PayServer instance connected to a card reader (see Configure, Run, and Test PayServer)

Installed EFTLink, version 15 and above

Xstore connected to EFTLink

Step 1: Install CyberSource Core

Download the CyberSource Core from the Downloads and Release Notes page and unzip the archive.

Copy the following files to your EFTLink folder:

CyberSourceVisaPW.properties

CyberSourceVisaPWCore.jar

LangEN_CyberSourceVisaPWCore.properties

PayClient.Java-Version>.jar

Include

CyberSourceVisaPWCore.jar

and

PayClient.Java-Version>.jar

in the classpath when starting EFTLink:

This step varies based on how you set up EFTLink. For example, if you start EFTLink using

eftlink.bat

, edit the line

set classpath=...

to include

CyberSourceVisaPWCore.jar

and

PayClient.Java-Version>.jar

Configure EFTLink to use the CyberSource Core:

Edit

EftlinkConfig.properties

and set the line that defines the core class to:

com.oracle.cyberSourceVisaPW.CyberSourceVisaPWCore

, e.g.

EPSCore0 = com.oracle.cyberSourceVisaPW.CyberSourceVisaPWCore

Step 2: Configure CyberSource Core

Edit

CyberSourceVisaPW.properties

to configure the CyberSource Core:

Set the environment and merchant credentials:

ProviderMode=TEST

MerchantIdentifier=Your Test Merchant Identifier>

MerchantSecretKey=Your Test Merchant Secret Key>

You can retrieve these credentials in the Gateway Manager.

Set or verify the connectivity details of the PayServer:

Remote=localhost

Port=8080

Remote is the IP or host name of the machine that runs the PayServer

Port is the port defined in the PayServer's

config.yaml

with WebSocket as the transport option.

Step 3: Start Your First Transaction

Make sure all components are running:

PayServer

EFTLink

Xstore

You can now start your first transaction from within Xstore.

Should you encounter any issues, see the FAQ and Troubleshooting page.

Installation — Your First Transaction

Related information