Payment Response

As far as you are concerned there are two possible outcomes for a payment - either it succeeds and the payment is made or else the shopper cancels the payment. The shopper can do the latter at any point, including when the bank declines a card transaction. This "card declined" status is never returned to you. The shopper always has the choice of trying another method of payment such as another card or else using a WorldAccount, if you are set up to take WorldAccount payments.

Returning the response to Yourself

Once a payment has been processed, either through to success or to cancellation, information about the processed transaction is made available to you through any of the following methods.

Statements and reports are always available to you and are documented in the WAS documentation. The other two are described further below.

Merchant Server Call-back

A request is made to a call-back URL that you provide, passing the parameters specified in the section WorldPay Parameters, Payment Response. The contact details that are passed back are those that were used for processing the payment. Note that the shopper may have changed any details that you sent over with the original payment transaction. The script or servlet listening on this URL can do whatever it pleases with the parameters passed to it. For example, you might log the transaction to your own database. You can choose whether the page returned to WorldPay in response to this request is used as the basis of the response sent to the shopper.

If you are using Select Pro then the information passed to your server is signed and encrypted so that you can be confident that it came from WorldPay and has not been tampered with. It must be handled by a Select Servlet, as described in the Select Pro documentation. If you accept a call-back and are not using Select Pro we cannot guarantee that all calls to your call-back URL originate at WorldPay. You will need to have additional checks to ensure that it relates to a valid payment.

You can set the call-back URL and specify that it be used for payment responses by using the page reached from the "Configuration Options" button for your installation on the WAS home page.

Email Receipt

An email receipt is sent to the address specified for the account that is receiving the payment. You can choose whether or not you wish to receive these email receipts via the account configuration options on WAS. You can supply a template for this email, using file upload and parameter substitution as described in Configuring your Installation. By default a standard email template will be used. [Note: this template is currently being defined].

Returning the response to the Shopper

Once a payment has been processed the shopper is returned a final response page and also an email, if the shopper provides an email address. Note that there is no guarantee that the shopper gets the email as we cannot guarantee the email address, but they will always get the response page.

Shopper's Response Page

You supply a page that is returned to the shopper once the payment has been processed. This page can either be the page returned in response to the merchant server call-back or a locally stored page that you upload to the WorldPay server. The locally stored page should be named "resultY.html" for the page to use for a successful payment and "resultC.html" for a cancelled payment. If you do not supply a page via the call-back or your own page on the WorldPay server then a standard page is used. [Note: this page is currently being defined]. You specify which behaviour you want via the installation configuration options on WAS.

Before being passed to the shopper this page is processed by WorldPay for parameter substitution. This enables you to embed details of this particular transaction in the page. This page can also contain any graphics you wish. These graphics must be uploaded to the WorldPay server even if the page is returned by the call-back to your server. Details of parameter substitution and use of graphics can be found in Configuring Your Installation. Here is a simple example of HTML for a resultY.html page: 

<head>
<title>Thank you for your payment</title>
</head>
<body>
<h1>My Company Ltd.</h1>
<WPDISPLAY ITEM=name>, thank you for your payment of 
<WPDISPLAY ITEM=amountString> for
<WPDISPLAY ITEM=desc>. Your goods will be shipped to
you within three working days.
</body>

In addition, WorldPay always inserts a standard "banner" containing certain information that WorldPay must convey to the shopper. The banner is inserted into your page either at the position of the tag <WPDISPLAY ITEM=banner> or else directly after the <BODY> tag if the special tag is missing.

The following is an example of the banner for a new WorldPay user:

Thank you for using WorldPAY
The WorldPAY Transaction ID for this purchase is 2111 and the merchant's reference is 100: If you need to contact WorldPAY or the merchant about this transaction, please quote both of these references.
As this is your first WorldPAY purchase we have allocated you a new username and password:
User name: wp5590
Password: HBjtZSpC
To change these to something more memorable, or to check your and other WorldPAY account transactions please visit the WorldPAY Administration area at:
ADMIN AREA
For security reasons, if you do not expect to be using your or other WorldPAY facilities again immediately, we would recommend that you logout now:
LOGOUT
Hint: next time you use WorldPAY you can enter your username and password to retrieve your contact details.

For an existing user the banner is as follows:

Thank you for using WorldPAY
The WorldPAY Transaction ID for this purchase is 2117 and the merchant's reference is 100: If you need to contact WorldPAY or the merchant about this transaction, please quote both of these references.
To check your and other WorldPAY account transactions please visit the WorldPAY Administration area at:
ADMIN AREA
For security reasons, if you do not expect to be using your or other WorldPAY facilities again immediately, we would recommend that you logout now:
LOGOUT

Shopper's Email Receipt

An email receipt is sent if the shopper supplies an email address. You can supply a template for this email, using file upload and parameter substitution as described in Configuring your Installation. By default a standard email template will be used. [Note: this template is currently being defined].
Back to contents page

$Revision: 1.11 $