ClickBank Bonus Script

CBGraph's ClickBank Bonus Script is available for free download.

Download it right now!

How does it work?

The ClickBank Bonus Script helps you to automate the process of giving additional bonuses to customers who have purchased some ClickBank product(s) through your affiliate link.

Our ClickBank Bonus Script does all the work for you. Once it's installed and set up, your customers will receive their bonuses without any action from your part. Moreover, this script can check the status of a customer's purchase and block their access to your page with bonuses if the purchase has been refunded or canceled.

To install it (see detailed instructions below), you put a very simple HTML-form on a page with your review of some product (or whatever other page you want). This form asks a customer to enter their ClickBank Order Number of the completed purchase. When the form is submitted, our ClickBank Bonus Script connects to ClickBank Orders Service API to get information about this order in real time. If you are an affiliate of this purchase and it has not been refunded or canceled, the customer is redirected to your page with bonuses.

ClickBank Bonus Script

Requirements

The ClickBank Bonus Script will be installed to your hosting account. Your hosting must support PHP 5.2 (or above) with cURL library.

Installation

Step 1. Get a Developer and Clerk API Keys

First of all, to make real time calls to ClickBank Orders Services API you need to have a Developer and Clerk API keys. To obtain them, log in to your ClickBank account and go to the "Account Settings" -> "My Account" section.

ClickBank Settings: My Account

Scroll to the bottom of this page, there you'll see the "Clerk API Keys" and "Developer API Keys" empty blocks.

Let's create a new Clerk API Key. Click on the link "Edit" on the corresponding block:

ClickBank Settings: Clerk API Keys

Now, hit the "Create New Clerk User API Key" button:

ClickBank Settings: Create New Clerk User API Key

Check the "Orders/Tickets Read" checkbox, enter the description for this key (e.g. "Clerk Key 1") and click the "Save" button:

ClickBank Settings: Clerk API Key Creator

This will create your Clerk API Key:

ClickBank Settings: Clerk API key successfully saved

Now, go back to the "My Account" section, scroll to the bottom and click on the "Edit" link of the "Developer API Keys" block:

ClickBank Settings: Developer API Keys

Hit on the "Create New Developer Key" button:

ClickBank Settings: Developer Keys

Enter the description for this key and click the "Save" button:

ClickBank Settings: Developer API Key Creator

Now, you see your new Developer API Key:

ClickBank Settings: Developer key successfully created

You can find the created Clerk and Developer API Keys at the bottom of your "My Account" page:

ClickBank Settings: Clerk and Developer API Keys

Step 2. Copy the ClickBank Bonus Script to your hosting account.

For the simplicity, let's install the ClickBank Bonus Script to a folder 'bonus' in the root of your domain (e.g. http://www.yourdomain.com/bonus/). You can rename it later if you wish.

Copy the downloaded archive with the script to the root of your domain and unpack it. This will create a folder 'bonus' with 3 files:

  • 'processor.php' (the actual ClickBank Bonus Script)
  • 'error.tpl' (HTML-formatted template for error messages, see below)
  • and '.htaccess' (Apache's configuration file that prohibits listing of files in the folder).

Step 3. Set up the ClickBank Bonus Script

Now, you have to edit the 'processor.php' file with any simple text editor.

There are several definitions that you have to change. At the top of the file, below the copyright notice, find the lines like define('PARAM', 'VALUE'); and change their values.

CB_DEVELOPER_KEYThis must be your Developer API Key
CB_CLERK_KEYThis must be your Clerk API Key
SUCCESS_URLURL of your page with bonuses
ERROR_TEMPLATEA path to a local file with an HTML-formatted template for printing error messages (by default this is set to 'error.tpl' from the downloaded distribution; see below for details on this topic)
VENDOR_IDLeave this parameter empty if a customer may purchase any ClickBank product through your hoplink to get your bonuses. Or, write a comma-separated list of acceptable vendors
ERROR_ON_REFUNDThis can be 0 or 1. In case of 1, a customer won't be redirected to your page with bonuses if he/she has refunded their payment.
ERROR_ON_CANCELThis can be 0 or 1. In case of 1, a customer won't be redirected to your page with bonuses if he/she has canceled their subscription (for recurring billing products). If the initial payment for the subscription is quite high, you should set this to 0.
ERROR_MSG_*You can modify error messages here (e.g. you want to translate them into other language).

Step 4. Create a form on your Review page

At this stage, you can put a special form to your page with a review of some product (or to any other page you want). This form have only one input (ClickBank Order #), which will be posted to the ClickBank Bonus Script (processor.php).

<p><strong>To get your bonus, fill the form below:</strong></p> <form action="http://www.yourdomain.com/bonus/processor.php" method="post"> <table><tr> <td>ClickBank Order Number:</td> <td><input type="text" size="10" name="receipt" /></td> <td><input type="submit" value="Give Me My Bonus!" style="cursor:pointer" /></td> </tr></table> </form>

You have to change the action value to the appropriate URL-address of the 'processor.php'. HTML is a very simple language and you can modify this form in any way you wish. The most important thing is that there must be a text-input with name "receipt".

(Optional) Step 5. Error Messages Template

In case of some error (like you aren't an affiliate or the purchase, the purchase has been refunded, etc.), the ClickBank Bonus Script read the HTML-template file (see the ERROR_TEMPLATE definition), substitutes its variables and prints it to the customer.

This must be a local file (present on your hosting account).

There are 2 variables that you can use in your error template:

%PROVIDED_RECEIPT%Will be replaced with the ClickBank Order Number entered by the customer
%ERROR_MESSAGE%Will be replaced with a received error message.

You can find and use the example of this template inside/from the downloaded distribution.

Several bonus pages for different vendors

Here's the final thing you should know about our ClickBank Bonus Script. If you promote several products and for each of them you give different bonuses, then:

  1. Copy the 'processor.php' script as many times as many products you promote (e.g. copy it to 'processor2.php', 'processor_vendorx.php', etc.).
  2. Set up each copy of the ClickBank Bonus Script appropriately.
  3. On your review pages of different products set various values for the actions of the forms (e.g. action="http://www.yourdomain.com/processor2.php", and so on).

---

Should you have any questions about our ClickBank Bonus Script, you can contact our support.