ENHANCED GATEWAY Integration manual for

developers

DLL
Copyright by Enhanced Payment Systems
 ENHANCED GATEWAY DLL

Enhanced gateway

Enhanced Gateway DLL

EnhancedGateway DLL has packaged everything you ever need to implement a complete payment integra�on for:

• Credit and Debit card processing

• Gi� Cards
• ACH

Credit/Debit Card transactions

EnhancedGateway DLL supports the following methods:

• CreditSale
• DebitSale
• CreditVoid
• CreditReturn
• CreditAuth
• CreditCapture
• DebitReturn
• GetToken
• CloseBatch

Gift card transactions

In addi�on to the credit/debit transac�ons, you can also perform gi� card and ACH transac�ons:

• Gi�Issue
• Gi�Balance
• Gi�Redeem

ACH transactions

• ACHSale
• ACHStatus
• ACHReturn

Page 1 of 5
 ENHANCED GATEWAY DLL

Anatomy

EnhancedGateway DLL contains a class called EGProcess. This class includes all objects, methods, and classes you will
need to perform a variety of transac�ons.

Methods:

StartProcess() is a public method instan�ate all objects and classes:

These are the accepted transac�on types you can call from enhancedgateway.dll:

• creditsale
• creditauth
• creditreturn
• getoken
• creditcapture
• creditvoid
• creditadjust

The followings are public methods to perform transac�ons:

1. CreditSale() : Perform a credit sale transac�on

2. CreditAuth() : Performs a credit auth transac�on
3. CreditReturn() : Performs a credit return transac�on
4. CreditVoid() : Performs a credit void transac�on
5. CreditCapture() : Performs a credit capture transac�on on an auth
6. CreditAdjust() : Performs a credit adjust transac�on
7. GetToken() : Performs a request token transac�on

Other methods are available to perform Gi� Card and ACH transac�ons.

Classes

The following classes represent objects that store and return field values in requests and responses:

Transac�on Request Fields:

Class Name: RequestFields

Field Description
Account Valid EPS Account number
Serial Device Serial Number
Ticket Ticket Id,or Invoice Id
Token Valid card token
Ptk Primary Transaction Key
Zip Zip Code
Address Street Address

Page 2 of 5
 ENHANCED GATEWAY DLL

Userid User or Clerk Id

Email Email address for receipt
Amount Transaction amount
TipReq Send tip amount along with the sales amount.
Only 0 or 1. Default = 0
Tip Send tip amount along with the sales amount.
Surcharge Surcharge amount
FirstName Customer first name
LastName Customer last name
MerchantID Only applicable in multi-merchant scenarios
TransactionID Send in CreditVoid, CreditReturn, and
CreditCapture

Transac�on Request Fields:

Class Name: ResponseFields

Field Description
TransactionResult True or False
PTK Primary Transaction Key
ResponseCode Response code from the processor
ApprovedAmount Approved amount of the transaction
TransactionID Transaction ID of the processed transaction
AuthCode Authorization Code
Token Tokenized value of the card
CardType Card brand
AccountNum Last 4-digitof the processed card
ExpDate Expiration date of the card
TicketID Ticket of invoice number
ResponseMsg Response message from the processor
Host code Host code from the processor
Timestamp Date and time of the transaction
AVSResponse Address Verification Status
CardHolder Full name of the cardholder
BusinessID EPS account number of the merchant
UniqueId A unique ID returned by EPS gateway
TransType Transaction type
EntryMode Card entry method, Swipe, Chip, Contactless, etc.
RefNum Transaction Reference number
SerialNo Terminal serial number

Page 3 of 5
 ENHANCED GATEWAY DLL

AmountDue Amount due after the card was charged. Used in

partial payments
TipAmount Tim amount, if it was captured on the terminal
SurchargeAmount Surcharge amount captured
CvResponse Card Verification response
HostResponse Host response
ExtraBalance Remaining balance on the card. Prepaid cards
CardBin Card Bin
Tc EMV Tc tag
Tvr EMV TVR tag
Aid EMV AID tag
Tsi EMV TSI tag
Atc EMV ATC tag
AppLab EMV APPLAB tag
AppPn EMV APPPN tag
Iad EMV IAD tag
Arc EMV ARC tag
Cid EMV CID tag
Cvm EMV CVM tag
BatchNo Batch number
UserId Clerk or user ID
Installation
Enhance Gateway DLL requires .Net Framework version 4.7 or higher.

This guide explains adding the Enhance Gateway to your .Net applica�on in the Visual Studio environment.

1.Copy enhancedgatewa.dll it to a folder in your development system.

2.In VS, open your project, and in the Solu�on Explorer, right-click on the References.

3.Select Add Reference, and then from the next screen, select Browse.

4.Browse to the loca�on where you saved the enhancedgatewa.dll file. Select the file and click on the Add buton.

That's it!
Page 4 of 5
 ENHANCED GATEWAY DLL

Usage:

A�er you added enhancedgateway.dll to your project, you must add it to the classes were you make payment
transac�ons.

Start by adding the following line:

using enhancedgateway;

Then create an instance of enhancedgateway in your code:

EGProcess myProcess = new EGProcess();

Then call the StartProcess() method of the enhancedgateway:

//Ins�n�ate EPS payment

myProcess.StartProcess();

Next, you will need to build a request object. The following code shows how to build a request for a credit sale
transac�on:

myProcess.requestFields.Account = EPSAccount;

myProcess.requestFields.Amount = Amount;

myProcess.requestFields.Ticket = �cketNumber;

myProcess.requestFields.Serial = serialNumber;

myProcess.CreditSale();

The above method performs the credit sale transac�on and returns a Boolean value that indicates whether the
transac�on succeeded or not.

Get the response fields and store them according to the logic, and flow of you applica�on:

Transac�onID = myProcess.responseFields.Transac�onID;

CardType = myProcess.responseFields.CardType;

AccountNum = myProcess.responseFields.AccountNum;

Please contact EPS Integra�on team if you have any ques�ons.

[email protected]

Page 5 of 5