Enable shopper responses

Below we define how you can configure shopper responses (result pages).

Defaults

By default, when a transaction is complete we inform the shopper via these channels:

Information channelDescription
Result pageA result page is displayed to the shopper. You can decide to accept the default result pages or, alternatively, you can replace them by uploading your own versions, either generated by yourself solely (refer to sectionEnable shopper responses, or using thePayment Responsesfeature.
Confirmation emailA confirmation email shows you the transaction details that are sent to the shopper's email address that is supplied during the purchase. You can also add your own text to the confirmation email using thePayment Responsesfeature.


Note: This confirmation email is not a VAT receipt.

Shopper responses

Enable the service

  1. Log in to Business manager.

  2. Click SETUP.

  3. Next to the Select Junior installation, click the icon in the Integration Setup: TEST column.

  4. Check the box Enable the Shopper Response.

  5. Click Save Changes.

Create a shopper response

To create a shopper response, change your payment response server-side script so that it produces a valid HTML output. To display a different shopper response for a payment that is authorised or cancelled, check the transStatus returned in the payment message, and create a valid HTML output (including the banner WPDISPLAY ITEM tag) for each of the statuses.

Note: If your system requires a full redirect to your own Webpage, you can include a META refresh (with a short delay) in the output of your payment response script (shopper response).

Include the banner WPDISPLAY ITEM tag

The shopper response must include the WPDISPLAY ITEM tag: <WPDISPLAY ITEM=banner>.

After a shopper response is retrieved from your server, the <WPDISPLAY ITEM=banner> is used to present the mandatory transaction information to the shopper. Alternatively, you must present the Transaction ID and result of the transaction on any page that you are redirecting your customers to.

Display images

The HTML output generated by your payment response server-side script is presented to the shoppers' browser as if it had come from us. As such, any images that you wish to display is uploaded to your installation folder, and referred to within the HTML output generated as follows, where xxxxx is your installation ID:

Copied!
<img src="/i/xxxxx/imagename.gif">

You could also replace the installation ID with the WPDISPLAY item tag:as we replace this with the correct installation ID before the response is displayed to the shopper.

Copied!
<img src="/i/<wpdisplay item=instId>/imagename.gif">

This is helpful if you are running the same shopper response across a number of different installations.

Include your own resources files and variables

You may wish to include your own resource file to the shopper response, i.e. Cascading Style Sheet files (.css). We recommend that you upload these files to your installation folder and reference them in the HTML output as follows:

Copied!
<link rel="stylesheet" href="/i/<wpdisplay item=instId>/stylesheetname.css" type="text/css" />

To reference or link to any resource outside of your installations folder, the link included in the HTML output must be absolute, in other words the full URL must be used.

Note: If any resources used in the HTML output are taken from an http:// address, the shopper may see a warning message from their browser. This message states that there is a mixture of secure and insecure items being used on the page. This warning message may be of concern to shoppers who have entered their payment details on our payment service. Therefore, we recommend that you try to avoid referencing resources outside of your installation folder or that you reference the resource files from a secure server that has an https:// address.

To include additional payment parameters in the Shopper Response, add your own variables to the purchase token with either the C or MC prefix. Variables prefixed with M_ are not available for use in the shopper response. For more information, refer to Adding your own variables.

To ensure character encoding used, your Shopper Response is displayed correctly by the shopper's browser, you should include an appropriate Meta tag in the head of your HTML output.