Custom parameters

You can use merchant-defined, custom parameters, such as the MC or CM parameters, to add content to the payment pages and the Confirmation emails.

You need to supply these parameters, with values, in the order details submission.

Alternatively, you can gather the values from the shopper via form elements within the paymentTopFields.html, paymentMiddleFields.html and paymentBottomFields.html parts of the Payment Page. For more details, please refer toStructure of the Payment Page.

Note: You can also use the Payment Page Editor to add custom parameters to Shopper Confirmation emails. For details, please refer toShopper confirmation email.

For more information on using custom parameters, please refer toCustom Parameters.

Add a tag to a Payment Service page

To include your own merchant-defined, custom parameter in a Payment Service page:

  • Download the relevant Payment Service HTML file,

  • Open the file with a text editor and add the tag at an appropriate place in the file. For example, use the tag:

Copied!
<WPDISPLAY ITEM="MC_myText">

Where MC_myText is the name of your own merchant-defined parameter. For details of including our standard parameters, please refer toDynamic Information Parameters.

  • Save the file and upload it to your Test environment,

  • Include the parameter MC_myText and its value in the order details submission, for example:

Copied!
<input type=hidden name="MC_myText" value="Thank you for taking advantage of our special offer.">

You can also gather the value from the shopper via a form element within the paymentTopFields.html, paymentMiddleFields.html or paymentBottomFields.html parts of the Payment page.

Your text message appears in the Payment Service page when it is displayed.

Note: You can apply the same procedure to the Confirmation emails - make the changes to the relevant email messages_*.property file for your language.

Example resultY.html file

The following example of the resultY.html file returns a response to a shopper who has just paid for their order - in this case, a software download.

Note: The example depends upon the custom parameters CM_download_URL and MC_shipping_address and values being included in the order details submission.

Copied!
<html>  
<head>  
<title>Thank you for your payment</title>  
</head>  
<WPDISPLAY FILE=header.html DEFAULT="<body bgcolor=#ffffff>">  
<h1>My Company Ltd.</h1>  CM_download_URL
<WPDISPLAY ITEM=name>, thank you for your payment of  
<WPDISPLAY ITEM=amountString> for  
<WPDISPLAY ITEM=desc>. Please go to <WPDISPLAY ITEM=CM_download_URL> to download your software.  
Your magazine will be sent to <WPDISPLAY ITEM=MC_shipping_address>  

<WPDISPLAY ITEM=banner>  
<WPDISPLAY FILE=footer.html DEFAULT="</body>">  
</html>

This returns the response:

Copied!
=== header.html content ===  

My Company Ltd.  

<name>, thank you for your payment of <amountString> for <desc>. Please go to <CM_download_URL> to download your software. Your magazine will be sent to <MC_shipping_address>  

=== then the banner and footer.html content ===