|
 Export
Scripts
InternetSecure has the unique ability to interact with your
products and your solutions. One method of doing this is through a Export Script. Upon a
credit card transaction, a script, written by you, is run. This script is run
from YOUR server, and must be accessible via a
web browser
.
Without getting too technical, the order of operations for a transaction with
the export script as follows:
- The customer submits the
credit card information, and the InternetSecure server sends off the
information to the issuing bank for verification.
- Upon receiving an approval
code for the transaction, InternetSecure sends out their own TEXT based
browser in the background, meaning that the customer never leaves the
InternetSecure page. This browser has the ability to pass what ever
information you require and pass it to the page that you request.
This includes all of your own custom variables. The only exception
is InternetSecure does not pass Credit Card numbers or Expiry Date.
- The 'Browser' waits for a
completed signal, and the regular transaction process completes.
Note: Retrieving this information works exactly like a standard form post. Here is an example in ASP:
lcustomername = request.form("xxxName")
This allows you to do a multitude of things, from generating a passcode and emailing it to the
customer in real time, to adjusting inventory in real time. The script can do anything that you
require it to do, but must be hosted and programmed by you. InternetSecure will not provide
technical support for scripts not programmed inhouse.
With the post-approval script, our system is setup to call your page and dump specific variables to that page,
so that they can be used by your system to update your product database, for example. Here is the list
of all the variables passed to a generic export script:
| Variable Name | Description |
| xxxName | Customer's full
name |
| xxxCompany | Customer
company |
| xxxAddress | Customer's street
address |
| xxxCity | Customer's
city |
| xxxProvince | Customer's
province |
| xxxCountry | Customer's
country |
| xxxPostal | Customer's postal
code |
| xxxEmail | Customer's email
address |
| xxxPhone | Customer's phone
number |
| xxxCCType | Customer's credit card
type (Visa, MasterCard, Amex) |
| ApprovalCode | Bank approval code for
this transaction |
| xxxcard_name | Cardholder's name on
credit card |
| KeySize | Size of the SSL cipher key
being used by customer |
| SecretKeySize | Secret size of the SSL
cipher key being used by customer |
| UserAgent | The browser type that the
customer used |
| EntryTimeStamp | The date and time the
customer first entered the InternetSecure system. (Unix format - see
below) |
| UnixTimeStamp | The date and time the
customer submitted the transaction for processing. (Unix format -
see below) |
| TimeStamp | The date and time the
customer submitted the transaction for processing. (Format -
mm/dd/yyyy hh:mm:dd) |
| Live | Indicated whether the
transaction was real (1) or a test (0) |
| Language | The language used to
display the transaction pages |
| Currency | The currency used to
process the transactions |
| Amount | Dollar amount of the
transaction |
| receiptnumber | InternetSecure receipt
number. Unique to each transaction. |
| Verbage | Verbage sent back by the
processor |
| NiceVerbage | Plain english version of
the verbage |
| SalesOrderNumber | Sales order number of
transaction. Unique to each merchant. Increments one for each
transaction. |
| RefererURL | The URL of the page that
sent the customer to InternetSecure |
| ip_address | The IP address of the
customer's computer |
| MerchantNumber | InternetSecure merchant
number of this transaction |
| ReturnURL | The ReturnURL variable
passed by the merchant |
| ReturnCGI | The ReturnCGI variable
passed by the merchant |
| Products | The Products string, as
passed by the merchant |
| DoubleColonProducts | The Products string,
converted to Double Colon format |
| While there are
other variable names being passed, only the variables listed here
are guarenteed to always be passed. |
Unix time is the number of seconds since Jan 1, 1970 00:00:00AM GMT. For example, the Unix time '907599556', is Oct 6 14:49:13 1998 EST.
Here is an example
of the values that are passed to a generic export script:
MerchantNumber=4
xxxName=Carlo
xxxCompany=InternetSecure Inc.
xxxAddress=1040 South Service Road East, Suite 200
xxxCity=Oakville
xxxProvince=ON
xxxPostal=L6J 2X7
xxxCountry=CA
xxxPhone=(905)338-2929
xxxEmail=support@internetsecure.com
xxxCCType= Visa
ApprovalCode=000000
xxxcard_name=James
KeySize=128
SecretKeySize=128
UserAgent=Mozilla/3.04(Win95; U)
EntryTimeStamp=907781640
UnixTimeStamp=907784195
TimeStamp=10/07/199814:16:35
Live=0
Language=english
Currency=0
Amount=9.99
receiptnumber=907784192.5855
Verbage= AP/AP/Approved
NiceVerbage=Approved
SalesOrderNumber=514
RefererURL=http://www.ismerchant.com/form.html
ip_address=192.168.1.1
ReturnURL=http://www.ismerchant.com/thankyou.html
ReturnCGI=
Products=001,1
DoubleColonProducts=Price::Qty::Code::Description::Flags|9.95::1::test::test
product::
For more
information about the Export Script please call our
Merchant Service Staff or email
service@InternetSecure.com
|
