Wallet
Implementation
The IntelliPay
wallet feature allows you as the merchant to store customer data
securely within your IntelliPay account. The storage and security
is all provided by IntelliPay which is VISA CISP compliant.
Utilizing the
Wallet feature has many benefits. You can store Name, Address, City,
State, Zip, Country, Phone, Fax, E-Mail address, card number and
expiration date. In addition your customers can update their wallet
information at any time via the IntelliPay website located at: https://www.intellipay.net/Customer/
Adding a new Wallet via HTML form post
Wallet
with Credit Card Information
Below
is the example code that you can use to submit new Wallet data
to your IntelliPay account via HTML code. All the fields listed
below are required in order to successfully add a new wallet.
<Form
method="POST" action="https://www.intellipay.net/LinkSmart/">
<input type="hidden" name="LOGIN" value="Your
Login Name">
<input type="hidden" name="PASSWORD"
value="Your Smart Terminal password">
<input type="hidden" name="USERNAME"
value="desiredusername">
<input type="text" name="CARDNUM" value="4111111111111111">
<input type="text" name="EXPDATE" value="12/08">
<input type="hidden" name="TYPE" value="WL">
<input type="hidden" name="METHOD" value="VI">
<input type="text" name="NAME" value="Example
User">
<input type="text" name="ADDRESS" value="1600
Anywhere Street">
<input type="text" name="CITY" value="Salt
Lake City">
<input type="text" name="REGIONCODE"
value="UT">
<input type="text" name="ZIP" value="84101">
<input type="text" name="COUNTRYCODE"
value="US">
<input type="text" name="PHONE" value="801-578-9020">
<input type="submit" value="Add A New Wallet">
</form>
If you would
like to have the username and password e-mailed to your customer
so they can update their wallet information, you would use the
form above and include the additional field of:
<input
type="hidden" name="EMAILPASSWORD" value="Y">
This would allow the IntelliPay system to autosend the username
and password to the specified email address so the Wallet user
can update their information via the IntelliPay website.
Wallet with Check Information
Below
is the example code that you can use to submit new Wallet data
to your IntelliPay account via HTML code. All the fields listed
below are required in order to successfully add a new wallet.
<Form
method="POST" action="https://www.intellipay.net/LinkSmart/">
<input type="hidden" name="LOGIN" value="Your
Login Name">
<input type="hidden" name="PASSWORD"
value="Your Smart Terminal password">
<input
type="hidden" name="USERNAME" value="desiredusername">
<input type="hidden" name="TYPE" value="WL">
<input type="hidden" name="METHOD" value="CK">
<input type="hidden" name="RECEIPTFORMAT"
value="LinkSmartReceiptPage">
<input type="hidden" name="BANKACCTNUMBER"
value="1234567890">
<input type="hidden" name="ROUTINGABA"
value="123456789">
<input type="hidden" name="BANKACCTTYPE"
value="Checking">
<input type="hidden" name="BANKACCTNAME "
value="Example Local Bank">
<input
type="text" name="NAME" value="Example
User">
<input type="text" name="ADDRESS" value="1600
Anywhere Street">
<input type="text" name="CITY" value="Salt
Lake City">
<input
type="text" name="REGIONCODE" value="UT">
<input
type="text" name="ZIP" value="84101">
<input
type="text" name="COUNTRYCODE" value="US">
<input
type="text" name="PHONE" value="801-578-9020">
<input
type="submit" value="Add A New Wallet">
</form>
If you would
like to have the username and password e-mailed to your customer
so they can update their wallet information, you would use the
form above and include the additional field of:
<input
type="hidden" name="EMAILPASSWORD" value="Y">
This would allow the IntelliPay system to autosend the username
and password to the specified email address so the Wallet user
can update their information via the IntelliPay website.
Edit
an existing Wallet via HTML form post
If
you have already entered Wallet information into your IntelliPay
account and you would like to update that information, then you
would send the standard HTML code from above and include the following
additional field:
<input type="text" name="WALLET" value="XXXX">
HTML
field definitions
| LOGIN |
This
is your IntelliPay login name. |
| |
|
| PASSWORD |
This
is your IntellIPay Smart Terminal password. |
| |
|
| CARDNUM |
The card
number you would like to attach to this customers wallet. |
| |
|
| EXPDATE |
Expiration
date for the credit card. |
| |
|
| BANKACCTNUMBER |
Bank
account number to charge. |
| |
|
| ROUTINGABA |
Bank
routing number. |
| |
|
| BANKACCTTYPE |
Type
of bank account, checking or savings. |
| |
|
| BANKACCTNAME |
Name
of the bank where the account resides. |
| |
|
| USERNAME |
Username
for the new Wallet customer. |
| |
|
| TYPE |
This
is the transaction type. For Wallet transactions it must be
set to WL |
| |
|
| METHOD |
This
is the method of credit card used. You would use the values
of: VI, MC, NO, AX or CK. CK is used for checks. |
| |
|
| NAME |
Wallet
customer name. |
| |
|
| ADDRESS |
Wallet
customer address. |
| |
|
| CITY |
Wallet
customer city. |
| |
|
| STATE |
Wallet
customer state. |
| |
|
| ZIP |
Wallet
customer zipcode. |
| |
|
| COUNTRYCODE |
The country
of the Wallet customer. Use the 2 digit country abbreviation.
Standard is US. |
| |
|
| PHONE |
Wallet
customer phone number. Format of XXX-XXX-XXXX |
| |
|
| WALLET |
This
is the Wallet ID for existing Wallet customers. Replace the
XXXX in the input type value with the customer Wallet ID. |
| |
|
| EMAILPASSWORD |
Instructs
the system to send the Wallet user their username and password. |
Response
to HTML post request
When
you submit your transaction via HTML form post you would receive
a response back from the IntelliPay server. The response would
look like this:
RESPONSECODE=A
AUTHCODE=654321
DECLINEREASON=
AVSDATA=YYX
TRANSID=
WALLET=189F
Adding
a new Wallet via XML request
Wallet
with Credit Card Information
Below
is the example code that you can use to submit new Wallet data
to your IntelliPay account via XML. All the fields listed below
are required in order to successfully add a new wallet.
xmlrequest=<WALLETREQUEST
login="your Login Name" password="your Smart
Terminal password " version="1.0">
<WALLET></WALLET>
<USERNAME>username1</USERNAME>
<RECEIPTFORMAT>XmlReceipt</RECEIPTFORMAT>
<CARDNUM>4111111111111111</CARDNUM>
<EXPDATE>08/08</EXPDATE>
<METHOD>VI</METHOD>
<NAME>Example User</NAME>
<ADDRESS>1600 Anywhere Street</ADDRESS>
<CITY>Salt Lake City</CITY>
<STATE>UT</STATE>
<COUNTRY>US</COUNTRY>
<ZIP>84101</ZIP>
<PHONE>8015789020</PHONE>
<FAX>8015789019</FAX>
<EMAIL>exampleuser@ispemail.com</EMAIL>
</WALLETREQUEST>
If you would
like to have the username and password e-mailed to your customer
so they can update their wallet information, you would use the
XML request above and include the additional field of:
<EMAILPASSWORD>Y</EMAILPASSWORD>
This would allow the IntelliPay system to autosend the username
and password to the specified email address so the Wallet user
can update their information via the IntelliPay website.
Wallet
with Check Information
Below
is the example code that you can use to submit new Wallet data
to your IntelliPay account via XML. All the fields listed below
are required in order to successfully add a new wallet.
xmlrequest=<WALLETREQUEST
login="your Login Name" password="your Smart
Terminal password " version="1.0">
<WALLET></WALLET>
<USERNAME>username1</USERNAME>
<RECEIPTFORMAT>XmlReceipt</RECEIPTFORMAT>
<BANKACCTNUMBER>1234567890</BANKACCTNUMBER>
<ROUTINGABA>123456789</ROUTINGABA>
<BANKACCTTYPE>Checking</BANKACCTTYPE>
<BANKACCTNAME>Example Local Bank</BANKACCTNAME>
<METHOD>CK</METHOD>
<NAME>Example User</NAME>
<ADDRESS>1600 Anywhere Street</ADDRESS>
<CITY>Salt Lake City</CITY>
<STATE>UT</STATE>
<COUNTRY>US</COUNTRY>
<ZIP>84101</ZIP>
<PHONE>8015789020</PHONE>
<FAX>8015789019</FAX>
<EMAIL>exampleuser@ispemail.com</EMAIL>
</WALLETREQUEST>
If you would
like to have the username and password e-mailed to your customer
so they can update their wallet information, you would use the
XML request above and include the additional field of:
<EMAILPASSWORD>Y</EMAILPASSWORD>
This would allow the IntelliPay system to autosend the username
and password to the specified email address so the Wallet user
can update their information via the IntelliPay website.
Edit
an existing Wallet via XML request
If
you have already entered Wallet information into your IntelliPay
account and you would like to update that information, then you
would send the XML request from above and include the following
additional field:
<WALLET>XXXX</WALLET>
When
you place a value between the <WALLET> variable that indicates
to the IntelliPay system that it is an existing wallet and that
the information needs to be updated.
XML
field definitions
| LOGIN |
This
is your IntelliPay login name. |
| |
|
| PASSWORD |
This
is your IntellIPay Smart Terminal password. |
| |
|
| <WALLET></WALLET> |
This
is the wallet ID. If this is a new Wallet leave the value
blank. If you are editing a existing Wallet enter the Wallet
ID instead of XXXX in the request line. |
| |
|
| <USERNAME>username1</USERNAME> |
This
is the username that you would like to set for the Wallet
customer. This is used when the customer updates their information
through the IntelliPay website. |
| |
|
| <RECEIPTFORMAT>XmlReceipt</RECEIPTFORMAT> |
This
is the format of the response code that you will receive back.
You would want to use XmlReceipt |
| |
|
| <CARDNUM>4111111111111111</CARDNUM> |
This
is the field that contains the Wallet customer card number. |
| |
|
| <EXPDATE>08/08</EXPDATE> |
Wallet
customer credit card expiration date. |
| |
|
| <BANKACCTNUMBER>1234567890</BANKACCTNUMBER> |
Checking
account number. |
| |
|
| <ROUTINGABA>123456789</ROUTINGABA> |
Bank
routing number. |
| |
|
| <BANKACCTTYPE>Checking</BANKACCTTYPE> |
Type
of account: Checking or Savings |
| |
|
| <BANKACCTNAME>Bank
Name</BANKACCTNAME> |
Name
of the bank. |
| |
|
| <METHOD>VI</METHOD> |
This
is the method of credit card used.You would use the values
of: VI, MC, NO, AX or CK. CK is used for Checks. |
| |
|
| <NAME>Example
User</NAME> |
Wallet
customer name. |
| |
|
| <ADDRESS>1600
Anywhere Street</ADDRESS> |
Wallet
customer address. |
| |
|
| <CITY>Salt
Lake City</CITY> |
Wallet
customer city. |
| |
|
| <STATE>UT</STATE> |
Wallet
customer state. |
| |
|
| <ZIP>84101</ZIP> |
Wallet
customer zipcode. |
| |
|
| <PHONE>8015789020</PHONE> |
Wallet
customer phone number. Format of XXX-XXX-XXXX |
| |
|
| <FAX>8015789019</FAX> |
Wallet
customer fax number. |
| |
|
| <EMAIL>exampleuser@ispemail.com</EMAIL> |
Wallet
customer e-mail address. The username and password will be
emailed to the customer if you also send the EMAILPASSWORD
field below. |
| |
|
| <EMAILPASSWORD>Y</EMAILPASSWORD> |
Instructs
the system to send the Wallet user their username and password. |
Response
to XML request
When
you submit your transaction via XML request you would receive
a response back from the IntelliPay server. The response would
look like this:
<WALLETRESPONSE
version="1.0">
<RESPONSECODE>A</RESPONSECODE>
<AUTHCODE>654321</AUTHCODE><DECLINEREASON>
</DECLINEREASON><AVSDATA>YYX</AVSDATA><TRANSID>
</TRANSID><WALLET>189F</WALLET></WALLETRESPONSE>
Submitting
a transaction via HTML form post, using Wallet information
To charge
the credit card for a specific Wallet customer you would need
to use the following example code:
<Form
method="POST" action="https://www.intellipay.net/LinkSmart/">
<input type="hidden" name="LOGIN" value="your
login name">
<input type="hidden" name="PASSWORD"
value="your Smart Terminal password">
<input type="hidden" name="USERNAME"
value="XXXX">
<input type="hidden" name="TYPE" value="NA">
<input type="hidden" name="WALLET" value="XXXX">
<input type="hidden" name="RECEIPTFORMAT"
value="XmlReceipt">
<input type="hidden" name="INVOICE" value="111222">
<input type="hidden" name="AMOUNT" value="1.00">
<input type="hidden" name="DESCRIPTION"
value="Example Order">
<input type="hidden" name="CUSTID" value="00361">
<input type="submit" value="Submit Transaction">
</form>
Since the
Wallet already contains the card information as well as the customer
address and contact info, you would not need to send those values
via your HTML form post when you submit the transaction for processing.
Submitting
a transaction via XML request, using Wallet information
xmlrequest=<PURCHASEREQUEST
login="your Login Name" password="your Smart
Terminal password " version="1.0">
<WALLET>XXXX</WALLET>
<USERNAME>username1</USERNAME>
<RECEIPTFORMAT>XmlReceipt</RECEIPTFORMAT>
<TYPE>NA</TYPE>
<INVOICE>111222</INVOICE>
<AMOUNT>1.00</INVOICE>
<DESCRIPTION>Example Order</DESCRIPTION>
<CUSTID>00361</CUSTID>
</PURCHASEREQUEST>
Since
the Wallet already contains the card information as well as the
customer address and contact info, you would not need to send
those values via XML request when you submit the transaction for
processing.
Back
to Top of Page+
|
