Articles in this section

See more

Query String Parameters

Avatar
Sarah Rosin
Updated

Overview 

Query String Parameters allow ClickBank Sellers to relay information to ClickBank when a customer follows your payment link. They also let sellers receive information from ClickBank when a customer purchases products and is directed to the Thank You page. 

 

You can use some query string parameters to relay information about a specific customer to the order form. When the customer follows a payment link with these parameters, the information is automatically populated on the order form.

 

Once the customer has reached the order form and made a purchase, information about the customer and the purchase is passed to the Thank You page via query string parameters. If you want, you can process these parameters to customize the Thank You page.

 

The following topics are covered in this article: 

 

ClickTip Lightning Bolt

 

Passing Information To The Order Form

Using parameters, you can pass information to the ClickBank order form along with the payment link. Some of this information is used to automatically populate some fields in the order form, while other information is used to enable other features.

 

Some parameters allow you to pre-populate customer information into the order form, which means that the customer does not have to re-enter it. This can help to improve your order form conversion 
To use this feature, you must first collect information from your customer via lead-gen forms or email campaigns. When a specific customer visits your site and clicks a payment link, you pass that customer's information with ClickBank’s payment link using query string parameters.

 

In addition to pre-populating the order form, parameters can be used to enable other features. The query string parameters must be added to the standard payment link format. For more information about formatting Payment Links, see the Creating a Payment Link article.

 

 

ClickTip Lightning Bolt

 

Parameters

The ClickBank payment link can accept the following query string parameters:

 

Parameters Processed By the Order Form

If you pass the following parameters, they are used to populate the corresponding fields on the order form:

  • name – The customer's full name.
  • email – The customer's email address.
  • st_addr1- Populates the Street Address field for physical product orders.
  • st_addr2 - Populates the "Apt / Suite / Other" field for physical product orders. 
  • country – The two-letter ISO code for the customer's country. For a list of countries and their codes, click here.
  • zipcode – The zip code or postal code for the customer's location.
  • st_city – The customer's city.
  • quantity – The quantity of the product. See the Editable Quantity on the Order Form article for more information.
  • coupon – A coupon code to apply to the order. See the Coupons article for more information.

In addition, the following parameter updates the order form settings:

  • locale – The language to use for the order form itself. The valid values are:
    • DE – German
    • EN – English
    • ES – Spanish
    • FR – French
    • IT – Italian
    • PT – Portuguese
    •  

Parameters Used By Other Features

The following parameters do not populate fields on the order form, but are used by other features.

Seller Variables

If you want, you can create your own variables to use for tracking purposes. These variables are not processed by the order form, but they are carried forward throughout the purchasing process. Seller variables use the same general format as our variables, and can use up to 128 bytes. 

 

ClickTip Lightning Bolt

 

Format & Examples 

The format for including parameters is:

https://VENDORNICKNAME.pay.clickbank.net/?cbitems=ITEM&name=Firstname%20Lastname&email=Y@example.com&country=EX&zipcode=ZZZZZ

 

Name and Email

In your sales process you might collect the name and email of the customer using a lead generation form. Let’s assume that John gives you his name and email address:

john@example.com

You can configure your Pitch Page to include this information in the ClickBank payment link for the correct customer:

https://VENDORNICKNAME.pay.clickbank.net/?cbitems=ITEM&name=John&email=john@example.com

When John clicks on the Buy Now button, the ClickBank order form will be displayed with John's name and email address already filled in.

 

Country

The customer's country is another example. You can ask your customer to select their country of origin on your Pitch Page as part of the sale process. Once you collect this information, you can then pass it to the ClickBank order form via the payment link. As an example, if your customer selects Germany (DE), then the payment link would be:

https://VENDORNICKNAME.pay.clickbank.net/?cbitems=ITEM&country=DE

 

ClickTip Lightning Bolt

 

Reading Information From The Order Form

When a customer purchases a product, ClickBank passes several parameters from the order form to the Thank You Page. The parameters are listed below. You can use this data to personalize the messaging on your Thank You Page. For example, you could say "Welcome, [Customer's Name]." Personalizing data on the Thank You Page can enhance customer satisfaction.

 

You can encrypt the parameters passed to some order forms if you want to avoid including personally identifiable information (PII) in the URL.
Related: Encrypting Passed Parameters

 

The following query string parameters are passed:

  • item – The ClickBank item number.
  • cbreceipt – The ClickBank receipt number.
  • time – The epoch time of the order.
  • cbpop – The ClickBank proof of purchase. See the Protecting Your Product article for more information about using this parameter.
  • cname – The customer's name.
  • cemail – The customer's e-mail.
  • ccountry – The customer's country.
  • czip – The customer's zip code or postal code.
  • cbaffi – The Affiliate nickname.
  • Seller variables – Any seller variables that you have configured, of up to 128 bytes.

 

ClickTip Lightning Bolt

 

Additional Resources & Related Articles  

Related articles