Passing on shopper contact details

If you know a shopper's address or delivery details you can use them to populate fields in the Payment Page, and thus avoid making the shopper re-enter their address/delivery details when the Payment Page is displayed: the details will be shown when the Payment Page is displayed.

The shopper then only needs to enter their card details and select the Make Payment button: we will pass their address details to the relevant financial institution to enable authorisation of the payment.

To cause our payment service to display address details in our Payment Page, you must include the shopper's details in the order details submission, as shown in the example below.

If you want to make use of this technique, please ensure that the payment method selected by a shopper is suited to their details, otherwise their payment may be rejected. For more information please refer to Bypassing the Payment Selection Page.

Example - passing a shopper's address details

To pass the following address and contact details:

Address 1: 11 Shopper Street;
Address 2: Shopper Suburb;
Address 3:;
Town: Shopper City
Region: Shopper County;
Country: United Kingdom;
Postcode: shopper postcode;
Tel: 0123456789;
email: shopper@emailadress.com;

You will need to include the details as shown below in the fragment of an order details submission:

<input type="hidden" name="address1" value="11 Shopper Street">
<input type="hidden" name="address2" value="Shopper Suburb">
<input type="hidden" name="address3" value="">
<input type="hidden" name="town" value="Shopper City">
<input type="hidden" name="region" value="Shopper County">
<input type="hidden" name="country" value="GB">
<input type="hidden" name="postcode" value="shopper postcode">
<input type="hidden" name="tel" value="0123456789">
<input type="hidden" name="email" value="shopper@emailaddress.com">

The Worldpay payment service will then automatically use these address details to complete the billing address fields within the payment page, as shown in the following figure.

Shoppers can change any address details that you pass to our payment service, unless you pass the details to us as 'fixed data'.

When you use the fixContact parameter, the address information on the payment pages is locked, so that shoppers cannot change this information. Alternatively, you can use the hideContact parameter to hide the contact details of shoppers on the payment pages.

For more information, please refer to Example - fixed data contact details.

 

Figure: Example cardholder details as editable text (unfixed)