Skip to main content

Upgrade links


Create upgrade links and offer them to your customers. 


All 2Checkout accounts. 


Configure upgrades for your products/subscription plans.

Create the upgrade link

To build upgrade links you need the following two elements:

  1. The main upgrade link

    The unique subscription identifier from the 2Checkout system: LICENSE=ABC1D2E345. The simplest upgrade link you can build is:

Query parameters

The following table summarizes the query parameters that you can insert into links to customize upgrades.

Parameters Required/Optional Type / Description
LICENSE Required

Specifies the subscription to be upgraded.

LANG Optional

ISO country code of the language used for the order processing interface and shopper emails.

Default value: EN.

CURRENCY Optional Preselects the billing currency to be used in the transaction.
SHOPURL Optional Custom URL used for "Back to shopping" link.
OPTIONS(ProductID) Optional

Preselects the pricing options for the subscription, using the pricing options codes (the IDs you set for each option individually). You need to append the unique product identifier generated by the 2Checkout platform after the OPTIONS parameter. 

Example: OPTIONS1234567=5usr,2year.

Required in conjunction with UPGRADEOPT.

Optional otherwise.

Product ID of the target product used in the upgrade process.
UPGRADEOPT Optional Product option code of the target product used in the upgrade process. Can only be used in conjunction with UPGRADEPROD.
DESIGN_TYPE Optional Use DESIGN_TYPE=1 to change the layout of the shopping cart template interface, positioning the payment methods selector in a more prominent position, above the billing details area.

Enables you to control which version of the shopping cart 2Checkout serves to shoppers.

Possible values:

  • CLASSIC - the desktop variant of the shopping cart (2Checkout serves the desktop version of the cart even to mobile device users.)
  • MOBILE - 2Checkout mobile cart (2Checkout serves the mobile version of the shopping cart, even to users of desktop browsers.)
REF Optional External order reference (string). Add a string identifier to every URL (less than 100 characters). 2Checkout saves the string at order-level, in addition to the system generated order reference. If there is a need for longer references, use a md5 hash. To access external reference info navigate to the order details page.
SRC Optional Identifies the source of a sale by assigning a unique URL identifier. For instance, if there are two buy links on your website, one in the product page and another one in the download page, you can track the source page by entering the following parameters:
  • SRC=prodpage for the product page
  • SRC=dlpage for the link on the download page
COUPON Optional

Promotion coupon code applied to the order. Use commas (,) to separate multiple values.

Example: [...]&COUPON=voucher1,voucher2[...] 
CARD Optional

Possible values:

  • 1 to display the payment form in the selected landing page. Shoppers get to place orders from the Review page.
  • 2 to display the payment form in the selected landing page, and shoppers to place orders immediately after entering their payment data, excluding the Review page.
ORDERSTYLE Optional Allows you to set the desired ordering interface template, overriding the default template assigned to the product group. Each template defined in the Interface Templates area of the Control Panel has a unique identifier associated which is visible in the browser address bar when previewing the shopping cart.

Requires 2Checkout activation before using.


Use AUTO_PREFILL=1 to set the ZIP code and country fields as mandatory. Address, City and State details are calculated automatically by the 2Checkout system. The address can be excluded completely. Using the AUTO_PREFILL=1 parameter without the feature being enabled for your account will result in shoppers following the classic purchase flow, where all billing address data is mandatory. 


Upgrade a specific subscription

To trigger the upgrade of a specific subscription, include the LICENSE parameter in the upgrade link, where 1A22223BC4 represents the 2Checkout Subscription Reference.

Domain use

  1. If your account is using the 2Checkout's domain, then your custom on-demand renewal links would look like this:
  2. Custom domains such as If your account is using a custom domain such as, then your custom on-demand renewal links would look like this: /order/upgrade.php?
  • Was this article helpful?