Plan your order submission | Include an installation ID

Include an installation ID

You must include an installation ID in every order you submit to us. installationId is an attribute of the <order> element.

Customisations associated with an installation ID

An installation ID identifies a set of customisations that you make to the Hosted Payment Pages.

For a given installation ID, you can:

To get an installation ID, contact your Relationship Manager or Worldpay Corporate Support.

Using more than one installation ID

You may want to use more than one installation ID. For example, each installation ID could represent a distinctive customisation for:

  • Different territories
  • National holidays

Sample XML order code with the installationId attribute

The sample XML order code below shows the installationId attribute of the <order> element.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE paymentService PUBLIC "-//WorldPay/DTD WorldPay PaymentService v1//EN" "http://dtd.worldpay.com/paymentService_v1.dtd"> <paymentService version="1.4" merchantCode="MYMERCHANT"> <submit> <order orderCode="ordercode123456" installationId="1234567"> <description>Deluxe flower bouquet from MYMERCHANT Webshop</description> <amount value="3600" currencyCode="EUR" exponent="2" debitCreditIndicator="credit" /> <orderContent /> <paymentMethodMask> <include code="ALL" /> </paymentMethodMask> <shopper> <shopperEmailAddress>jshopper@myprovider.int</shopperEmailAddress> </shopper> <shippingAddress> <address> <firstName>John</firstName> <lastName>Shopper</lastName> <address1>Shopperstreet</address1> <address2>Shopperaddress2</address2> <address3>Shopperaddress3</address3> <postalCode>1234</postalCode> <city>Shoppercity</city> <state>Shopperregion</state> <countryCode>NL</countryCode> <telephoneNumber>0123456789</telephoneNumber> </address> </shippingAddress> </order> </submit> </paymentService>

Sample XML order containing an installationId