HomeContact Us
Technical FAQ
Home | Products | Applications | Processors Supported | How It Works | Support | About Authotrans | Contact Us   

Frequently Asked QuestionsTechnical & Integration Questions
Related Links: Lookup Function | Passback Function | Return Mode Function | Return Address | PGP Signature | Email Text Field
I'm setting up different styles of order forms. What URL do I POST the form to?

STANDARD Form Post:
<FORM METHOD="POST" ACTION="https://secure.paymentclearing.com/cgi-bin/rc/ord.cgi">

SPLITFORM Post:
<FORM METHOD="POST" ACTION="https://secure.paymentclearing.com/cgi-bin/mas/split.cgi">

BUYNOW Post:
<FORM METHOD="POST" ACTION="https://secure.paymentclearing.com/cgi-bin/mas/buynow.cgi">


I'm setting up an order form on my site and I'm wondering what field names are required and which ones are optional.

The required fields depend on the types of payments you will be accepting. Please refer to the field definitions and examples below.



.
REQUIRED & OPTIONAL FORM FIELDS

These basic fields are always required:

vendor_id          Your ID. (Assigned when you registered.)
Example:
<input type="hidden" name="vendor_id" value="12345">
home_pageYour home page URL.
Example:
<input type="hidden" name="home_page" value="http://www.yoursite.com">
ret_addrThe full URL to which customers are directed after order completion. (This is a page or CGI on your server.)
Examples:
<input type="hidden" name="ret_addr" value="http://www.yoursite.com/thankyou.html">
<input type="hidden" name="ret_addr" value="http://www.yoursite.com/cgi-bin/return.cgi">
*_descDescription of item #*.
Examples:
<input type="hidden" name="1_desc" value="T-Shirt">
<input type="hidden" name="2_desc" value="Baseball Hat">
*_costCost of item #*.
Examples:
<input type="hidden" name="1_cost" value="19.95">
<input type="hidden" name="2_cost" value="14.95">
*_qtyQuantity of item #*.
Examples:
<input name="1_qty" value="1">
<SELECT NAME="2_qty">
<OPTION>
<OPTION>1
<OPTION>2
<OPTION>3
<OPTION>4
<OPTION>5
<OPTION>6
<OPTION>7
<OPTION>8
<OPTION>9
<OPTION>10
</select>
*_anythingAny other attribute of the item being ordered. These attributes are optional. Include as many as you'd like.
Examples:
<input name="1_size" value="Large">
<input name="1_color" value="White">
* indicates item number; 1_desc, 2_desc, 3_desc, etc.
Note: A field separator of underscore (1_desc) or dash (1-desc) may be used.

Back to the top
If you will be using either the Split Form or BuyNow format, these fields are required:
showaddrThe value of this field must be '1' when using the BuyNow format. Do not use this field if you are using a SplitForm.
Example:
<input type="hidden" name="showaddr" value="1">
mernameThe name of your business. This will appear on the order form on the secure server.
Example:
<input type="hidden" name="mername" value="Acme Clothing">
acceptcardsValue must be '1' if you are accepting credit cards.
Example:
<input type="hidden" name="acceptcards" value="1">
acceptchecksValue must be '1' if you are accepting checks.
Example:
<input type="hidden" name="acceptchecks" value="1">
accepteftValue must be '1' if you will be accepting EFT transactions.
Example:
<input type="hidden" name="accepteft" value="0">
altaddrValue must be '1' if you would like to allow customers to enter an alternate shipping address. (Used only when accepting credit cards.)
Example:
<input type="hidden" name="altaddr" value="1">
nonumRemoves the check number field from the BuyNow or SplitForm. (This field is removed automatically if you are accepting EFT payments.)
Example:
<input type="hidden" name="nonum" value="1">

Back to the top
The fields listed below are optional for any of the order form formats, but can be used to add functionality to your system. (Click on a link for more information.)
ret_modeAllows the merchant to by-pass the "Continue" page on the server after a successful order.
Examples:
<input type="hidden" name="ret_mode" value="post">
<input type="hidden" name="ret_mode" value="redirect">
Follow this link.
check_numCustomer's check number.
Example:
<input name="check_num">
check_memo      Customer's check memo. Can be input by the customer or included as a specific hidden value by the merchant. The check memo will be printed on the customer's check.
Example:
<input name="check_memo">
passbackA value defined by the merchant that will be passed back to the merchant after order completion. This function enables merchants to keep user sessions open, which enables real-time delivery of software, information, etc. (One or more values can be passed.) Please note that each passback field must contain a value. If the field contains no value, you will receive a "nonexistent passback parameter" error.
Example:
Follow this link.
lookupEnables Merchant to request specific information about a customer from the processing server. See the example order forms for complete information.
Example:
Follow this link.
email_textThe value of this field will appear in the body of the confirmation email sent to the customer.
Example:
<input type="hidden" name="email_text" value="Your password will be emailed to your shortly.">
Follow this link.


If you have your own secure server and will be using the standard order form, these fields are required.
first_nameCustomer's first name.
Example:
<input name="first_name" size=30>
last_nameCustomer's last name.
Example:
<input name="last_name" size=30>
addressCustomer's address.
Example:
<input name="address" size=30>
cityCustomer's city.
Example:
<input name="city" size=30>
stateCustomer's state.
Example:
<input name="state" size=3>
zipCustomer's ZIP or postal code.
Example:
<input name="zip" size=10>
countryCustomer's country. (If you will be accepting US checks only, you can make this a hidden field type with a value of "US".)
Example:
<input name="country" size=30>
phoneCustomer's phone number.
Example:
<input name="phone" size=15>
emailCustomer's email address.
Example:
<input name="email" size=15>
ccnumCredit card number. (If you are accepting credit cards.)
Example:
<input name="ccnum" size=20>
ccmoCredit card expiration month. (If you are accepting credit cards.)
Example:
<select NAME="ccmo">
<option>
<option value='January'>01
<option value='February'>02
<option value='March'>03
<option value='April'>04
<option value='May'>05
<option value='June'>06
<option value='July'>07
<option value='August'>08
<option value='September'>09
<option value='October'>10
<option value='November'>11
<option value='December'>12
</select>
ccyrCredit card expiration year. (If you are accepting credit cards.)
Example:
<select NAME="ccyr">
<option>1999
<option>2000
<option>2001
<option>2002
<option>2003
<option>2004
</select>
abaCustomer's 9-digit bank identification number. (If you are accepting checks.)
Example:
<input name="aba" size=10 maxlength=9>
accountCustomer's checking account number. (If you are accepting checks.)
Example:
<input name="account" size=15>

Back to the top
The fields listed below are optional and are used to obtain a shipping address:
sfnameShip-To First Name
Example:
<input name="sfname" SIZE=15>
slnameShip-To Last Name
Example:
<input name="slname" SIZE=15>
saddrShip-To Address
Example:
<input name="saddr" SIZE=15>
scityShip-To City
Example:
<input name="scity" SIZE=15>
sstateShip-To State
Example:
<input name="sstate" SIZE=15>
szipShip-To Zip Code
Example:
<input name="szip" SIZE=15>
sctryShip-To Country
Example:
<input name="sctry" SIZE=15>


Back to the top
   Home | Products | Applications | Processors Supported | How It Works | Support | About Authotrans | Contact Us   


Copyright © 2000 Authotrans.com
All rights reserved