SmartConnect 1.0.50

SmartConnect DLL

Disclaimer

The Smart Connect DLL is provided "as is" without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. The authors and distributors of this DLL are not responsible for any direct, indirect, incidental, or consequential damages arising out of the use or inability to use this software, even if advised of the possibility of such damages. By integrating or using this DLL in your application, you acknowledge and accept all risks associated with its use, including but not limited to data loss, service interruptions, or security vulnerabilities. It is the user's responsibility to ensure that the DLL is appropriately configured and tested in their specific environment.

Overview

SmartConnect is a robust C# DLL designed to simplify payment processing on Pax and Valor terminals. It provides a seamless interface for handling various transaction types, device configurations, and payment workflows. SmartConnect streamlines integration, ensuring secure, efficient, and reliable transaction processing with minimal development complexity.

Key Features

• Seamless Integration: Simplifies communication with Pax and Valor payment terminals.
• Transaction Types: Supports Credit Sale, Credit Void, Credit Auth, Credit Capture, Gift Card transactions, Debit transactions, EBT operations, and more.
• Customizable Device Settings: Easily configure device IP, serial number, port number, API key, and timeout.
• Batch Operations: Supports closing and managing transaction batches.
• Signature Handling: Capture, retrieve, and process digital signatures.
• Real-time Response Handling: Get detailed transaction responses with all relevant fields.

Prerequisites

• .NET Framework 4.5 or higher
• Compatible Pax or Valor payment terminals
• API keys and device configurations

Installation

1. Reference SmartConnect.dll in your C# project.
2. Ensure all dependencies are properly installed.
3. Add the necessary namespaces:

   using SmartConnect;
   using SmartConnect.model;
   

Configuration

Before processing payments, set up your device settings:

DeviceSettings myDevice = new DeviceSettings();
myDevice.DeviceSn = "123456";
myDevice.PortNo = "4000";
myDevice.DeviceIp = "192.168.0.100";
myDevice.Timeout = "30";
myDevice.AccNumber = "API_KEY_HERE";

smart myClass = new smart();
myClass.DeviceSetting = myDevice;

Usage

Credit Sale Example

PaymentResponse myResp = myClass.CreditSale(100.50, "CARD1234", 1);
MessageBox.Show(myResp.ResponseMsg);

Credit Void Example

PaymentResponse myResp = myClass.CreditVoid("TXN_ID", "CARD1234");
MessageBox.Show(myResp.ResponseMsg);

Batch Close Example

BatchResponse myBatch = myClass.CloseBatch();
MessageBox.Show(myBatch.ResponseMsg);

Supported Transactions

• CreditSale: Process a credit sale.
• CreditVoid: Void a credit transaction.
• CreditAuth: Authorize a credit payment.
• CreditCapture: Capture an authorized payment.
• CreditAdjust: Adjust a credit transaction.
• GiftActivate, GiftSale, GiftAdd, GiftBalance: Handle gift card operations.
• DebitSale, DebitReturn: Manage debit card transactions.
• EBT: Supports EbtSale, EbtReturn, EbtBalance, EbtCash, and EbtCashBalance.

Handling Responses

Each transaction returns a PaymentResponse or BatchResponse object, which contains fields like:

• ResponseMsg: Message from the terminal.
• TransactionID: Unique ID for the transaction.
• AuthCode: Authorization code.
• ApprovedAmount: Approved transaction amount.
• CardHolder: Cardholder name.

Example:

MessageBox.Show(myResp.ResponseMsg);

Error Handling

Always validate the response after a transaction to handle failures gracefully.

if (myResp.ResponseCode != "00")
{
    MessageBox.Show($"Transaction Failed: {myResp.ResponseMsg}");
}

Support

For further assistance, please contact our support team or refer to the official documentation.

License

SmartConnect is proprietary software. Unauthorized distribution or modification is prohibited.

Simplify Payment Processing with SmartConnect – Reliable, Efficient, and Developer-Friendly!

** Sales/Support : (253)655-4420