## Notes for ASP Form Kit

[24-March-2005]

- Requirements
- Setting up the kit
- Testing the kit
- Integrating the kit
- Files
- Related Documentation

### Requirements

This implementation of VSP Form requires the following software:

- Windows NT4, 2000 or XP;
- IIS4, 5 or 6, or Apache running ASP
- Sufficient access rights to add a Directory to the web server running on your local machine; and
- 1Mb free hard disk space.

### Setting up the kit

- The folder asp-form-kit contains the files required to setup this kit.
- Copy these files into an appropriate folder on your web server.
- If required, setup a virtual directory under IIS which points to your installed folder.
- Open the functions.asp file and set the appropriate values for these variables:
  VendorName - should be set to your VSP Vendor Name as supplied by Protx
  EncryptionPassword - should be set to your Encryption Password as supplied by Protx
  MyServer - should be set to the fully qualified URL that identifies the virtual directory into which you installed this kit, then save the file before browsing to the correct URL. vspSite - the site to which you wish to send your transactions. You should start with the Simulator site.

### Testing the kit

- Navigate to default.asp, as installed in the previous step, using your web browser.
- Follow the on screen instructions to process a test transaction. If you are using the simulator site you will be taken through the full transaction process to debug your code.

### Integrating the kit

- This kit is intended as an example demonstrating how to process a simple VSP Form transaction through Protx.
- Use this example to integrate Protx with your existing purchase order system.
- You will need to modify this example to store and retrieve transactions using your database if required. Refer to the comments in the source code for further details.
- Please note that you should also test the VSP Admin area when you are using the test server.

### Files

- asp-form-readme.html: this file
- functions.asp: common configuration options.
- default.asp: entry point to test pages.
- submit1.asp: first order entry page.
- submit2.asp: second order entry page.
- submit3.asp: third and main order entry page. This is the page which posts the transaction to Protx.
- completed.asp: final successful completion page.
- notcompleted.asp: final failed completion page.

### RELATED DOCUMENTATION

- VSP Form Protocol and Integration Guideline
- VSP Admin User Manual
- VSP - How to Prevent Fraud