Setting-up Quickly

Integration is very straightforward - when you can successfully send us details of an order and get an email response from us, you have integrated your website.

The steps below describe how to set-up an integration using an example HTML form, shown below, which can be used as a template in your own web pages. The steps provide the information you need to get your website integrated quickly and easily.

1. You need to add the example HTML form to the website page that advertises the product you wish to sell.
   
   The form holds the details of the order and it sends this information to us, using its POST method.

2. The HTML code for the form is provided below, simply copy it and paste it into your page, then update the parameter values and elements to suit the product details in your website page.
   
   Please only update the parameter values, not the parameters themselves. If you decide to rewrite the parameters, take care with spelling - they must be exactly as shown below - and note that they are case-sensitive: INSTID is not the same as instId.

3. The HTML example code will add a 'Buy This' button to the page.
   
   When you view the page in your browser, select the button and you will be taken to our secure server, you can then follow the progress of the transaction through the payment pages.

4. The HTML example is already set-up for the Test Environment, so you can try it out without worrying about transferring real money.

5. We will send you email notifications of each transaction automatically, including Test Environment transactions.

Your site is integrated if you can successfully get to the payment pages and you can get an email about the test purchase.

A Basic Order Details Form

This basic order details form has a simple structure. It is simply an HTML submission form with a small number of <input> tags containing parameters. The parameters included in this example are mandatory and must be included in the form.

<!-- The first line of code creates a form, which has the POST method and its action is to send the form to us. You do not need to set-up a special connection to us before using it - your Internet connection is all you need to communicate with us.-->

<form action="https://select.worldpay.com/wcc/purchase" method=POST>

<!-- This next line contains a mandatory parameter. Put your Installation ID inside the quotes after value= -->
<input type=hidden name="instId" value="Your installation ID ">

<!-- Another mandatory parameter. Put your own reference identifier for the item purchased inside the quotes after value= -->
<input type=hidden name="cartId" value="Your ID for the product ">

<!-- Another mandatory parameter. Put the total cost of the item inside the quotes after value= -->
<input type=hidden name="amount" value="The cost of the product ">

<!-- Another mandatory parameter. Put the code for the purchase currency inside the quotes after value= -->
<input type=hidden name="currency" value="currency code e.g. GBP, USD ">

<!-- This creates the button. When it is selected in the browser, the form submits the purchase details to us. -->
<input type=submit value=" Buy This ">

</form>

A Test Version of the Order Details Form

This version of the basic order details form also has a simple structure. It uses the URL for our test environment and includes the testMode parameter.

<!-- The first line of code specifies the URL for our test environment.-->

<form action="https://select-test.worldpay.com/wcc/purchase" method=POST>

<!-- This next line contains the testMode parameter - it specifies that the submission is a test submission -->
<input type=hidden name="testMode" value="100">

<!-- This next line contains a mandatory parameter. Put your Installation ID inside the quotes after value= -->
<input type=hidden name="instId" value="Your installation ID ">

<!-- Another mandatory parameter. Put your own reference identifier for the item purchased inside the quotes after value= -->
<input type=hidden name="cartId" value="Your ID for the product ">

<!-- Another mandatory parameter. Put the total cost of the item inside the quotes after value= -->
<input type=hidden name="amount" value="The cost of the product ">

<!-- Another mandatory parameter. Put the code for the purchase currency inside the quotes after value= -->
<input type=hidden name="currency" value="currency code e.g. GBP, USD ">

<!-- This creates the button. When it is selected in the browser, the form submits the purchase details to us. -->
<input type=submit value=" Buy This ">

</form>