This is an old revision of the document!
The USA ePay Gateway Wrapper is a Delphi VCL that provides an effortless way to connect your Delphi applications to the USA ePay gateway. Once installed the USA ePay tab will appear in the component palette and the TUSAepay object will be ready to use in your forms.
You will need the following files to install the component:
To install the component:
The component should now be installed and ready to use. To make sure it is there, use the component palette scroll button to scroll to the USAepay tab and click on it. You should see the USA ePay icon which represents the TUSAepay object.
To run your applications you will need to have these two DLL files included in this distribution:
You can copy these files into the same directory as your application exe (or project) OR you can copy them into your windows/system directory to have global access to the files on that machine. Remember that when you create and distribute an application, you will need to install these DLLs on your user's machines as well.
Please Note: You must specify the usage of Indy and IndySSL with a copyright notice in your applications.
Windows help files are also included in this distribution. The help files are in the “Help” folder and should contain the following files:
You can refer to the help files at any time by double-clicking on the USAepay.hlp file. If you would like to have access to the help file inside the Delphi IDE, you can install it by following these steps: (You should do this only after installing the USA ePay Package)
You should now see the USA ePay Gateway Wrapper Help Icon in the Delphi Help Menu.
A sample project illustrating the use of the TUSAepay object within an application is provided for you in the “Demo” folder.
The TUSAepay object is a wrapper that allows you to easily connect to the USA ePay gateway. You should assign the CGI variables of the object to their correct values (for more information on all the CGI variables available to the gateway refer to the gateway API at http://www.usaepay.com/topics/api.html). There are many variables in addition to those provided in the demo application.
The CGI variables supplied to the wrapper should be regular String (the wrapper will take care of URL encoding the variables). The sendForm function will connect to the gateway and send the URL encoded CGI variables. The function returns a string. If there are any required fields missing, the object will not send any data to the gateway (to minimize traffic load) and instead will return: !Error: missing required field!
If all the required fields are found, the sendForm function will open an SSL connection to the gateway. The result of the connection is returned as a URL encoded CGI string (refer to the above gateway API link for more details). It is the application developer's responsibility to decode the URL string returned and verify the success of the transaction.
The USA ePay component uses Indy 9.0 or above (Indy is open source and you can download it at http://www.indyproject.org.
For SSL connections it uses OpenSSL (http://www.openssl.org), the required DLL files are distributed with the component. The files are:
Both files are copyright of Intelicom (http://www.intelicom.si/index.php?newlang=eng).
For your applications to run you can copy these files into the same directory as your application exe OR you can copy them into your windows/system directory so that they can be used globally by any application running on that computer.
Program Developed by Mind2Web Enterprise for USA ePay.