| Products
String
In the Easy Setup section, we showed you two methods of passing a Products
string. The Quantity method and the Products string requires InternetSecure
to host your database. This is fine until you have a product list that is already
database driven, or dynamic in that it may change daily. This can become difficult and
unwieldy to manage as a database hosted on InternetSecure. Recognizing this, we offer
a third method of passing through products to the processing system. This is the
full Products string method. It requires that you build the product string on
your site, and pass that information to InternetSecure in a properly formatted
text string. This string must be formatted precisely, or the purchase
will not work. Generally the Products string is generated with a Perl, C, Java, ASP, or
through any another scripting language.
The Products string is similar to the one mentioned in the first section.
The difference is that each item in the record is delimited by a double colon (::), and each record
is delimited by a bar and instead of two fields as in the Easy method, now we are
working with 5 fields. They are the Price, Quantity, Code, Description and Flags
fields. The
first record can be the 'Defining' record, meaning simply that you can define what you are calling
each field. The order that they are read is still Price, Quantity, Code, Description
and Flags.
Example:
<input type=hidden name="Products" value="Price::Qty::Code::Description::Flags">
<input type=hidden name="Products" value="9.99::1::
001::T-Shirt::{GST}{PST}{US}{TEST}{TESTD}">
As far as how to build the string, that is up to you. You must do the programming for that yourself. If you feel that this is the method that you require, but do not have the resources
or skills available to produce the necessary code, please talk to our Merchant Service staff for recommendations, or
email service@internetsecure.com
Listed below are the fields for the Products string and what each should/can contain.
- Price:
the price of the product WITHOUT a dollar sign symbol.
Correct: 19.95
Incorrect: $19.95 - this field can contain only the numbers 1-9 and a '.' (period). Any other symbols in
this field will cause an error.
- Quantity:
the quantity purchased.
- Code:
the product code of the item being purchased.
- Description:
the description of the item(s) being purchsed. This field cannot contain
any quotes("), backticks(`) or colons(:).
- Flags:
this field contains all the tax, and
recurring billing information (see the 'Other Features and Support'
section for more information on recurring billing). The flags field also
contains the {US} indicator if the transaction is to
occur in US Dollars The last two flags are for test purposes. The
{TEST} flag indicates this transaction is a test
and no money will be exchanged well using this flag. In can also be used
after your account has been activated for further
testing. {TESTD} is to test the results of a
declined transaction. This too can be used after your account has
been activated.
Note: The currly braces are not optional and must be
included or the flag will not be picked up.
After taking all this into account, the Products string should look something similar to the one
below. Of course the method of passing the information to InternetSecure will vary, but the below
example is of a string built and passed through a form.
<input type=hidden name="Products" value="Price::Qty::Code::Desciption::Flags|9.95::1::T001::Extra Large
Green Internetsecure T-shirt.::{GST}{PST}{HST}{US}|10.00::1::shp::Overnight Shipping::{GST}{PST}{HST}{US}>
For more information
on the advanced product string method, please contact our Merchant Service staff or email
service@internetsecure.com
|
