Link a website directly to the EZ Payment Gateway - direct.aspx
If you have not read the
EZ Payment Gateway overview, please read it NOW before continuing.
EditAt the very minimum, your web site must do the following in order to be linked properly with the EZ Payment Gateway Secure transaction gateway:
- Your web site must calculate a total amount that is to be authorized by the EZ Payment Gateway system. The EZ Payment Gateway code samples below DO NOT demonstrate how to calculate totals; calculating a total amount is not part of the EZ Payment Gateway system, and usually requires script programming in your web site.
- Your web site must pass at least the merchant name (assigned by Merchant Services), the unique order ID, associated with the shopping cart, the total amount, a URL to return transaction information to the EZ Payment Gateway.
- Any other fields, such as Invoice, Customer ID, Name, Address, etc. MUST be stored in a data file on your system that can be retrieved via the OrderID field that will be passed back to your system.
EditYou must pass the following fields to the EZ Payment Gateway system. To work properly, the fields must be named exactly (case sensitive) as they are named here:
| Key |
Value |
| Merchant |
Merchant name assigned by Merchant Services |
| OrderID |
unique order ID |
| total |
US dollars without '$' |
| email |
billing email address (optional) |
| URL |
the website to which the gateway will redirect the user after transaction |
| Cardname |
type of credit card |
| Cardname |
type of credit card |
| Cardnum1 |
first 4 numbers on card |
| Cardnum2 |
second 4 numbers on card |
| Cardnum3 |
third 4 numbers on card |
| Cardnum4 |
fourth 4 numbers on card |
| NameonCard |
name of cardholder |
| Cardstreet |
street of cardholder |
| Cardcity |
city of cardholder |
| Cardstate |
state of cardholder |
| Cardzip |
zip code of cardholder |
| Cardcountry |
country of cardholder |
| CardexpM |
expiration month, format ex: 04 |
| CardexpY |
expiration year, format ex: 05 |
| CVV2 |
format ###(#) (3 digits for Visa/Mastercard and 4 digits for Amex) |
| email |
email address of customer (optional) |
EditThe following HTML code snippet represents the bare minimum requirements: Note - You must have generated a unique OrderID, Calculated your total, and have a script/URL to process the variables that will be returned to your server.) The result of the HTML code snippet on a web site is a simple button that is programmed to pass a total dollar amount to the EZ Payment Gateway secure payment form.
<form method="POST" action="https://secure.goemerchant.com/secure/gateway/direct.aspx">
<input type="hidden" name="Merchant" value="Merchant Name assigned by Merchant Services">
<input type="hidden" name="OrderID" value="Unique OrderID value">
<input type="hidden" name="email" value="Customers email address (OPTIONAL)">
<input type="hidden" name="total" value="total calculated transaction amount value">
<input type="hidden" name="URL" value="http://Your Web Site Address/script name to receive variables">
Example -- http://www.mystore.com/CGI-bin/receipt.aspx"
(Note - You may call your script anything you please. The name receipt is used for example only!)
<input type="text" name="Cardname"><Br>
<input type="text" name="Cardnum1"><Br>
<input type="text" name="Cardnum2"><Br>
<input type="text" name="Cardnum3"><Br>
<input type="text" name="Cardnum4"><Br>
<input type="text" name="NameonCard"><Br>
<input type="text" name="Cardstreet"><Br>
<input type="text" name="Cardcity"><Br>
<input type="text" name="Cardstate"><Br>
<input type="text" name="Cardzip"><Br>
<input type="text" name="Cardcountry"><Br>
<input type="text" name="CardexpM"><Br>
<input type="text" name="CardexpY"><Br>
<input type="text" name="CVV2"><Br> </form> |
EditThe EZ Payment Gateway system will return the following variables to your program indicating a successful or failed transaction.
| Key |
Value |
| OrderID |
echoed back from the server that was provided in the secure post |
| total |
total amount authed |
| Status |
will return 1 if success, 0 if failed |
| approval_code |
approval code returned by bank |
| authresponse |
authorization response returned by bank |
| avs |
the avs (address verification service) code returned by the bank |
| Cardname |
type of credit card |
| NameonCard |
name of cardholder |
| Cardstreet |
street of cardholder |
| Cardcity |
city of cardholder |
| Cardstate |
state of cardholder |
| Cardzip |
zip code of cardholder |
| Cardcountry |
country of cardholder |
| email |
email address of customer (optional) |
(Note: These key = value pairs will return in a URL query string for credit card transactions like the example below)
http://www.yourservername.com/CGI-bin/receipt.aspx?Status=1&approval_code=41111&
authresponse=AUTH%20APPROVED&avs=Y&OrderID=100&total=1.00&
Cardname=Visa&NameonCard=John%20Doe&Cardstreet=123%20Street&
Cardcity=Nowhere&Cardstate=NJ&Cardzip=08000&Cardcountry=US&email=test@test.com |
Top