Secure-eBook

Secure-eBook Documentation

You are here: start » product_thank_you_page
Table of Contents

Product's Thank You Page

The Thank You page is the page shown when a client successfully purchased your product.

Secure-eBook's default Thank You page gives the user his activation key or temporary download link and informs him on what he has purchased and how much he paid for it.

Before displaying a Thank You page, Secure-eBook also sends an eMail to your client with his activation key or temporary download link and instructions on how to use it.

You can specify your own Thank You page to be shown instead of Secure-eBook's.

This allows you to include more information, plug some of your other products, etc.

In order to show your own Thank You page, simply specify its link in your product's configuration page in the “Thank You Page” URL field.

Advanced Integration

Secure-eBook will send extra information to your thank you page using GET parameters - parameters passed through your Thank You page's URL.

Using these variables require knowledge of server-side scripts such as PHP, Perl or JSP. They can also be used using javascript (see the following section).

These parameters go as follow:

Parameter Name Description
code Your product's code
key Your client's activation key
link Your client's download link
invid The invoice ID corresponding to the invoice created by Secure-eBook
status The transaction's status. See following table
txnid The transaction ID sent by your payment processor
note Extra information returned by the payment processor (usually, the reason for the order's status)


Transaction Status Description
cancelled The transaction was cancelled by the user
completed The transaction was completed succesfully
denied The transaction has been denied by the processor
failed A configuration or communication error prevented the transaction from happening
pending The transaction has been completed, but it is furhter manual processing (with transactions such as eChecks)

Getting Parameters Through JavaScript

If you are comfortable using JavaScript, an interesting option is to get these parameters using JavaScript code in your HTML page.

A first bit of JavaScript code should be put in your Web Page, near the start of the <body> tag.

1) Look for the text <body> in your HTML page.
2) Insert the following code on the line following the line that contains the <body> code. 

<script type="text/javascript"><!--
var QUERY_PARAMS = new Array();
 
function parseParameters()
{
	var search = document.location.search;
 
	if (!search)
		return;
 
	search = search.substr(1);
	var params = search.split('&');
 
	for (var i=0; i < params.length; i++)
	{
		var param = params[i];
 
		var pair = param.split('=');
		if (pair.length == 2)
			QUERY_PARAMS[pair[0]] = unescape(pair[1]);
	}
}
parseParameters();
//--></script>

The previous code will look at your Web Page parameters and place them in easy to use variables for the rest of your Web Page.

After that, you can access any of the variables described in the Advanced Integration section above using the following code: NB: In the following code, you are expected to replace VARIABLE by the name of the variable you wish to display. 

<script type="text/javascript">document.write(QUERY_PARAMS['VARIABLE']);</script>

Here is an example of HTML + JavaScript code that displays a client's activation key: 

<script type="text/javascript"><!--
  if (QUERY_PARAMS['key']) {
    document.write("Your activation key is: " + QUERY_PARAMS['key']);
  }
//--></script>
<br/>