Link a website to the EZ Payment Gateway Secure Payment Form - process.aspx
If you have not read the EZ Payment Gateway Overview above, please read it NOW before continuing.
EditAt the very minimum, you web site must do the following in order to be linked properly with the EZ Payment Gateway Secure Payment form:
- Your web site must produce 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 your Merchant Name (assigned by Merchant Services), total amount, a Unique OrderID associated with your Shopping Cart, a URL to return transaction variables, customers email address (optional).
- Any other fields, such as 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 all of the following fields to the EZ Payment Gateway Secure Form. 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 |
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 in the QueryString.)
<form method="POST" action="https://secure.goemerchant.com/secure/gateway/process.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="email address of customer">
<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">*
* Note - if you are returning to a secure page your URL should begin with "https://"
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="submit" value="Click Here for Secure Payment Form">
</form> | |
The result of the above 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. Obviously this represents the bare minimum, and connects only to the EZ Payment Gateway Secure Payment Form. Once the customer arrives on the EZ Payment Gateway payment form, they will be prompted for payment information, name, address, city, state, zip, country, credit card information or the EZ Payment Gateway system will return the following variables (key = value pairs) via HTTP GET method to your program indicating a successful or failed transaction:
Edit
| 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 |
| 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 |