| 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_page | Your home page URL.
Example:
<input type="hidden" name="home_page" value="http://www.yoursite.com"> |
| ret_addr | The 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"> |
| *_desc | Description of item #*.
Examples:
<input type="hidden" name="1_desc" value="T-Shirt">
<input type="hidden" name="2_desc" value="Baseball Hat"> |
| *_cost | Cost of item #*.
Examples:
<input type="hidden" name="1_cost" value="19.95">
<input type="hidden" name="2_cost" value="14.95"> |
| *_qty | Quantity 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> |
| *_anything | Any 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. |
If you will be using either the Split Form
or
WebButton format, these fields are required.
| showaddr | The 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"> |
| mername | The name of your business. This will appear on the order form on the secure server.
Example:
<input type="hidden" name="mername" value="Acme Clothing"> |
| acceptcards | Value must be '1' if you are accepting credit cards.
Example:
<input type="hidden" name="acceptcards" value="1"> |
| acceptchecks | Value must be '1' if you are accepting checks.
Example:
<input type="hidden" name="acceptchecks" value="1"> |
| accepteft | Value must be '1' if you will be accepting EFT transactions.
Example:
<input type="hidden" name="accepteft" value="0"> |
| altaddr | Value 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"> |
| nonum | Removes 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"> |
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_mode | Allows 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_num | Customer'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"> | |
| passback | A 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.
|
| lookup | Enables 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_text | The 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_name | Customer's first name.
Example:
<input name="first_name" size=30> |
| last_name | Customer's last name.
Example:
<input name="last_name" size=30> |
| address | Customer's address.
Example:
<input name="address" size=30> |
| city | Customer's city.
Example:
<input name="city" size=30> |
| state | Customer's state.
Example:
<input name="state" size=3> |
| zip | Customer's ZIP or postal code.
Example:
<input name="zip" size=10> |
| country | Customer'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> |
| phone | Customer's phone number.
Example:
<input name="phone" size=15> |
| email | Customer's email address.
Example:
<input name="email" size=15> |
| ccnum | Credit card number. (If you are accepting credit cards.)
Example:
<input name="ccnum" size=20> |
| ccmo | Credit 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> |
| ccyr | Credit 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> |
| aba | Customer's 9-digit bank identification number. (If you are accepting checks.)
Example:
<input name="aba" size=10 maxlength=9> |
| account | Customer's checking account number. (If you are accepting checks.)
Example:
<input name="account" size=15> |
The fields listed below are optional and
are used to obtain a shipping address.
| sfname | Ship-To First Name
Example:
<input name="sfname" SIZE=15>
|
| slname | Ship-To Last Name
Example:
<input name="slname" SIZE=15> |
| saddr | Ship-To Address
Example:
<input name="saddr" SIZE=15> | |
| scity | Ship-To City
Example:
<input name="scity" SIZE=15> |
| sstate | Ship-To State
Example:
<input name="sstate" SIZE=15> |
| szip | Ship-To Zip Code
Example:
<input name="szip" SIZE=15> |
| sctry | Ship-To Country
Example:
<input name="sctry" SIZE=15> |
| 
