Payment Types

"...installs on virtually any shared hosting account WITHOUT Telnet, WITHOUT C libraries and WITHOUT system access..."

Home

Buy Now

Support Desk

Testimonials

Common Processor Settings

Information on integrating SurfShopPRO™ with several popular bank processors is listed below for easy cutting and pasting.

We have outlined the values you need to enter in the HTML "Check Out" form for your Check-Out HTML Settings. We have attempted to make it as easy and universal as possible, however we cannot give pre-configured instructions for every possible combination of server, processor and web page. Some modifications may be necessary.

Some of the processors allow you to customize your currency type. In these examples, all currency is specified as US Dollars ("USD").

In order to test your configurations, it may be necessary to enter test values in these forms. In some cases, the URL for the test mode is different than that of the live mode. Check with your processor for the specifics on testing your site.

Note: This information is subject to change at any time. Consult with your payment processor for up-to-date technical information and specifications.

• Also, some of the coding below may not have been translated properly by your browser. First, paste the code into a text editor (not a word processor), then copy from there and paste into SurfShopPRO™PRO. Always back up before replacing your code with the code below.

Generic ECML

Between 1999 and 2001, the Internet Community attempted to move toward a standard for e-commerce configurations, called ECML, or Electronic Commerce Markup Language. While many of the previous bank processors do not use the ECML standard, we still support it. The code below should allow you to interface with any of these "generic" ECML processors.

autoconfig.cgi Settings
Cardservice Domain	[depends on processor]
Transaction Result	IOC_response_code
Approved Value	0
Declined Value	2
Declined Message	IOC_reject_description
AVS	IOC_AVS_result
Authorization Code	[none]
Reference Number	[none]

Check Out HTML

PayPal (WebAccept)

PayPal does not pass any values back to SurfShopPRO™. For this reason, all of the values must be encoded in the ?return URL." PayPal uses a different tag for approved and declined transactions. The Transaction Result field and its Approved and Declined values are SurfShopPRO's values, not PayPal's.

autoconfig.cgi Settings
Cardservice Domain	www.paypal.com
Transaction Result	status
Approved Value	Approved
Declined Value	Declined
Declined Message	[none]
AVS	[none]
Authorization Code	[none]
Reference Number	[none]

Check Out HTML

<form action="https://www.paypal.com/cgi-bin/webscr" method="post"> <font face="Arial, Helvetica, sans-serif"> Check out using PayPal® <br> by clicking the PayPal® button!</font><br> <input type="hidden" name="cancel_return" value="<! secure>?storeid=<! storeid>&<! ss_appfield>=<! ss_declined>&c=sorry.htm&ud=<! ud>"> <input type="hidden" name="business" value="sales@surfshopcart.com"> <input type="hidden" name="return" value="<! secure>?ud=<! ud>&<! ss_appfield>=<! ss_approved>&c=receipt.htm&storeid=<! storeid>&key=<! key>"> <input type="hidden" name="amount" value="<! USD_chargetotal>"> <input type="hidden" name="item_name" value="SurfShopCart Order <! orderid>"> <input type="hidden" name="cmd" value="_ext-enter"> <input type="hidden" name="redirect_cmd" value="_xclick"> <input type="image" src="https://www.paypal.com/images/x-click-but1.gif" name="submit" alt="Make payments with PayPal - it's fast, free and secure!" width="72" height="29" border=0> </form>

AuthorizeNet

This processor requires a special login field, "x_Login" to be provided by the merchant. In addition, you will need to configure your account using the AuthorizeNet administration website.

autoconfig.cgi Settings
Cardservice Domain	secure.authorize.net
Transaction Result	x_response_code
Approved Value	1
Declined Value	2
Declined Message	x_response_reason_text
AVS	x_avs_code
Authorization Code	x_auth_code
Reference Number	x_Cust_ID

Check Out HTML - Credit Card

<form method="post" action="https://secure.authorize.net/gateway/transact.dll"> <input type=HIDDEN name="x_Version" value="3.0"> <input type=HIDDEN name="x_Login" value="--ENTER YOUR LOGIN ID HERE--"> <input type=HIDDEN name="x_Amount" value="<! USD_chargetotal>"> <input type=HIDDEN name="x_Cust_ID" value="<! user_uid>"> <input type=HIDDEN name="x_Description" value="<! YourCompany> Invoice <! orderid>"> <input type=HIDDEN name="x_Invoice_Num" value="<! orderid>"> <input type=hidden name="x_First_Name" value="<! Ecom_BillTo_Postal_Name_First>"> <input type=hidden name="x_Last_Name" value="<! Ecom_BillTo_Postal_Name_Last>"> <input type=HIDDEN name="x_City" value="<! Ecom_BillTo_Postal_City>"> <input type=HIDDEN name="x_State" value="<! Ecom_BillTo_Postal_StateProv>"> <input type=HIDDEN name="x_Zip" value="<! Ecom_BillTo_Postal_PostalCode>"> <input type=HIDDEN name="x_Country" value="<! Ecom_BillTo_Postal_CountryCode>"> <input type=HIDDEN name="x_Address" value="<! Ecom_BillTo_Postal_Street_Line1>"> <input type=HIDDEN name="x_Email" value="<! Ecom_BillTo_Online_Email>"> <input type=HIDDEN name="x_Phone" value="<! Ecom_BillTo_Telecom_Phone_Number>"> <input type=HIDDEN name="x_Card_Num" value="<! Ecom_Payment_Card_Number>"> <input type=HIDDEN name="x_Exp_Date" value="<! Ecom_Payment_Card_MoYr>"> <input type=HIDDEN name="x_Receipt_Link_URL" value="<! secure>?storeid=<! storeid>&c=receipt.htm&ud=<! ud>&key=<! key>"> <input type=HIDDEN name="x_Receipt_Link_Method" value="Post"> <input type=HIDDEN name="x_Receipt_Link_Text" value="Click Here to Continue">  <input type=hidden name="x_Test_Request" value="TRUE">  <input type=submit value="Check Out" name="submit2"> </form>

Check Out HTML - E-Check

<form method="post" action="https://secure.authorize.net/gateway/transact.dll"> <input type=HIDDEN name="x_Version" value="3.0"> <input type=HIDDEN name="x_Login" value="--ENTER YOUR LOGIN ID HERE--"> <input type=HIDDEN name="x_Amount" value="<! USD_chargetotal>"> <input type=HIDDEN name="x_Cust_ID" value="<! user_uid>"> <input type=HIDDEN name="x_Description" value="<! YourCompany> Invoice <! orderid>"> <input type=HIDDEN name="x_Invoice_Num" value="<! orderid>"> <input type=hidden name="x_First_Name" value="<! Ecom_BillTo_Postal_Name_First>"> <input type=hidden name="x_Last_Name" value="<! Ecom_BillTo_Postal_Name_Last>"> <input type=HIDDEN name="x_City" value="<! Ecom_BillTo_Postal_City>"> <input type=HIDDEN name="x_State" value="<! Ecom_BillTo_Postal_StateProv>"> <input type=HIDDEN name="x_Zip" value="<! Ecom_BillTo_Postal_PostalCode>"> <input type=HIDDEN name="x_Country" value="<! Ecom_BillTo_Postal_CountryCode>"> <input type=text name="x_Bank_ABA_Code" value="<! Ecom_Payment_Check_TransitNum>"> <input type=text name="x_Bank_Acct_Num" value="<! Ecom_Payment_Check_AcctNum>"> <input type=HIDDEN name="x_Method" value="ECHECK"> <input type=HIDDEN name="x_Receipt_Link_URL" value="<! secure>?storeid=<! storeid>&c=receipt.htm&ud=<! ud>&key=<! key>"> <input type=HIDDEN name="x_Receipt_Link_Method" value="Post"> <input type=HIDDEN name="x_Receipt_Link_Text" value="Click Here to Continue">  <input type=hidden name="x_Test_Request" value="TRUE">  <input type=submit value="Check Out" name="submit2"> </form>

LinkPoint

LinkPoint allows you to specify certain fields that are "passed through" the transaction. You must include the following fields:

c
storeid
ud
key

autoconfig.cgi Settings
Cardservice Domain	secure.linkpt.net
Transaction Result	status
Approved Value	Approved
Declined Value	Declined
Declined Message	[none]
AVS	[none]
Authorization Code	[none]
Reference Number	[none]

Check Out HTML

<form method="post" action="https://secure.linkpt.net/cgi-bin/hlppay" name="PaymentInfo"> <input type=hidden name="c" value="receipt.htm"> <input type="hidden" name="bname" value="<! Ecom_BillTo_Postal_Name_First> <! Ecom_BillTo_Postal_Name_Last>"> <input type="hidden" name="baddr1" value="<! Ecom_BillTo_Postal_Street_Line1>"> <input type="hidden" name="bstate" value="<! Ecom_BillTo_Postal_StateProv>"> <input type="hidden" name="bstate2" value="<! bprovince>"> <input type="hidden" name="bcity" value="<! Ecom_BillTo_Postal_City>"> <input type="hidden" name="bzip" value="<! Ecom_BillTo_Postal_PostalCode>"> <input type="hidden" name="bcountry" value="<! Ecom_BillTo_Postal_CountryCode>"> <input type="hidden" name="email" value="<! Ecom_BillTo_Online_Email>"> <input type="hidden" name="oid" value="<! orderid>"> <input type="hidden" name="mode" value="payplus"> <input type="hidden" name="chargetotal" value="<! USD_chargetotal>"> <input type="hidden" name="storename" value=""> <input type="hidden" name="key" value="<! key>"> <input type="hidden" name="storeid" value="<! storeid>"> <input type="hidden" name="2000" value="Submit"> <table border=0 cellpadding=1 cellspacing=2 width=100%> <tr> <td align=right width="20%"> Card Type: </td> <td width="40%"> <div align="left"> <select name="cctype"> <option value="V" selected>Visa</option> <option value="M">Mastercard</option> <option value="A">American Express</option> <option value="D">Discover</option> </select> </div> </td> <td width="40%"> <div align="left">Verification Code </div> </td> </tr> <tr> <td align=right width="20%"> Card Number: </td> <td> <div align="left"> <input name="cardnumber" size=28 maxlength=16> </div> </td> <td width="40%"> <div align="left"> <input name="cvm" size=6 maxlength=4> </div> </td> </tr> <tr> <td align=right width="20%">Expiration Date</td> <td> <select name="expmonth"> <option value="1">Jan </option> <option value="2">Feb </option> <option value="3">Mar </option> <option value="4">Apr </option> <option value="5">May </option> <option value="6">Jun </option> <option value="7">Jul </option> <option value="8">Aug </option> <option value="9">Sep </option> <option value="10">Oct </option> <option value="11">Nov </option> <option value="12">Dec </option> </select> / <select name="expyear"> <option value="2002">2002 </option> <option value="2003">2003</option> <option value="2004">2004</option> <option value="2005">2005</option> </select> </td> <td width="40%"> <input type="submit" name="Submit" value="Check Out!"> </td> </tr> </table> </form>

MerchantAnywhere
(Transaction Central)

This processor does not allow for fields to be "passed through," so the "RefNo" parameter is used to send the customer's unique ID.

autoconfig.cgi Settings
Cardservice Domain	www.oc2net.net
Transaction Result	Auth
Approved Value	\w\w\w\w
Declined Value	Declined
Declined Message	[none]
AVS	[none]
Authorization Code	TransID
Reference No.	RefNo

Check Out HTML

EFTSecure

This processor requires a Merchant ID and a Merchant Key to be provided by the merchant. Additional configuration may be necessary using the administration website.

autoconfig.cgi Settings
Cardservice Domain	va.eftsecure.net
Transaction Result	APPROVED
Approved Value	Y
Declined Value	N
Declined Message	MSG
AVS	AVS_MSG
Authorization Code	CODE
Reference No.	[none]

Check Out HTML - Credit Card

<form name="checkout" method="post" target="_top" action="https://va.eftsecure.net/cgi-bin/transact.dll?creditcard"> <input type=hidden name="M_id" value="--ENTER MERCHANT ID HERE--"> <input type=hidden name="M_key" value="--ENTER MERCHANT KEY HERE--"> <input type=hidden name="M_returnurl" value="<! secure>?storeid=<! storeid>&c=receipt.htm&ud=<! ud>&key=<! key>"> <input type=hidden name="C_name" value="<! Ecom_Payment_Card_Name>"> <input type=hidden name="C_address" value="<! Ecom_BillTo_Postal_Street_Line1> <! Ecom_BillTo_Postal_Street_Line2>"> <input type=hidden name="C_city" value="<! Ecom_BillTo_Postal_City>"> <input type=hidden name="C_state" value="<! Ecom_BillTo_Postal_StateProv>"> <input type=hidden name="C_zip" value="<! Ecom_BillTo_Postal_PostalCode>"> <input type=hidden name="C_email" value="<! Ecom_BillTo_Online_Email>"> <input type=hidden name="T_amt" value="<! USD_chargetotal>"> <input type=hidden name="T_code" value="01"> <input type=hidden name="C_cardnumber" value="<! Ecom_Payment_Card_Number>"> <input type=hidden name="C_exp" value="<! Ecom_Payment_Card_ExpDate_MoYr"> <input type=submit name="submitform" value=" Place Order "> </form>

Check Out HTML - Check

<form name="checkout" method="post" target="_top" action="https://va.eftsecure.net/cgi-bin/transact.dll?creditcard"> <input type=hidden name="M_id" value="--ENTER EFT SECURE MERCHANT ID HERE--"> <input type=hidden name="M_key" value="--ENTER EFT SECURE MERCHANT KEY HERE--"> <input type=hidden name="M_returnurl" value="<! secure>?storeid=<! storeid>&c=receipt.htm&ud=<! ud>&key=<! key>"> <input type=hidden name="C_name" value="<! Ecom_BillTo_Postal_Name_First> <! Ecom_BillTo_Postal_Name_Last>"> <input type=hidden name="C_address" value="<! Ecom_BillTo_Postal_Street_Line1> <! Ecom_BillTo_Postal_Street_Line2>"> <input type=hidden name="C_city" value="<! Ecom_BillTo_Postal_City>"> <input type=hidden name="C_state" value="<! Ecom_BillTo_Postal_StateProv>"> <input type=hidden name="C_zip" value="<! Ecom_BillTo_Postal_PostalCode>"> <input type=hidden name="C_email" value="<! Ecom_BillTo_Online_Email>"> <input type=hidden name="T_amt" value="<! USD_chargetotal>"> <input type=hidden name="T_code" value="01"> Routing No. <input type=text name="C_rte" value="" size=20> Acct. No. <input type=text name="C_account" value="" size=20> <input type=hidden name="C_accounttype" value="DDA"> <input type=hidden name="C_customertype" value="PPD"> <input type=submit name="submitform" value=" Place Order "> </form>

WorldPay

This processor requires an account number to be passed in the "instId" field.

autoconfig.cgi Settings
Cardservice Domain	select.worldpay.com
Transaction Result	STATUS
Approved Value	Y
Declined Value	C
Declined Message	[none]
AVS	[none]
Authorization Code	authno
Reference No.	[none]

Check Out HTML

<form name="checkout" method="post" target="_top" action="https://select.worldpay.com/wcc/purchase">
<input type=hidden name="instId" value="--ENTER WORLDPAY ID HERE--">
<input type=hidden name="cartId" value="<! orderid>">
<input type=hidden name="amount" value="<! USD_chargetotal>">
<input type=hidden name="currency" value="USD">
<input type=hidden name="desc" value="">
<input type=hidden name="testMode" value="0">
<input type=hidden name="name" value="<! Ecom_BillTo_Postal_Name_First> <! Ecom_BillTo_Postal_Name_Last>">
<input type=hidden name="address" value="<! Ecom_BillTo_Postal_Street_Line1>
<! Ecom_BillTo_Postal_Street_Line2>
<! Ecom_BillTo_Postal_City>
<! Ecom_BillTo_Postal_StateProv>">
<input type=hidden name="postcode" value="<! Ecom_BillTo_Postal_PostalCode>">
<input type=hidden name="country" value="<! Ecom_BillTo_Postal_CountryCode>">
<input type=hidden name="email" value="<! Ecom_BillTo_Online_Email>">
<input type=hidden name="M_url" value="<! secure>?storeid=<! storeid>&c=receipt.htm&ud=<! ud>&key=<! key>">
<input type=hidden name="tel" value="<! Ecom_BillTo_Telecom_Phone_Number>">
<input type=submit name="submitform" value=" Place Order ">

</form>

VeriSign PayFlow

VeriSign requires both a LOGIN and a PARTNER code.

autoconfig.cgi Settings
Cardservice Domain	payflowlink.verisign.com
Transaction Result	RESULT
Approved Value	0
Declined Value	12
Declined Message	RESPMSG
AVS	AVSDATA
Authorization Code	AUTHCODE
Reference No.	[none]

Check Out HTML - Credit Card

Check Out HTML - E-Check

<form name="checkout" method="post" target="_top" action="https://payflowlink.verisign.com/payflowlink.cfm">
Routing No. 
<input type=text name="MICR" value="" size=20>
<br>
Acct. No. 
<input type=text name="CHECKNUM" value="" size=20>
<br>
Drivers Licence No. 
<input type=text name="DLNUM" value="" size=20>
<br>
Drivers Licence State 
<input type=text name="STATEOFDL" value="" size=3 maxchar=2>
<input type=hidden name="TYPEOFCHECK" value="P">
<input type=hidden name="PARTNER" value="--ENTER VERISIGN PARTNER HERE--">
<input type=hidden name="LOGIN" value=""--ENTER VERISIGN LOGIN HERE--"">
<input type=hidden name="AMOUNT" value="<! USD_chargetotal>">
<input type=hidden name="TYPE" value="S">
<input type=hidden name="NAME" value="<! Ecom_BillTo_Postal_Name_First> <! Ecom_BillTo_Postal_Name_Last>">
<input type=hidden name="ADDRESS" value="<! Ecom_BillTo_Postal_Street_Line1> <! Ecom_BillTo_Postal_Street_Line2>">
<input type=hidden name="CITY" value="<! Ecom_BillTo_Postal_City>">
<input type=hidden name="STATE" value="<! Ecom_BillTo_Postal_StateProv>">
<input type=hidden name="ZIP" value="<! Ecom_BillTo_Postal_PostalCode>">
<input type=hidden name="COUNTRY" value="<! Ecom_BillTo_Postal_CountryCode>">
<input type=hidden name="PHONE" value="<! Ecom_BillTo_Telecom_Phone_Number>">
<input type=hidden name="EMAIL" value="<! Ecom_BillTo_Online_Email>">
<input type=hidden name="CUSTID" value="<! orderid>">
<input type=hidden name="ECHODATA" value="True">
<input type=hidden name="ORDERFORM" value="False">
<input type=hidden name="SHOWCONFIRM" value="False">
<input type=hidden name="METHOD" value="ECHECK">
<input type=submit name="submitform" value=" Place Order ">
</form>

FirstVirtual

This processor requires a Merchant PIN and IPS number to be passed in the form. In addition, it requires the customer to provide a PIN number for the transaction. FirstVirtual does not pass any values back to SurfShopPRO™ . For this reason, all of the values must be encoded in the "return URL." The Transaction Result field and its Approved and Declined values are SurfShopPRO's values, not FirstVirtual's.

autoconfig.cgi Settings
Cardservice Domain	www.fv.com
Transaction Result	status
Approved Value	Approved
Declined Value	Declined
Declined Message	[none]
AVS	[none]
Authorization Code	[none]
Reference No.	[none]

Check Out HTML

<form name="checkout" method="post" target="_top" action="http://www.fv.com/fv/aab">
FV PIN No. 
<input type=text name="x-vpin" value="" size=30>
<input type=hidden name="x-full-name" value="<! Ecom_BillTo_Postal_Name_First> <! Ecom_BillTo_Postal_Name_Last>">
<input type=hidden name="x-street-address" value="<! Ecom_BillTo_Postal_Street_Line1>">
<input type=hidden name="x-street-address-2" value="<! Ecom_BillTo_Postal_Street_Line2>">
<input type=hidden name="x-city" value="<! Ecom_BillTo_Postal_City>">
<input type=hidden name="x-state" value="<! Ecom_BillTo_Postal_StateProv>">
<input type=hidden name="x-postal-code" value="<! Ecom_BillTo_Postal_PostalCode>">
<input type=hidden name="x-country" value="<! Ecom_BillTo_Postal_CountryCode>">
<input type=hidden name="x-email-address" value="<! Ecom_BillTo_Online_Email>">
<input type=hidden name="x-phone-number" value="<! Ecom_BillTo_Telecom_Phone_Number>">
<input type=hidden name="x-inv-number" value="<! orderid>">
<input type=hidden name="x-amount" value="<! USD_chargetotal>">
<input type=hidden name="x-currency" value="USD">
<input type=hidden name="x-description" value="<! YourCompany> purchase">
<input type=hidden name="fv-human-email" value="<! YourMail>">
<input type=hidden name="fv-url" value="<! secure>?storeid=<! storeid>&<! ss_appfield>=<! ss_approved>&c=receipt.htm&ud=<! ud>&key=<! key>">
<input type=hidden name="fv-seller" value="--ENTER MERCHANT FV PIN HERE--">
<input type=hidden name="fv-ips" value="--ENTER MERCHANT FV IPS NO HERE--">
<input type=hidden name="fv-notification-cc" value="<! YourMail>">
<input type=submit name="submitform" value=" Place Order ">
</form>

MerchantTrust/ECX

These processors use the same architecture to process transactions. The only difference is the name of the ID field and the URL used to call the processor.

autoconfig.cgi Settings
Cardservice Domain	trans.quickcommerce.com (ECX) trans.atsbank.com (MerchantTrust)
Transaction Result	STATUS
Approved Value	accepted
Declined Value	declined
Declined Message	REASON
AVS	[none]
Authorization Code	AUTHNO
Reference No.	[none]

Check Out HTML - Credit Card

<form name="checkout" method="post" target="_top" action="https://trans.quickcommerce.com/cgi-bin/trans.cgi">
 
<input type=hidden name="action" value="ns_quicksale_cc">
<input type=hidden name="ccname" value="<! Ecom_Payment_Card_Name>">
<input type=hidden name="ccnum" value="<! Ecom_Payment_Card_Number>" size="20" maxlength="19">
<input type=hidden name="Expmon" value="<! Ecom_Payment_Card_ExpDate_Month>" size="3" maxlength="2">
<input type=hidden name="Expyear" value="<! Ecom_Payment_Card_ExpDate_Year>" size="6" maxlength="4">
<input type=hidden name="Ecxid" value="--ENTER ID VALUE HERE--">
 
<input type=hidden name="Amount" value="<! USD_chargetotal>">
<input type="hidden" name="Accepturl" value="<! secure>?storeid=<! storeid>&c=receipt.htm&ud=<! ud>&key=<! key>">
<input type="hidden" name="Declineurl" value="<! secure>?storeid=<! storeid>&c=sorry.htm&ud=<! ud>">
<input type=hidden name="ci_companyname" value="<! YourCompany>">
<input type=hidden name="ci_memo" value="<! YourCompany> Invoice <! orderid>">
<input type=hidden name="emailto" value="Ecom_BillTo_Online_Email">
<input type=hidden name="emailfro" value="<! YourMail>">
<input type=hidden name="emailsubject" value="Payment Processing Receipt for <! YourCompany> Invoice <! orderid>">
<input type=submit name="submitform" value=" Place Order ">
</form>

Check Out HTML - Check

<form name="checkout" method="post" target="_top" action="https://trans.quickcommerce.com/cgi-bin/trans.cgi">
Checking ABA No. 
<input type=type name="ckaba" value="" size=20>
<br>
Checking Acct. No. 
<input type=type name="ckacct" value="" size=20>
 
<input type=hidden name="action" value="ns_quicksale_check">
<input type=hidden name="ckname"	value="<! Ecom_BillTo_Postal_Name_First> <! Ecom_BillTo_Postal_Name_Last>">
<input type=hidden name="Ecxid" value="--ENTER ID VALUE HERE--">
 
<input type=hidden name="Amount" value="<! USD_chargetotal>">
<input type="hidden" name="Accepturl" value="<! secure>?storeid=<! storeid>&c=receipt.htm&ud=<! ud>&key=<! key>">
<input type="hidden" name="Declineurl" value="<! secure>?storeid=<! storeid>&c=sorry.htm&ud=<! ud>">
<input type=hidden name="ci_companyname" value="<! YourCompany>">
<input type=hidden name="ci_memo" value="Invoice <! orderid>">
<input type=hidden name="emailto" value="<! Ecom_BillTo_Online_Email>">
<input type=hidden name="emailfrom" value="<! YourMail>">
<input type=hidden name="emailsubject" value="Payment Processing Receipt for <! YourCompany> Invoice <! orderid>">
<input type=submit name="submitform" value=" Place Order ">
</form>