Adding your own payment system

The electronic payment system normally consists of two new files. One file interfaces to the gateway.

The second file handles the status return back from the electronic gateway. There are no other changes to VP-ASP code.

In addition to the two files mentioned above, the configuration file shop$config.asp is updated to point to the replacement shopcheckout.asp    

Examples of Electronic Payment System

If you requested the electronic payment add-on for Verisign, we would send you two to four new files: In this example, Verisign has three files. A read me file comes with these files. Follow the simple instructions.

Verisignshopcheckout.asp

VerisignResult.asp

Versigngateway.asp

You will also need to update your merchant identifier supplied by the electronic gateway system. This is done by editing verisigngateway.asp     

Multiple Payment Methods

Multiple different payment methods can be used at the same time. If you are using a gateway you may wish to turn off the standard VP-ASP credit card and non credit card payment forms. This is done by setting the following in Shop configuration.

Xallowcreditcards	No turns off standard VP-ASP card form
Xallowotherpayments	No turns off other payment types

    

Turning Off VP-ASP Credit Card Collection

All the gateway interfaces allow you to also collect credit card details in case your gateway stops functioning temporarily. You can turn this facility off by setting:

xallowcreditcards	No turns off VP-ASP credit card form on the same page as the gateway form
xallowotherpayments	No, turns off other payment options

    

Bank or Electronic Payments Systems

VP-ASP supplies add-ons for electronic payment systems. In addition our general interface allows you to configure a new payment system in about 1-2 hours. These are free on request add-ons to VP-ASP customers but they do not undergo the same testing procedures and may be supplied on an as-is basis. There are limits to the number og gateways supplied per license. Normally this is three.

VP-ASP does not require an electronic gateway. By default it stores payment details in the database and allows you to view those payment using the display orders facility.

VP-ASP supports over 70 gateways. Please visit www.vpasp.com/virtprog/vpasp_epsystems.htm

Gateway

2Checkout

Anz Egate

Australia Post

AuthnetSSL

Authorizenet

Bank of America

Bluepay

Echonline

Clikpay

Directone

DPI

Ematters

Egateway

Eprocessing

ESEC

Eway

EZPN

Firstpay

Goemerchant

Goemerchant API

InternetSecure

Innovative

Iongate

ICP

Intellipay

InternetSecure

Itransact

Linkpoint

Merchant Trust

Mirapay

Moneris

NAB

NoChex

Paybycheck

Paygateway

PaymentTech

Payments International

Paypal

Payready

PlugnPay

Protx

Psigate

QuickCommerce

SecurePay

SecureTrading

Skipjack

Technocash

TPPRO

Verisign Payflow Link

Verisign Payflow Pro

USAEPAY

Viaklix

Worldpay

And many others     

Paypal

VP-ASP supports both normal Paypal and Paypal IPN (Instant Payment Notification). Paypal is a common method to pay for goods and services over the Internet. VP-ASP also supports Paypal multi currencies.

The basic PayPal gateway is included with all versions of VP-ASP. For PayPal IPN you will need to purchase one of our Power Pacs.

VP-ASP also supports Paypal and these other combinations

• Paypal with credit cards
• Paypal with non credit cards
• Paypal with any other electronic gateway

Paypal and VP-ASP 6.00

Our new release has included Paypal as a payment option by default. To integrate Paypal with your site, from within your site administration pages, go to Setup -> 6. Payments.

Locate the field xPaypal and set this to Yes.

Locate xPaypalEmail and insert your PayPal email address.

Next go to SetUp --> 4. Products 2

Locate xmysite and insert the path to your web site: http://www.yourvpaspwebsiteurl.com/

You will also need to modify the file paypalgateway.asp. Open this in any text editor, and change the lines at the top to suit your account: const

const CurrencyCode="USD" ' other values are EUR, CAD, GBP, JPY, USD

Paypal and VP-ASP (earlier versions)

To use Paypal, please download the Paypal Interface at www.vpasp.com/sales/epdownload.asp
VP-ASP allows the customer to purchase any number of goods at your shop. Paypal is just another payment method that you can elect to give to your customers.

VP-ASP also supports the new auto return feature of Paypal. Upon competition of the payment at Paypal, the customer is returns back to your site where VP-ASP updates the payment details (or checks them if using IPN) and then completes the order. If the customer cancels at Paypal, the customer can then an alternative payment method.

The URL for Paypal has changed. You may receive a warning message about an expired certificate when using the Paypal gateway code.

Depending on which Paypal interface you are using, edit paypalgateway.asp or a similar name (for VP-ASP 3.x name will be paypalshopcheckout.asp) and change

https://secure.paypal.com/cgi-bin/webscr
to
https://www.paypal.com/cgi-bin/webscr

Using Paypal IPN and other gateways

Using Paypal IPN with another gateway requires some minor changes to the instructions for installing Paypal. The steps are outline below.

1. First download the Paypal IPN interface from our downloads page.

2. Set up Paypal IPN by following the instructions that come with the zip file you receive. Just ignore the step that tells you to change the configuration option xcheckout.

3. Edit the current gateway file you are using. The example below is based on the default file shopcheckout.asp. If you are using Verisign, you would edit verisignshopcheckout.asp, etc.

4. Locate the following line -
!-- #include file="shopgateway.asp" -->

Add the following line below it -
!-- #include file="paypalipngateway.asp" -->

5. Locate the following line -

PerformGateway

Add the following line above it -

PayPalPerformGateway

Note: if you are using VP-ASP 6.00 or above, the line above may already exist and you will not need to make any changes.

6. Edit the file paypalipnresult.asp. Locate the following line -

backurl="paypalshopcheckout.asp"

Change to -

backurl="xxxxshopcheckout.asp"

Where xxxxshopcheckout.asp is the name of the file you edited in Step 2.

Troubleshooting Paypal

On some servers you may need to force Paypal to perform a POST back to the server your VPASP store is hosted on to successfully obtain the transaction information. If this is not done your transaction data may be blank on return from Paypal and you may also receive a Syntax error.

To implement this, you will need to make a minor adjustment to the paypalgateway.asp file.

Around line 40 locate:

<input type="hidden" name="cmd" value="_xclick" />

Immediately after this, insert a new row of code that reads:

<input type="hidden" name="rm" value="2">

This code forces Paypal to return its details as a form post rather than as a GET response and this should resolve any issues you have.