Order Form Field FAQ

Q: I'm setting up different styles of order forms and need to know the URL to POST the form.

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">

Q: I'm setting up an order form on my site and I'm wondering if you have a listing of field names that are required and a list of those that are optional.
A: 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:

home_page Your home page URL.
Example:

ret_addr The full URL to which customers are directed after order completion. (This is a page or CGI on your server.)
Examples:

*_desc Description of item #*.
Examples:

*_cost Cost of item #*.
Examples:

*_qty Quantity of item #*.
Examples:

*_anything Any other attribute of the item being ordered. These attributes are optional. Include as many as you'd like.
Examples:

* 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 BuyNow 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:

mername The name of your business. This will appear on the order form on the secure server.
Example:

acceptcards Value must be '1' if you are accepting credit cards.
Example:

acceptchecks Value must be '1' if you are accepting checks.
Example:

accepteft Value must be '1' if you will be accepting EFT transactions.
Example:

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:

nonum Removes the check number field from the BuyNow or SplitForm. (This field is removed automatically if you are accepting EFT payments.)
Example:

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:

Follow this link.

check_num Customer's check number.
Example:

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:

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:

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:

last_name Customer's last name.
Example:

address Customer's address.
Example:

city Customer's city.
Example:

state Customer's state.
Example:

zip Customer's ZIP or postal code.
Example:

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:

phone Customer's phone number.
Example:

email Customer's email address.
Example:

ccnum Credit card number. (If you are accepting credit cards.)
Example:

ccmo Credit card expiration month. (If you are accepting credit cards.)
Example:

ccyr Credit card expiration year. (If you are accepting credit cards.)
Example:

aba Customer's 9-digit bank identification number. (If you are accepting checks.)
Example:

account Customer's checking account number. (If you are accepting checks.)
Example:

The fields listed below are optional and are used to obtain a shipping address:

sfname Ship-To First Name
Example:

slname Ship-To Last Name
Example:

saddr Ship-To Address
Example:

scity Ship-To City
Example:

sstate Ship-To State
Example:

szip Ship-To Zip Code
Example:

sctry Ship-To Country
Example: