QuantumGateway: The Evolution of Payment Processing


We have put together an order form template that does not require the merchant to use a shopping cart or a database engine.
This form can be put on any website with minimal ease.
Web designers can implement shopping through our secure server directly into their customers web pages.
This order form system will also include a checkout form when submitting to it.
** Please note that this method is NOT a shopping cart. It will only allow one total amount to be processed at one time.

Sample 1 - Billing & Shipping Info
Sample 2 - Purchase a Product
Recurring Help PDF

Standard Web Order Form Fields

Requirements


Options:

Checkout Form Customization:

Post Back Information


Required Form Fields

Form Declaration

This is the start of the Form as well as where the form will be submitted to.
<FORM METHOD=POST ACTION="https://secure.quantumgateway.com/cgi/web_order.php">
Please also make sure you put that at the end of your form.
</FORM>

Gateway Login
<input name="gwlogin" type="hidden" value="your_gateway_login">

Post Return URL
Option 1
<input name="post_return_url" type="hidden" value="http://www.mydomain.com/thankyou.html">
or use approved and declined URLs
Option 2
<input name="post_return_url_approved" type="hidden" value="http://www.mydomain.com/approved.html">
<input name="post_return_url_declined" type="hidden" value="http://www.mydomain.com/declined.html">

You may use option 1 or 2. If the post_return_url is present it will override the approved and declined urls.

Item Quantity
<input name="item_qty" type="hidden" value="1">
Please note that the overall amount will be calculated by item_qty times item_cost

Item Description
<input name="item_description" type="hidden" value="One year subscription to http://www.mydomain.com">

Item Cost
<input name="item_cost" type="hidden" value="the_trans_dollar_amount">
If this field is not present the order will not be processed.

Back To Top


Optional Form Fields

Company
<input name="company" type="text" value="their_value">

Fax
<input name="fax" type="text" value="their_value">

Customer ID
<input name="cust_id" type="text" value="their_value">

Customer IPaddress
<input name="customer_ip" type="text" value="their_value">

Invoice Number
<input name="invoice_num" type="text" value="their_value">

Invoice Description
<input name="invoice_description" type="text" value="their_value">

Please note that fields may also be hidden fields.

User Defined Fields

Any field passed along with "UserVar" will attached to the end of the email sent to the merchant.

ie: <input name="UserVar_login" type="hidden" value="mylogin">

Any field passed along with "CustomerVar" will be attached to the end of the email sent to the customer.

ie <input name="CustomerVar_password" type="hidden" value="abc123">

Override Default Email Customer
<input name="override_email_customer" type="hidden" value="Y"> <!--Send email receipt regardless of default setting ->
<input name="override_email_customer" type="hidden" value="N"> <!--Do not send email receipt regardless of default setting ->

Override Default Send Transaction Email/Notice
<input name="override_trans_email" type="hidden" value="Y"> <!--Send merchant transaction notice regardless of default setting ->
<input name="override_trans_email" type="hidden" value="N"> <!--Do not send merchant transaction notice regardless of default setting ->

Back To Top


Check Out Form Fields
(already Setup)

If you are collecting this information already on your site then you may pass it along to the check out form.

Billing Information

First Name <input type="hidden" name="FNAME" value="your value">
Last Name <input type="hidden" name="LNAME" value="your value">
Address <input type="hidden" name="BADDR1" value="your value">
City <input type="hidden" name="BCITY" value="your value">
State <input type="hidden" name="BSTATE" value="your value">
Zip <input type="hidden" name="BZIP1" value="your value">
Country <input type="hidden" name="BCOUNTRY" value="your value">
Phone <input type="hidden" name="phone" value="your value">

You may also pass the phone off like this.

<input type="hidden" name="PHONE_AREA" value="your value">
<input type="hidden" name="PHONE_PREF" value="your value">
<input type="hidden" name="PHONE_SUFF" value="your value">

Email <input type="hidden" name="BCUST_EMAIL" value="your value">

Shipping Information

First Name <input type="hidden" name="SFNAME" value="your value">
Last Name <input type="hidden" name="SLNAME" value="your value">
Address <input type="hidden" name="SADDR1" value="your value">
City <input type="hidden" name="SCITY" value="your value">
State <input type="hidden" name="SSTATE" value="your value">
Zip <input type="hidden" name="SZIP1" value="your value">
Country <input type="hidden" name="SCOUNTRY" value="your value">

Credit Card Number

Credit Card Expiration


Check Out Form Customizations

Company Logo
<input type="hidden" name="company_logo" value="http://www.mydomain.com/images/company_logo.gif">
A complete URL is required, including "http://www.". This allows you to utilize different logos from different pages if so desired.

Background Color
<input type="hidden" name="bg_color" value="rgb color">
RGB colors are the hex-based values supported by html. IE #C0C0C0 is gray. If background color is sent the default #FFFFFF white will be used.

Text Color
<input type="hidden" name="txt_color" value="rgb color">
If no text color is sent then Black(#000000) will be used.

Page Heading
<input type="hidden" name="page_heading" value="Your Company">
If no page heading is sent QuantumGateway will be used.
The Page Heading is the heading you see at the top of your browser bar

Payment Form Header Display
<input type="hidden" name="payment_heading" value="Text You Want To Display ">
Anything sent in this form field will be shown at the top of the checkout/payment page.

Receipt Header
<input type="hidden" name="header_receipt" value="Show This Text">
Anything sent in this form field will be displayed at the top of the receipt page. Right before the order summary.

Receipt Footer
<input type="hidden" name="footer_receipt" value="Show This Text">
Anything sent in this form field will be displayed at the very bottom of the receipt page. Right after the order summary.

Email Header
<input type="hidden" name="header_email" value="Show This Text">
Anything sent in this form field will be displayed at the very top of the email receipt to the customer.

Email Footer
<input type="hidden" name="footer_email" value="Show This Text">
Anything sent in this form field will be displayed at the very bottom of the email receipt to the customer.

Skip Shipping Information
<input name="skip_shipping_info" type="hidden" value="Y">
Skips showing the Shipping Information in the check out form.


Recurring Help (All methods)

You may setup a recurring entry by simply passing along the following form fields along with the Standard Web Order Form Fields.


<input type="hidden" name="override_recur" value="Y">
You may override the default Recurring price by adding the line above.
When submitted with Y the recuring price will be the item_cost.

<input type="hidden" name="OverRideRecureDay" value="Y">
You may override the default Recurring day with the current day by adding the line above.
<input type="hidden" name="RID" value="your_RID#"> **
Your RID # is the number associated with the Recurring Recipe. If you are unsure of the RID click on View Recipes in the Recurring Center. The RID is the first column.
<input type="hidden" name="initial_amount" value="your_dollar_amount">
If this field is not present the normal Transaction amount will be used.
<input type="hidden" name="recur_times" value="your_recur_times">
If this field is not present the default recur times will be used per the specs of the above RID

Q: What is the purpose of the initial_amount?
A: This is useful if you need to pro-rate a payment. Real good for mid month sign ups.

Q: Do i have to use the initial_amount field?
A: No. If this field is not present the customer will be charged the normal submitted amount.

Q: What is the purpose of the override_recur?
A: If this field is submitted with Y then the recurring amount will be the item_cost.

Q: Can I have a form that will allow my customers to chose if they wish to have a recurring charge or not?
A: Yes this is possible. However it must be chosen this way on your website before it gets submitted to the Web Order page.
There is a way with java script that if chose Y to this option it would populate the needed fields.



** You must pass an RID number to setup a recurring transaction.


Custom Required Fields
If you wish to require a certain field to be filled in, you may submit that with the rest of the options above. You may use any or all of these required options.

<input name="Require_FNAME" type="hidden" value="Y">
Requires Billing First Name to be entered.
<input name="Require_LNAME" type="hidden" value="Y">
Requires Billing Last Name to be entered.
<input name="Require_phone" type="hidden" value="Y">
Requires Billing Phone to be entered.
<input name="Require_BCITY" type="hidden" value="Y">
Requires Billing City to be entered.
<input name="Require_BSTATE" type="hidden" value="Y">
Requires Billing State to be entered.
<input name="Require_BCOUNTRY" type="hidden" value="Y">
Requires Billing Country to be entered.
<input name="Require_CVV2" type="hidden" value="Y">
Requires CVV2 to be entered.


Post Back Information

Here is a sample of data posted back.
<input name="ID" type="hidden" value="1">
<input name="transID" type="hidden" value="8675309">
<input name="authCode" type="hidden" value="09852">
<input name="trans_result" type="hidden" value="APPROVED">
<input name="avs_result" type="hidden" value="Y">
<input name="cvv2_result" type="hidden" value="M">
<input name="max_score" type="hidden" value="0.00">
<input name="md5_hash" type="hidden" value="234558fjhj3g3g3g2jsdkwi2">
<input name="cust_id" type="hidden" value="1234">


Sample Recurring email
APPROVED 007 James Bond 19.95 - Monthly Recurring

Back To Top