EnhancedGateway 1.0.0
dotnet add package EnhancedGateway --version 1.0.0
NuGet\Install-Package EnhancedGateway -Version 1.0.0
<PackageReference Include="EnhancedGateway" Version="1.0.0" />
paket add EnhancedGateway --version 1.0.0
#r "nuget: EnhancedGateway, 1.0.0"
// Install EnhancedGateway as a Cake Addin #addin nuget:?package=EnhancedGateway&version=1.0.0 // Install EnhancedGateway as a Cake Tool #tool nuget:?package=EnhancedGateway&version=1.0.0
Enhanced
gateway DLL
Copyright by Enhanced Payment Systems
Integration manual for developers
Enhanced gateway
Enhanced Gateway DLL
EnhancedGateway DLL has packaged everything you ever need to implement a complete payment integration for:
- Credit and Debit card processing
- Gift 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 addition to the credit/debit transactions, you can also perform gift card and ACH transactions:
- GiftIssue
- GiftBalance
- GiftRedeem
ACH transactions
- ACHSale
- ACHStatus
- ACHReturn
Anatomy
EnhancedGateway DLL contains a class called EGProcess. This class includes all objects, methods, and classes you will need to perform a variety of transactions.
Methods:
StartProcess() is a public method instantiate all objects and classes:
These are the accepted transaction types you can call from enhancedgateway.dll:
- creditsale
- creditauth
- creditreturn
- gettoken
- creditcapture
- creditvoid
- creditadjust
The followings are public methods to perform transactions:
- CreditSale() : Perform a credit sale transaction
- CreditAuth() : Performs a credit auth transaction
- CreditReturn() : Performs a credit return transaction
- CreditVoid() : Performs a credit void transaction
- CreditCapture() : Performs a credit capture transaction on an auth
- CreditAdjust() : Performs a credit adjust transaction
- GetToken() : Performs a request token transaction
Other methods are available to perform Gift Card and ACH transactions.
Classes
The following classes represent objects that store and return field values in requests and responses:
Transaction 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 |
Userid | User or Clerk Id |
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 |
Transaction 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 |
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 application 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 Solution Explorer, right-click on the References.
3.Select Add Reference, and then from the next screen, select Browse.
4.Browse to the location where you saved the enhancedgatewa.dll file. Select the file and click on the Add button.
That's it!
Usage:
After you added enhancedgateway.dll to your project, you must add it to the classes were you make payment transactions.
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:
//Instintiate 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 transaction:
myProcess.requestFields.Account = EPSAccount;
myProcess.requestFields.Amount = Amount;
myProcess.requestFields.Ticket = ticketNumber;
myProcess.requestFields.Serial = serialNumber;
myProcess.CreditSale();
The above method performs the credit sale transaction and returns a Boolean value that indicates whether the transaction succeeded or not.
Get the response fields and store them according to the logic, and flow of you application:
TransactionID = myProcess.responseFields.TransactionID;
CardType = myProcess.responseFields.CardType;
AccountNum = myProcess.responseFields.AccountNum;
Please contact EPS Integration team if you have any questions.
dev@mysupport.io
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net472 is compatible. net48 was computed. net481 was computed. |
-
- Microsoft.NETFramework.ReferenceAssemblies.net472 (>= 1.0.3)
- Newtonsoft.Json (>= 13.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.0 | 182 | 4/6/2023 |
Supports Pax, and Dejavoo integartoin.
Support EPS+ app